> ## Documentation Index > Fetch the complete documentation index at: https://docs.nexusfeed.dev/llms.txt > Use this file to discover all available pages before exploring further. # Search Licenses > Search for ABC liquor licenses by trade name, owner, or address. Use this endpoint to verify whether a business holds a valid liquor license before a transaction, distributor onboarding, insurance binding, or compliance check. At least one of `dba_name`, `owner_name`, or `address` must be provided. Returns a list of matching licenses with status (ACTIVE, SUSPENDED, EXPIRED, REVOKED), license type, expiration date, and a `_verifiability` block with source timestamp and confidence score. Results are cached for 24 hours. Supported states: CA (CA ABC), TX (TX TABC, requires CAPTCHA solver), NY (NY Open Data), FL (DBPR), IL (ILCC). Call `/v1/abc/states` to see coverage details and CAPTCHA requirements per state. ## OpenAPI ````yaml https://api.nexusfeed.dev/openapi.json get /v1/abc/search openapi: 3.1.0 info: title: B2B Agentic Arbitrage Hub description: >- Real-time LTL freight carrier fuel surcharge rates and ABC liquor license compliance records, served as agent-ready JSON with verifiability metadata. Built for AI agents that need authoritative B2B data — not raw HTML scraping. ## Products - **LTL Fuel Surcharge** (`/v1/ltl`): 6 carriers (ODFL, Saia, Estes, ABF, R+L, TForce), weekly rates, DOE diesel price, up to 5 years of history - **ABC License Compliance** (`/v1/abc`): CA, TX, NY, FL — license status, expiration, and suspension records ## Authentication All endpoints require an `X-API-Key` header. Contact `ops@nexusfeed.dev` to obtain an API key. ## Verifiability Every response includes a `_verifiability` block with `source_timestamp`, `extraction_confidence`, `raw_data_evidence_url`, `extraction_method`, and `data_freshness_ttl_seconds` — enabling agents to cite provenance and assess staleness. version: 1.0.0 servers: - url: https://api.nexusfeed.dev description: Production security: - ApiKeyAuth: [] paths: /v1/abc/search: get: tags: - ABC summary: Search Licenses description: >- Search for ABC liquor licenses by trade name, owner, or address. Use this endpoint to verify whether a business holds a valid liquor license before a transaction, distributor onboarding, insurance binding, or compliance check. At least one of `dba_name`, `owner_name`, or `address` must be provided. Returns a list of matching licenses with status (ACTIVE, SUSPENDED, EXPIRED, REVOKED), license type, expiration date, and a `_verifiability` block with source timestamp and confidence score. Results are cached for 24 hours. Supported states: CA (CA ABC), TX (TX TABC, requires CAPTCHA solver), NY (NY Open Data), FL (DBPR), IL (ILCC). Call `/v1/abc/states` to see coverage details and CAPTCHA requirements per state. operationId: search_licenses_v1_abc_search_get parameters: - name: state in: query required: false schema: type: string description: >- Two-letter state code. Supported: CA, TX, NY, FL, IL. TX requires 2Captcha configuration on the server. default: CA title: State description: >- Two-letter state code. Supported: CA, TX, NY, FL, IL. TX requires 2Captcha configuration on the server. - name: dba_name in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Trade name or DBA (doing business as) to search for. Partial matches supported. title: Dba Name description: >- Trade name or DBA (doing business as) to search for. Partial matches supported. - name: owner_name in: query required: false schema: anyOf: - type: string - type: 'null' description: License owner or applicant name. Partial matches supported. title: Owner Name description: License owner or applicant name. Partial matches supported. - name: address in: query required: false schema: anyOf: - type: string - type: 'null' description: Street address or city to filter by. title: Address description: Street address or city to filter by. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LicenseSearchResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: LicenseSearchResponse: properties: state: type: string title: State query: additionalProperties: type: string type: object title: Query total_results: type: integer title: Total Results results: items: $ref: '#/components/schemas/LicenseRecord' type: array title: Results _verifiability: $ref: '#/components/schemas/Verifiability' type: object required: - state - query - total_results - results - _verifiability title: LicenseSearchResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError LicenseRecord: properties: license_number: type: string title: License Number license_type_code: type: string title: License Type Code dba_name: type: string title: Dba Name owner_name: anyOf: - type: string - type: 'null' title: Owner Name expiration_date: anyOf: - type: string format: date - type: 'null' title: Expiration Date status: anyOf: - $ref: '#/components/schemas/LicenseStatus' - type: 'null' address: anyOf: - $ref: '#/components/schemas/Address' - type: 'null' suspensions: items: $ref: '#/components/schemas/SuspensionRecord' type: array title: Suspensions type: object required: - license_number - license_type_code - dba_name title: LicenseRecord Verifiability: properties: source_timestamp: type: string format: date-time title: Source Timestamp extraction_confidence: type: number title: Extraction Confidence raw_data_evidence_url: type: string title: Raw Data Evidence Url extraction_method: $ref: '#/components/schemas/ExtractionMethod' data_freshness_ttl_seconds: type: integer title: Data Freshness Ttl Seconds type: object required: - source_timestamp - extraction_confidence - raw_data_evidence_url - extraction_method - data_freshness_ttl_seconds title: Verifiability ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError LicenseStatus: type: string enum: - ACTIVE - ACTIVE_RENEWAL_PENDING - SUSPENDED - TEMPORARILY_SURRENDERED - EXPIRED - CANCELLED - SURRENDERED - REVOKED - PENDING title: LicenseStatus Address: properties: street: anyOf: - type: string - type: 'null' title: Street city: anyOf: - type: string - type: 'null' title: City state: anyOf: - type: string - type: 'null' title: State zip_code: anyOf: - type: string - type: 'null' title: Zip Code county: anyOf: - type: string - type: 'null' title: County raw: anyOf: - type: string - type: 'null' title: Raw type: object title: Address SuspensionRecord: properties: start_date: anyOf: - type: string format: date - type: 'null' title: Start Date end_date: anyOf: - type: string format: date - type: 'null' title: End Date reason: anyOf: - type: string - type: 'null' title: Reason type: object title: SuspensionRecord ExtractionMethod: type: string enum: - api_mirror - playwright_dom - structured_parse - scraper_api - scraper_api_fallback title: ExtractionMethod securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key ````