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/classify4 credits

Product description (+materials) + destination → ranked candidate HS codes with a confidence band, reason, and review_required. Candidates are SUGGESTIONS for a human/broker to confirm — low-confidence candidates are clearly marked, never shown as a settled code.

Working example
Parameters

Free-text product description to classify into candidate HS codes. Returned candidates carry a confidence band + review_required — they are SUGGESTIONS for a human/broker to confirm, never a final code.

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.

Optional: chief material(s) of the product. Appended to the search text to sharpen classification (material drives HS chapters).

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/classify \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"description":"leather shoes for men","destination":"US"}'

Hit Send to run this endpoint live.