Skip to main content
GET
/
colas
Search COLAs
curl --request GET \
  --url https://app.colacloud.us/api/v1/colas \
  --header 'X-API-Key: <api-key>'
{ "data": [ { "ttb_id": "24001234567", "brand_name": "Sample Winery", "product_name": "Reserve Cabernet Sauvignon", "product_type": "wine", "class_name": "table red wine", "origin_name": "american", "permit_number": "CA-I-12345", "approval_date": "2024-01-20", "image_count": 2, "has_barcode": true } ], "pagination": { "mode": "offset", "page": 1, "per_page": 20, "total": null, "pages": null, "has_more": true } }

Authorizations

​
X-API-Key
string
header
required

API key passed in the X-API-Key header

Query Parameters

​
q
string

Full-text search query (searches brand name, product name, and other text fields)

​
product_type
enum<string>

Filter by product type

Available options:
wine,
malt beverage,
distilled spirits
​
origin
string

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

​
brand_name
string

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

​
permit_number
string

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

​
approval_date_from
string<date>

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

​
approval_date_to
string<date>

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

​
abv_min
number<float>

Filter by minimum alcohol by volume (ABV) percentage

​
abv_max
number<float>

Filter by maximum alcohol by volume (ABV) percentage

​
page
integer
default:1

Page number

Required range: x >= 1
​
per_page
integer
default:20

Results per page (max 100)

Required range: 1 <= x <= 100

Response

Successful response

​
data
object[]
​
pagination
object