Skip to main content

​
1. Create an Account

1

Sign up

Visit app.colacloud.us/auth/register and sign up with email or Google.
2

Verify email

Check your inbox and verify your email address.
3

Generate an API key

Go to Dashboard > API Keys and click Create API Key. Copy your key — it won’t be shown again.

​
2. Make Your First Request

Search for bourbon labels: 
curl -H "X-API-Key: your_api_key" \
  "https://app.colacloud.us/api/v1/colas?q=bourbon&per_page=5"

​
3. Look Up a Product by Barcode

Find COLAs associated with a UPC/EAN barcode: 
curl -H "X-API-Key: your_api_key" \
  "https://app.colacloud.us/api/v1/barcode/012345678901"

​
4. Check Your Usage

curl -H "X-API-Key: your_api_key" \
  "https://app.colacloud.us/api/v1/usage"

​
Default Date Range

When no date filters are provided, the /colas endpoint returns results from the last 365 days. The response includes a defaults_applied field indicating when this default is active: 
{
  "defaults_applied": {
    "date_range": true,
    "date_from": "2025-03-01"
  }
}
Pass approval_date_from or approval_date_to to override this default and query the full historical dataset.

​
Next Steps

Authentication

API key usage, rate limits, and pagination

API Reference

Interactive API playground

SDKs & Tools

Python, JavaScript, CLI, and MCP server

Dataset Schema

Full schema with 100+ columns