The playground

Try any of 919 endpoints — live.

Pick an endpoint, load a working example, tweak the params, and send — no signup to try. Results render the way the data deserves; raw JSON, headers & code are one tab away.

Playground demo key · api.reefapi.com
post/hs-code/v1/batch_classify3 credits

Up to 25 products in one call (discounted). Each item is classified (or looked up if a code is given) independently; one bad item never fails the batch.

Working example
Parameters

Up to 25 products, each {description, materials?} (or {code} to look up directly). Each item gets its own candidates + review_required; a bad item yields its own error entry, never failing the batch.

Destination market whose official tariff schedule to use. v1 covers US and UK only (the two .gov schedules we fetch real data from); EU and other markets are out of scope — do not assume coverage.

Max candidate results (1-50). (1–50)

Drop classify candidates whose confidence is below this 0-1 threshold. (0–1)

request preview
curl -X POST https://api.reefapi.com/hs-code/v1/batch_classify \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"items":"[{\"description\":\"leather shoes\"},{\"description\":\"laptop\"}]","destination":"US"}'

Hit Send to run this endpoint live.