API access — CODICI

The CODICI API lets you look up HS codes from any software — your ERP, your customs filing system, a spreadsheet, or a custom-built tool. Authentication uses an API key. Responses are JSON.

Endpoint

POST https://api.codi.ci/v1/lookup

Authentication

Pass your API key in the request header. Each account has one or more API keys, which you manage in your portal.

X-API-Key: your_api_key_here

Response fields

Field	Description
`hs_code`	The recommended HS code
`description`	Description of the HS chapter and heading
`confidence`	Confidence score (0–1)
`explanation`	Explanation of why this code was selected

Request

# cURL example
curl -X POST https://api.codi.ci/v1/lookup \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "product": "stainless steel kitchen knives",
    "country_of_origin": "CN"
  }'
        

Response

{
  "hs_code": "8211.10",
  "description": "Knives with fixed blades",
  "confidence": 0.97,
  "explanation": "Classified under HS chapter 82
    (tools, implements...). The item is a
    kitchen knife with a fixed blade,
    falling under heading 8211.",
  "lookup_id": "lk_a8f2c91d"
}
        

Getting access

API access is available to all registered accounts. Prepaid account holders get full API access at €5 per lookup. Professional customers get custom pricing — contact us to discuss volume rates.