---
title: "Get permittee details"
method: GET
path: "/permittees/{permit_number}"
tags: ["Permittees"]
---

# Get permittee details

`GET /permittees/{permit_number}`

## Request

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

Retrieve detailed information for a single permittee by permit number.
Includes the 10 most recent COLAs for this permit holder.
Counts as one detail view against your quota.

## Path parameters

- `permit_number` string, required

## Response `200`

Successful response

- object
  - `data` PermitteeDetail
    - `permit_number` string: TTB permit number
    - `company_name` string
    - `company_state` string: Two-letter state code
    - `company_zip_code` string
    - `permittee_type` string: Type of permit (e.g., "Bonded Winery", "Importer")
    - `is_active` boolean
    - `active_reason` string, nullable
    - `colas` integer: Total number of COLAs for this permittee.
    - `colas_approved` integer: Number of approved COLAs.
    - `last_cola_application_date` string, date, nullable: Date of most recent COLA application.
    - `recent_colas` ColaSummary[]: 10 most recent COLAs for this permittee
      - `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

## 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)