Skip to main content
GET
/
api
/
trade
/
v1
/
get-tariff-trends
GetTariffTrends
curl --request GET \
  --url https://api.example.com/api/trade/v1/get-tariff-trends
{
  "datapoints": [
    {
      "reportingCountry": "<string>",
      "partnerCountry": "<string>",
      "productSector": "<string>",
      "year": 123,
      "tariffRate": 123,
      "boundRate": 123,
      "indicatorCode": "<string>"
    }
  ],
  "fetchedAt": "<string>",
  "upstreamUnavailable": true,
  "effectiveTariffRate": {
    "sourceName": "<string>",
    "sourceUrl": "<string>",
    "observationPeriod": "<string>",
    "updatedAt": "<string>",
    "tariffRate": 123
  }
}

Query Parameters

reporting_country
string

WTO member code of reporting country (e.g. "840" = US).

partner_country
string

WTO member code of partner country (e.g. "156" = China).

product_sector
string

Product sector filter (HS chapter). Empty = aggregate.

years
integer<int32>

Number of years to look back (default 10, max 30).

Response

Successful response

Response containing tariff trend datapoints.

datapoints
object[]
fetchedAt
string

ISO 8601 timestamp when data was fetched from WTO.

upstreamUnavailable
boolean

True if upstream fetch failed and results may be stale/empty.

effectiveTariffRate
object

Current effective tariff estimate for countries with coverage beyond WTO MFN baselines.