Global Trade Tariff API

HS code lookups, tariff rate calculations, and trade agreement data covering 200+ countries. Calculate landed costs, compare MFN vs. preferential rates, and explore free trade agreements using data from WTO IDB, UNCTAD TRAINS, and National Customs.

Live

Base URL

https://api.crimate.net/v1/tariff

Authentication

Include your Trade Tariff API key in the Authorization header.

curl -H "Authorization: Bearer db_trade_tariff_live_YOUR_KEY" \
     https://api.crimate.net/v1/tariff/rates?hs_code=090111&importer=ZA

Endpoints

GET/v1/tariff/hs-codes

Browse the Harmonized System code hierarchy with optional search and chapter filters

Parameters: q (search term), chapter (HS chapter 01-99), level (2|4|6|8), page, per_page

Example

GET /v1/tariff/hs-codes?chapter=09&level=6

GET/v1/tariff/hs-codes/{code}

Detailed HS code information including description, section, chapter, and applicable duty types

Parameters: code (required, path, 2-10 digit HS code)

Example

GET /v1/tariff/hs-codes/090111

GET/v1/tariff/rates

Tariff rates by HS code, importer, and exporter country with MFN and preferential rates

Parameters: hs_code (required), importer (ISO alpha-2), exporter (ISO alpha-2), year, page, per_page

Example

GET /v1/tariff/rates?hs_code=090111&importer=ZA&exporter=BR

GET/v1/tariff/rates/calculate

Calculate total landed duty for a shipment given HS code, origin, destination, and value

Parameters: hs_code (required), origin (required), destination (required), value (required, USD), quantity, unit

Example

GET /v1/tariff/rates/calculate?hs_code=090111&origin=BR&destination=ZA&value=10000

GET/v1/tariff/agreements

List trade agreements (FTAs, customs unions, preferential schemes) with country coverage

Parameters: country (ISO alpha-2), type (fta|customs_union|gsp), status (active|pending), page, per_page

Example

GET /v1/tariff/agreements?country=ZA&type=fta&status=active

GET/v1/tariff/agreements/{id}

Detailed trade agreement information including member countries, concession schedules, and rules of origin

Parameters: id (required, path)

Example

GET /v1/tariff/agreements/afcfta

GET/v1/tariff/stats

Dataset statistics (total HS codes, countries, agreements, latest update)

Parameters: None

Example

GET /v1/tariff/stats

Response Examples

Tariff rate calculation response:

{
  "calculation": {
    "hs_code": "090111",
    "description": "Coffee, not roasted, not decaffeinated",
    "origin": "BR",
    "origin_name": "Brazil",
    "destination": "ZA",
    "destination_name": "South Africa",
    "declared_value_usd": 10000.00,
    "mfn_rate_pct": 10.00,
    "preferential_rate_pct": null,
    "applied_rate_pct": 10.00,
    "duty_usd": 1000.00,
    "vat_rate_pct": 15.00,
    "vat_usd": 1650.00,
    "total_landed_usd": 12650.00,
    "agreement": null,
    "notes": "No preferential agreement applies between BR and ZA for this HS code."
  }
}

Try It

Enter your Trade Tariff API key to make a live request. Generate a key in the dashboard.

Try It

Make a live API call from your browser

API Key

Endpoint

GET

curl -H "Authorization: Bearer db_trade_tariff_live_YOUR_KEY" \
     "https://crimate.net/v1/tariff/stats"

Data Sources

WTO Integrated Database (IDB)

Applied tariff rates notified by WTO members covering MFN (Most Favoured Nation) duties, bound rates, and tariff quotas. The primary source for multilateral tariff commitments across 164 WTO member states.

UNCTAD TRAINS

Trade Analysis Information System from the UN Conference on Trade and Development. Covers preferential tariff rates, non-tariff measures (NTMs), and trade flow data. Complements WTO data with bilateral preferential rate schedules.

National Customs

National-level tariff schedules from customs authorities including SARS (South Africa), CBP (United States), and HMRC (United Kingdom). Provides country-specific HS code extensions, VAT rates, and additional levies not captured in multilateral databases.

Rate Limits

Tier	Price	Rate Limit	Daily Quota	Monthly Quota
Free	R0/mo	10 req/min	100	1,000
Starter	R999/mo	60 req/min	5,000	50,000
Pro	R3,999/mo	300 req/min	Unlimited	500,000

Error Codes

All error responses follow a consistent JSON format:

{
  "error": "error_code",
  "message": "Human-readable description."
}

Status	Error Code	Description
400	invalid_request	The request body or query parameters are malformed.
401	unauthorized	Missing or invalid API key.
403	no_subscription	No active subscription for this API product.
403	quota_exceeded	Daily or monthly quota exceeded.
404	not_found	The requested resource does not exist.
429	rate_limit_exceeded	Too many requests. Check X-RateLimit-Remaining header.
500	internal_error	An unexpected server error occurred.