---
title: "Get COLA details"
method: GET
path: "/colas/{ttb_id}"
tags: ["COLAs"]
---

# Get COLA details

`GET /colas/{ttb_id}`

## Request

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

Retrieve detailed information for a single COLA by its TTB ID.
Includes all label images with short-lived CloudFront URLs and barcode data.
Counts as one detail view against your quota.

## Path parameters

- `ttb_id` string, required

## Response `200`

Successful response

- object
  - `data` ColaDetail: Summary view of a COLA (used in list responses)
    - `ttb_id` string: Unique TTB identifier
    - `brand_name` string: Brand name on the label
    - `product_name` string: Product name
    - `product_type` 'wine' | 'malt beverage' | 'distilled spirits': Type of alcohol product
    - `class_name` string: TTB classification (e.g., "table red wine")
    - `origin_name` string: Country/region of origin
    - `applicant_trade_name` string, nullable: Applicant DBA/trade name explicitly marked "Used on label" in the captured COLA form, preserving source spelling. Separate from legal company and product brand. Null means no unambiguous marked value was captured, not that the applicant has no trade name.
    - `permit_number` string: Permit number of the producer/importer
    - `application_status` 'approved' | 'expired' | 'surrendered' | 'revoked', nullable: Current application status published by TTB
    - `approval_date` string, date, nullable
    - `image_count` integer: Number of label images
    - `has_barcode` boolean: Whether any barcode was extracted from label images
    - `application_type` string, nullable: TTB application type
    - `application_date` string, date, nullable
    - `expiration_date` string, date, nullable
    - `class_id` string: TTB class ID code
    - `origin_id` string: TTB origin ID code
    - `latest_update_date` string, date, nullable
    - `is_distinctive_container` boolean
    - `for_distinctive_capacity` string, nullable: Volume of the distinctive container as free text
    - `is_resubmission` boolean
    - `for_resubmission_ttb_id` string, nullable
    - `for_exemption_state` string, nullable
    - `address_recipient` string, nullable: Label recipient name
    - `address_zip_code` string, nullable
    - `address_state` string, nullable
    - `grape_varietals` string[], nullable: Grape varieties (wine only)
    - `wine_vintage_year` integer, nullable: Vintage year (wine only)
    - `wine_appellation` string, nullable: Wine appellation (wine only)
    - `llm_container_type` string, nullable: LLM-identified container type (bottle, can, etc.)
    - `llm_product_description` string, nullable: LLM-generated product description
    - `llm_brand_established_year` integer, nullable
    - `llm_category` string, nullable: Display name of the deepest published taxonomy node for this record. This can be a non-leaf category when a more specific classification is not defensible.
    - `llm_category_path` string, nullable: Canonical consumer-facing taxonomy path rooted at Beer, Wine, or Liquor. This classification is independent of the TTB product_type field.
    - `llm_tasting_note_flavors` string[], nullable: LLM-extracted tasting notes
    - `llm_artwork_credit` string, nullable
    - `llm_wine_designation` string, nullable
    - `llm_beer_ibu` string, nullable: IBU rating (beer only)
    - `llm_beer_hops_varieties` string[], nullable
    - `llm_liquor_aged_years` integer, nullable
    - `llm_liquor_finishing_process` string, nullable
    - `llm_liquor_grains` string[], nullable
    - `barcode_type` string, nullable: Primary barcode type (upca, ean13, etc.)
    - `barcode_value` string, nullable: Primary barcode value
    - `qrcode_url` string, nullable: URL encoded in QR code (if present)
    - `has_front_image` boolean
    - `has_back_image` boolean
    - `has_neck_image` boolean
    - `has_strip_image` boolean
    - `images` ColaImage[]
      - `ttb_image_id` string: Unique image identifier
      - `image_index` integer: Image index within the COLA
      - `container_position` 'front' | 'back' | 'neck' | 'strip' | 'other': Position on the container
      - `extension_type` string: File extension (jpg, png, etc.)
      - `width_pixels` integer
      - `height_pixels` integer
      - `width_inches` number, float, nullable
      - `height_inches` number, float, nullable
      - `file_size_mb` number, float
      - `barcode_count` integer
      - `qrcode_count` integer
      - `image_url` string, uri: Short-lived CloudFront URL for the image
    - `barcodes` Barcode[]
      - `barcode_type` string: Barcode format (upca, ean13, qr, etc.)
      - `barcode_value` string: Decoded barcode value
      - `ttb_image_id` string: Image this barcode was found in
      - `width_pixels` integer
      - `height_pixels` integer
      - `orientation` 'horizontal' | 'vertical' | 'square'
      - `relative_image_position` string: Position in the image (e.g., "bottom center")

## Other responses

- `401`: Missing or invalid API key or Bearer token
- `404`: Resource not found
- `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)