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