Skip to main content
GET
/
api
/
trade
/
v1
/
get-trade-flows
GetTradeFlows
curl --request GET \
  --url https://api.example.com/api/trade/v1/get-trade-flows
{
  "flows": [
    {
      "reportingCountry": "<string>",
      "partnerCountry": "<string>",
      "year": 123,
      "exportValueUsd": 123,
      "importValueUsd": 123,
      "yoyExportChange": 123,
      "yoyImportChange": 123,
      "productSector": "<string>"
    }
  ],
  "fetchedAt": "<string>",
  "upstreamUnavailable": true
}

Query Parameters

reporting_country
string

WTO member code of reporting country.

partner_country
string

WTO member code of partner country.

years
integer<int32>

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

Response

Successful response

Response containing trade flow records.

flows
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.