Wine Intelligence

Commodity Codes

Classify wine, sparkling wine, grape must, other fermented beverages, and spirits into high-level HS and market-specific commodity code guidance.

post/commodity_codes

Request

  • Base URL: https://external-api.wine-labs.com
  • URL: https://external-api.wine-labs.com/commodity_codes
  • Auth: none declared

Request body

user_idstring uuid required

Authorized user identifier used for authentication and rate limiting.

querystring

Free-text product or wine description. Used with Wine Labs matching when provided.

lwinstring

Direct LWIN lookup for known wines.

wl_idstring

Wine Labs wine identifier for known wines.

vintagestring

Optional vintage used when enriching known wine attributes.

product_type / commodity_type / hs_code_6string

Optional classification hints when the product is not supplied as a known wine.

container_size_ml, abv, color, origin_country, destination_countrynumber

Optional product attributes that improve jurisdiction-specific guidance.

Response

Response highlights:

  • hs_code_6: resolved six-digit HS classification and display label.
  • commodity_type: Wine Labs high-level commodity category.
  • jurisdiction_codes: available resolved market codes, when they can be derived safely.
  • country_code_systems[]: market-by-market code systems, candidate patterns, and any attributes still needed for authority lookup.

Notes:

  • At least one product identifier or classification hint is required.
  • Market-specific codes may be returned as candidate patterns when official authority lookup or additional product attributes are still required.
object required

Changes

No recorded changes to this operation across all 1 revision of this API.