COLAs

Search COLAs

Search and filter Certificates of Label Approval with full-text search and various filters. Results are ordered by approval date (descending).

When no explicit date filters (approval_date_from, approval_date_to) are provided, results default to the last 365 days, except for exact 14-digit TTB-ID searches and non-approved status filters (expired, surrendered, or revoked), which search all available history. Explicit date filters always take precedence. The defaults_applied field in the response indicates when the recent-date default is active.

get/colas

Request

  • Base URL: https://app.colacloud.us/api/v1
  • URL: https://app.colacloud.us/api/v1/colas
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

qstring

Text search query. Searches TTB ID, brand, product, class, permit number, and applicant/company name and applicant trade name. Exact 14-digit TTB IDs take precedence; other barcode-shaped queries are treated as barcode lookups first.

product_typestring[]

Filter by one or more TTB product types. Comma-separated values are accepted.

categorystring[]

Filter by one or more consumer-facing taxonomy roots. Comma-separated values are accepted. This trade-oriented classification is independent of the TTB product_type field.

derived_subcategorystring

Filter by a canonical taxonomy path prefix, such as "Beer > Ale" or "Wine > Red Wine". Paths with a published transition alias are accepted and resolved to their current canonical path.

originstring

Filter by origin/country (e.g., "american", "french", "italian")

domestic_or_imported'domestic' | 'imported'

Filter by domestic or imported origin.

status'approved' | 'expired' | 'surrendered' | 'revoked'

Filter by current TTB application status. Non-approved statuses search all available history when no explicit approval-date filter is supplied.

brand_namestring

Filter by brand name (partial match, case-insensitive)

permit_numberstring

Filter by permit number (exact match, e.g. "CA-I-12345")

barcode_valuestring

Filter by the COLA record's main barcode value (exact match). Numeric values may include spaces or hyphens.

approval_date_fromstring date

Filter by minimum approval date (YYYY-MM-DD)

approval_date_tostring date

Filter by maximum approval date (YYYY-MM-DD)

abv_minnumber float

Filter by minimum alcohol by volume (ABV) percentage

abv_maxnumber float

Filter by maximum alcohol by volume (ABV) percentage

volume_unit'beer barrels' | 'fluid ounces' | 'gallons' | 'liters' | 'milliliters' | 'pints' | 'quarts'

Filter by package volume unit. Required when volume_min or volume_max is provided.

volume_minnumber float

Filter by minimum package volume in the selected volume_unit.

volume_maxnumber float

Filter by maximum package volume in the selected volume_unit.

container_typestring[]

Filter by one or more derived container types. Comma-separated values are accepted.

product_stylestring[]

Filter by asserted finished-beverage style in upstream product facts (for example spirit_cocktail or ipa). Comma-separated values are accepted. Only records evaluated for this field can match; historical coverage is expanding.

product_basestring[]

Filter by asserted fermentable base in upstream product facts (for example agave or grape). Comma-separated values are accepted. This is independent of the finished-beverage style; records without an asserted base do not match.

pageinteger

Page number (max 100)

per_pageinteger

Results per page (max 100)

Response

Successful response

Changes

No recorded changes to this operation across all 1 revision of this API.