---
title: "Get production reports"
method: GET
path: "/production-reports"
tags: ["Reference Data"]
---

# Get production reports

`GET /production-reports`

## Request

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

TTB statistical production reports — monthly and annual data on alcohol production,
removals, and inventories by commodity and statistical group.

This endpoint is free — it does not consume quota.

## Query parameters

- `commodity` string
- `year` integer
- `month` integer
- `report_type` string
- `statistical_group` string
- `page` integer
- `per_page` integer

## Response `200`

Successful response

- object
  - `data` ProductionReport[]
    - `commodity` string: Commodity name
    - `report_type` string: Type of report (e.g., monthly, annual)
    - `year` integer: Report year
    - `month_number` integer, nullable: Report month (1-12), null for annual reports
    - `report_date` string, date: Report date
    - `statistical_group` string: Statistical grouping
    - `statistical_category` string: Statistical category within the group
    - `statistical_detail` string: Specific statistical detail
    - `count_ims` integer, nullable: Count of items (where applicable)
    - `value` number, float, nullable: Reported value
    - `value_unit` string: Unit of the reported value
    - `is_redacted` boolean: Whether the value was redacted by the TTB
  - `meta` MetaPaginated: Response metadata with pagination
    - `total` integer: Total number of results
    - `page` integer: Current page number
    - `per_page` integer: Results per page
    - `has_more` boolean: Whether more results are available

## Other responses

- `401`: Missing or invalid API key or Bearer token
- `429`: Quota or burst limit exceeded

---

[API](https://skmtc.dev/colacloud/apis/cola-cloud-api.md) · [All operations](https://skmtc.dev/colacloud/apis/cola-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/colacloud/apis/cola-cloud-api/revisions/1cb00a02112c?raw)