BETA This app is in Beta Testing
TariffAPIs
Start free

API reference

Beta · sample data

During the beta these results come from a sample reference dataset (tax rates, HS catalog, regulations, screening, sanctions and PEP lists), not the official sources. Use them to build and test your integration, not for customs declarations or compliance decisions. API responses carry x-tariffapis-data: sample.

Base URL: https://tariffapis.com. Requests and responses are JSON.

Authenticate every call with Authorization: Bearer tk_live_…; create keys under API keys in the app. Responses carry x-ratelimit-limit and x-ratelimit-remaining; a 429 includes retry-after.

Errors look like {"error": {"code": "…", "message": "…"}}. 401 means a missing or revoked key; 403 means your plan doesn't include the module.

ai

  • POST /api/v1/ai/complete Raw completion through the gateway Guide
  • POST /api/v1/ai/assistant Ask with screening context Guide

aml

  • POST /api/v1/aml/screen AML / PEP screening Guide

compliance

  • POST /api/v1/compliance/screen Screen a shipment Guide

contact center

  • POST /api/v1/contact-center/agents Register an agent Guide
  • POST /api/v1/contact-center/route Route a work item Guide
  • GET /api/v1/contact-center/stats Queue statistics Guide

ekyc

  • POST /api/v1/ekyc/verify Verify an individual Guide
  • POST /api/v1/ekyc/sessions Start an Authpermit document + liveness check Guide

helpdesk

  • POST /api/v1/helpdesk/tickets Create a ticket Guide
  • POST /api/v1/helpdesk/classify Classify text Guide

hs

  • POST /api/v1/hs/classify Classify a product description Guide

kyb

  • POST /api/v1/kyb/verify Verify a business Guide
  • POST /api/v1/kyb/registry-check Start an Authpermit registry check Guide

landed cost

  • POST /api/v1/landed-cost/estimate Estimate landed cost Guide

messaging

  • POST /api/v1/messaging/inbound Deliver an inbound message Guide
  • POST /api/v1/messaging/translate Translate a message Guide

regulations

  • POST /api/v1/regulations/search Find regulations Guide

risk

  • POST /api/v1/risk/score Score a shipment Guide

sanctions

  • POST /api/v1/sanctions/screen Sanctions screening Guide

tariffs

  • POST /api/v1/tariffs/calculate Calculate duty for one line Guide

taxes

  • POST /api/v1/taxes/calculate Calculate import tax Guide

verifications

  • GET /api/v1/verifications/:id Read a verification's result Guide

voip

  • POST /api/v1/voip/extensions Create an extension Guide
  • POST /api/v1/voip/calls Log a call Guide