Tariffs API

Access comprehensive tariff information, duty rates, and trade agreements across countries.

POST/api/v1/tariffs/calculate

Calculate import duties and tariffs for a specific product and destination.

Request Body

{
  "hsCode": "8517",
  "origin": "US",
  "destination": "CN",
  "value": 10000,
  "currency": "USD",
  "weight": 500,
  "unit": "kg"
}

Response

{
  "success": true,
  "data": {
    "hsCode": "8517",
    "origin": "US",
    "destination": "CN",
    "value": 10000,
    "currency": "USD",
    "tariff": {
      "mfnRate": 13,
      "mfnDuty": 1300,
      "preferentialRate": null,
      "preferentialDuty": null,
      "vat": 13,
      "vatAmount": 1469,
      "totalDuties": 2769,
      "effectiveRate": 27.69
    },
    "tradeAgreements": [
      {
        "name": "WTO MFN",
        "rate": 13,
        "applicable": true
      }
    ]
  }
}

GET/api/v1/tariffs/countries/:country

Get general tariff information and trade policies for a specific country.

Path Parameters

Parameter	Type	Description
country	string	ISO country code (e.g., US, CN)

Response

{
  "success": true,
  "data": {
    "country": "CN",
    "countryName": "China",
    "currency": "CNY",
    "averageTariff": 7.5,
    "vatRate": 13,
    "tradeAgreements": [
      {
        "name": "RCEP",
        "members": ["CN", "JP", "KR", "AU", "NZ", "ASEAN"],
        "effectiveDate": "2022-01-01"
      },
      {
        "name": "ASEAN-China FTA",
        "members": ["CN", "ASEAN"],
        "effectiveDate": "2005-07-20"
      }
    ],
    "customsRequirements": {
      "commercialInvoice": true,
      "packingList": true,
      "certificateOfOrigin": true,
      "billOfLading": true
    }
  }
}

POST/api/v1/tariffs/compare

Compare tariff rates across multiple destination countries for market analysis.

Request Body

{
  "hsCode": "8517",
  "origin": "US",
  "destinations": ["CN", "JP", "DE", "GB"],
  "value": 10000,
  "currency": "USD"
}

Response

{
  "success": true,
  "data": {
    "hsCode": "8517",
    "origin": "US",
    "value": 10000,
    "currency": "USD",
    "comparisons": [
      {
        "country": "CN",
        "countryName": "China",
        "mfnRate": 13,
        "totalDuties": 2769,
        "effectiveRate": 27.69,
        "rank": 4
      },
      {
        "country": "JP",
        "countryName": "Japan",
        "mfnRate": 0,
        "totalDuties": 1000,
        "effectiveRate": 10.0,
        "rank": 1
      },
      {
        "country": "DE",
        "countryName": "Germany",
        "mfnRate": 0,
        "totalDuties": 1900,
        "effectiveRate": 19.0,
        "rank": 2
      },
      {
        "country": "GB",
        "countryName": "United Kingdom",
        "mfnRate": 0,
        "totalDuties": 2000,
        "effectiveRate": 20.0,
        "rank": 3
      }
    ],
    "bestMarket": {
      "country": "JP",
      "effectiveRate": 10.0,
      "savings": 1769
    }
  }
}

Major Trade Agreements

Our API includes data from major trade agreements that may provide preferential tariff rates.

Agreement	Members	Status
USMCA	US, Canada, Mexico	Active
EU Single Market	27 EU member states	Active
RCEP	15 Asia-Pacific countries	Active
AfCFTA	54 African countries	Active
CPTPP	11 Pacific Rim countries	Active