Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.colacloud.us/llms.txt

Use this file to discover all available pages before exploring further.

COLA Cloud publishes several TTB reference datasets as free, open data. These are available as both CSV downloads and API endpoints. API access requires an API key but does not count against your monthly quota.

​
Available Datasets

DatasetDescriptionRowsUpdatedCSVAPI
Processing TimesCOLA label application turnaround times by commodity~80DailyDownloadGET /processing-times
Formula Processing TimesFormula application turnaround times by type and commodity~100DailyDownloadGET /processing-times/formula
Registration Processing TimesOriginal permit application turnaround times~200PeriodicDownloadGET /processing-times/registration
Production ReportsMonthly and annual alcohol production statistics~15,000Full refreshDownloadGET /production-reports
Viticultural Areas (AVAs)Federally designated wine grape-growing regions~340Full refreshDownloadGET /avas
PermitteesLicensed alcohol producers, importers, and wholesalers~30,000Full refreshDownloadGET /permittees

​
CSV Downloads

All CSV files are hosted on CloudFront and available without authentication. Download directly or use them in your data pipelines: 
curl -O https://dyuie4zgfxmt6.cloudfront.net/open-data/ttb_processing_times.csv
curl -O https://dyuie4zgfxmt6.cloudfront.net/open-data/ttb_production_reports.csv
curl -O https://dyuie4zgfxmt6.cloudfront.net/open-data/ttb_viticultural_areas.csv

​
API Access

All reference data endpoints require an X-API-Key header but are free to call — they do not consume detail view or list record quota. They are subject to burst rate limits. 
curl -H "X-API-Key: your_api_key" https://app.colacloud.us/api/v1/processing-times
curl -H "X-API-Key: your_api_key" https://app.colacloud.us/api/v1/avas?state=CA
curl -H "X-API-Key: your_api_key" https://app.colacloud.us/api/v1/production-reports?year=2024&commodity=wine

​
Data Sources

All datasets are sourced from public TTB data and refreshed regularly:

​
License

These datasets are derived from US federal government public data and are provided as-is. The underlying TTB data is in the public domain. COLA Cloud’s value-add (cleaning, structuring, enrichment) is offered freely for these reference datasets.

​
COLA Registry Access

Looking for COLA label records? The self-service REST API covers the 2015-forward application database. For the full historical dataset — 2.9M+ product records back to 2005, label images, barcodes, and LLM enrichments — ask about a bulk data license with delivery via Snowflake data share or file export. You can also preview the shape of the data with the free sample pack. Contact us to learn more.