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

# Get License

> Look up a single ABC liquor license by its state-issued license number.

Use this endpoint when you already have a license number and need to verify its current
status, expiration date, license type, and holder details. More precise than search —
returns exactly one record or 404 if not found.

The `_verifiability` block includes a `raw_data_evidence_url` linking directly to the
source record on the state agency's website, enabling independent verification.

Supported states: CA (CA ABC), TX (TX TABC, requires CAPTCHA solver), NY (NY Open Data), FL (DBPR), IL (ILCC).



## OpenAPI

````yaml https://api.nexusfeed.dev/openapi.json get /v1/abc/license/{license_number}
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/license/{license_number}:
    get:
      tags:
        - ABC
      summary: Get License
      description: >-
        Look up a single ABC liquor license by its state-issued license number.


        Use this endpoint when you already have a license number and need to
        verify its current

        status, expiration date, license type, and holder details. More precise
        than search —

        returns exactly one record or 404 if not found.


        The `_verifiability` block includes a `raw_data_evidence_url` linking
        directly to the

        source record on the state agency's website, enabling independent
        verification.


        Supported states: CA (CA ABC), TX (TX TABC, requires CAPTCHA solver), NY
        (NY Open Data), FL (DBPR), IL (ILCC).
      operationId: get_license_v1_abc_license__license_number__get
      parameters:
        - name: license_number
          in: path
          required: true
          schema:
            type: string
            title: License Number
        - name: state
          in: query
          required: false
          schema:
            type: string
            description: >-
              Two-letter state code matching the license number. Supported: CA,
              TX, NY, FL, IL.
            default: CA
            title: State
          description: >-
            Two-letter state code matching the license number. Supported: CA,
            TX, NY, FL, IL.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LicenseLookupResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    LicenseLookupResponse:
      properties:
        state:
          type: string
          title: State
        license_number:
          type: string
          title: License Number
        record:
          anyOf:
            - $ref: '#/components/schemas/LicenseRecord'
            - type: 'null'
        _verifiability:
          $ref: '#/components/schemas/Verifiability'
      type: object
      required:
        - state
        - license_number
        - _verifiability
      title: LicenseLookupResponse
    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

````