# TTB Permittees Search — GovParse

> TTB Permittees Search — GovParse is a paid API for AI agents from api.govparse.io, paid per call via x402, $1.25/call, status unknown (last checked 2026-09-14).

Search the federal TTB List of Permittees to find distilleries, wineries, alcohol importers, and wholesalers holding a basic permit, filterable by owner, permit type, location, and new-permit status.

## Facts

- Endpoint: GET https://api.govparse.io/v1/ttb/permittees/search
- Price: $1.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ttb-permittees-search-govparse-8797748b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8VDGjKVw5yis3uoVXaArK

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ttb-permittees-search-govparse-8797748b
```

Example prompt: Can you pull all TTB-permitted distilled spirits plants in Kentucky — specifically in Louisville, ZIP 40202 — and tell me who the permit holders are, their operating names, and whether any permits were issued in the last 7 days?

## When to prefer this

Use this endpoint when you need to verify or discover which companies hold a federal TTB basic permit for alcohol production, importation, or wholesale distribution in a specific market. It is the authoritative source for TTB permit data and supports location-based filtering (state, city, county, ZIP), permit-type filtering, and new-permit monitoring. Prefer this over state-level liquor authority APIs when federal-level permit verification is required, or when building sales prospecting, compliance monitoring, or market entry intelligence workflows for the beverage alcohol industry.

## Known failure modes

- No results returned if search terms don't match TTB database records — try broader or partial strings
- Invalid permit_type value (only S, W, I, P accepted) returns validation error
- State must be a valid two-letter code; invalid codes return no results
- limit cap is 100 rows; pagination via offset required for larger result sets
- new=true returns only permits issued within the last 7 days; older new permits won't appear
- entity_id pivot only works if the owner has been resolved in GovParse's entity graph

## How this service works

Which distilleries, wineries, alcohol importers, and wholesalers hold a federal TTB basic permit in a market? Search the TTB List of Permittees by owner, operating/DBA name, permit number, permit_type (S/W/I/P), industry, state, city, county, zip, entity_id, or new-permit-only (new=true, a new-business trigger). Returns the permittee, operating name, address, industry type, and entity-resolved owner. Excludes brewers/tobacco (IRC 6103). TTB public-domain records.

## Output

Returns a list of matching TTB permittees, each with: permit holder (owner) name, operating/DBA name, permit number, permit type (S/W/I/P), industry type (e.g. Distilled Spirits Plant, Wine Producer, Importer, Wholesaler), full premise address (city, state, county, ZIP), and an entity-resolved owner UUID for pivoting to business360 data. Excludes breweries and tobacco (IRC 6103).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [],
   "properties": {
    "new": {
     "type": "string",
     "examples": [
      "true"
     ],
     "description": "true = newly-issued permits only (< 7 days) — a new-business trigger."
    },
    "zip": {
     "type": "string",
     "examples": [
      "40202"
     ],
     "description": "Premise ZIP code."
    },
    "city": {
     "type": "string",
     "examples": [
      "Louisville"
     ],
     "description": "Premise city fragment."
    },
    "sort": {
     "type": "string",
     "examples": [
      "owner:asc"
     ],
     "description": "permit_number | owner | city :asc|:desc. Default permit_number:asc."
    },
    "limit": {
     "type": "integer",
     "examples": [
      25
     ],
     "description": "Max rows (default 25, cap 100)."
    },
    "owner": {
     "type": "string",
     "examples": [
      "Southern Glazer's"
     ],
     "description": "Permit-holder (owner) name — suffix/punctuation-insensitive."
    },
    "state": {
     "type": "string",
     "examples": [
      "KY"
     ],
     "description": "Premise state code(s), CSV."
    },
    "county": {
     "type": "string",
     "examples": [
      "Jefferson"
     ],
     "description": "Premise county fragment."
    },
    "offset": {
     "type": "integer",
     "examples": [
      0
     ],
     "description": "Rows to skip."
    },
    "industry": {
     "type": "string",
     "examples": [
      "Distilled Spirits Plant"
     ],
     "description": "Industry type (Distilled Spirits Plant | Wine Producer | Importer (Alcohol) | Wholesaler (Alcohol)), CSV."
    },
    "entity_id": {
     "type": "string",
     "examples": [
      "b7f3e2d1-4a5c-4e6f-8a9b-0c1d2e3f4a5b"
     ],
     "description": "Resolved owner entity UUID (pivots to business360)."
    },
    "permit_type": {
     "type": "string",
     "examples": [
      "S"
     ],
     "description": "S = distilled spirits, W = wine, I = importer, P = wholesaler."
    },
    "permit_number": {
     "type": "string",
     "examples": [
      "CA-W-25810"
     ],
     "description": "TTB permit number(s), CSV (STATE-TYPE-SEQ)."
    },
    "operating_name": {
     "type": "string",
     "examples": [
      "Distillery"
     ],
     "description": "Operating / DBA name fragment."
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ttb-permittees-search-govparse-8797748b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.govparse.io](https://www.zero.xyz/host/api.govparse.io/llms.txt)