API-toegang — CODICI

De CODICI API laat u HS-codes opzoeken vanuit elke software — uw ERP, uw aangiftesysteem, een spreadsheet of een zelfgebouwde tool. Authenticatie gaat via een API-sleutel. Antwoorden zijn in JSON-formaat.

Endpoint

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

Authenticatie

Geef uw API-sleutel mee in de request header. Elk account heeft één of meer API-sleutels, die u beheert in uw portaal.

X-API-Key: your_api_key_here

Response velden

Veld	Omschrijving
`hs_code`	De aanbevolen HS-code
`description`	Omschrijving van het HS-hoofdstuk en de post
`confidence`	Betrouwbaarheidsscore (0–1)
`explanation`	Toelichting waarom deze code is geselecteerd

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"
}
        

Toegang krijgen

API-toegang is beschikbaar voor alle geregistreerde accounts. Prepaid accounthouders krijgen volledige API-toegang voor €5 per zoekopdracht. Professionele klanten krijgen op maat gemaakte tarieven — neem contact op voor volumeprijzen.

Contact voor professionele toegang