AI Commodity Classification

POST/v1/hs/classify$0.05 per call

Classify a commodity into HTS codes using Claude with GRI reasoning.

Send an Idempotency-Key header to retry safely.

Request body

Field	Type	Description
descriptionrequired	string	Commodity description
countryOfOriginoptional	string	ISO-2 country code
intendedUseoptional	string
materialoptional	string

Response fields

The spec does not describe this response yet, and there is no captured example. Run the request with your sandbox key to see its shape.

Errors

400 invalid request
401 missing or bad key
403 not in your plan
429 rate limited, see Retry-After
402 payment required
5xx retry with backoff

Error bodies and codes are described in Error codes and troubleshooting.

curl -X POST "https://api.compliancegrid.ai/v1/hs/classify" \
  -H "Authorization: Bearer $CG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Men's cotton knit t-shirts"
  }'

Try it in the sandbox

Runs against sandbox.api.compliancegrid.ai with your own sandbox key, which stays in this browser. Sandbox responses are mock data. Get a free key.

Sandbox key

Remember for this tab

Request body (JSON)