---
title: "Commodity Codes"
method: POST
path: "/commodity_codes"
tags: ["Wine Intelligence"]
---

# Commodity Codes

`POST /commodity_codes`

## Request

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

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

## Request body

- object
  - `user_id` string, uuid, required: Authorized user identifier used for authentication and rate limiting.
  - `query` string: Free-text product or wine description. Used with Wine Labs matching when provided.
  - `lwin` string: Direct LWIN lookup for known wines.
  - `wl_id` string: Wine Labs wine identifier for known wines.
  - `vintage` string: Optional vintage used when enriching known wine attributes.
  - `product_type / commodity_type / hs_code_6` string: Optional classification hints when the product is not supplied as a known wine.
  - `container_size_ml, abv, color, origin_country, destination_country` number: Optional product attributes that improve jurisdiction-specific guidance.

## Response `200`

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

---

[API](https://skmtc.dev/winelabs/apis/wine-labs-api.md) · [All operations](https://skmtc.dev/winelabs/apis/wine-labs-api/llms.txt) · [OpenAPI document](https://skmtc.dev/winelabs/apis/wine-labs-api/revisions/f8898ca9974e?raw)