Browse all documentation

Trade coverage by country

Which countries answer from their own customs or statistics office, which from UN Comtrade or other countries' reports, from when, and which give products.

Overview

Narwhal answers trade for 181 countries, and each answer carries a label that says which source produced it: own for the country's own customs or statistics office, third_party for its filing with UN Comtrade, and partner_reported for what other countries report about it. This page says which countries answer from which source and what each source can and cannot give.

For the months held now, call the coverage route: it names the source that answers each country today and the first and latest month held.

Own offices

These countries answer from their own office. History starts in January 2010 where the office publishes it, and later where the table says so. Values are in the office's own currency.

CountryPublisherCurrencyHistory fromPartnersProducts
United KingdomHM Revenue & CustomsGBP2010-01All partnersHS6
The 27 EU members, each its own reporterEurostat ComextEUR2010-01All partnersHS6
United StatesUS Census BureauUSD2010-01All partnersHS6
CanadaStatistics CanadaCAD2010-0127 named partners, the EU as a group and one rest rowPartner totals only
MexicoINEGI, National Institute of Statistics and GeographyUSD2015-01All partnersPartner totals only
AustraliaAustralian Bureau of StatisticsAUD2010-01All partnersPartner totals only
ChileServicio Nacional de Aduanas de ChileUSD2020-01All partnersHS6
JapanMinistry of Finance Japan, Trade StatisticsJPY2010-01All partnersHS6
BrazilMDIC Comex StatUSD2010-01All partnersHS6
NorwayStatistics NorwayNOK2010-01All partnersHS6
SwitzerlandFederal Office for Customs and Border Security (BAZG)CHF2010-01All partnersHS6
New ZealandStats NZNZD2015-01All partnersHS6
ThailandMinistry of Commerce ThailandTHB2022-01All partnersHS4

HS6 means the products route answers at 2, 4 and 6 digits. HS4 means it answers at 2 and 4 digits: Narwhal holds Thailand's products at 4 digits. The 4 and 6 digit rows are built from the office's lines, and a line the office prints at chapter level only, such as a withheld detail, appears in the chapter answer and not in the 4 and 6 digit ones. Its value stays inside the partner totals.

Limits

  • Canada, Mexico and Australia give partner totals only from their own office. Their products at 4 and 6 digits are not held, so the products route and an hs of 4 or 6 digits answer 404 basis_not_available. At chapter level (2 digits) the partners route with hs and the products route answer these countries from other countries' reports, labelled partner_reported. The open query with one of them as reporter and an hs answers 404.
  • Canada's office names its 27 largest partners and the EU as a group. All other trade is one row with partner_kind unallocated and unallocated_reason rest, so the rows still add up to the total.
  • Mexico's institute hides some partner cells as confidential. What is left of the total after the visible partners is one row with unallocated_reason confidential.
  • Each office counts trade its own way: FOB or CIF values, the general or the special system, partners by origin or destination. The answer states what the office states in valuation_basis, trade_system and partner_basis, and says not_stated when the office does not. Narwhal does not make the figures of two countries comparable.
  • Chile starts in January 2020, the first year in which every month adds up in both flows. Mexico and New Zealand start in January 2015, where the publisher's files begin. Thailand starts in January 2022, the first month of the HS 2022 product list the ministry publishes. Narwhal reads Thailand's exports from the Ministry of Commerce website country report, which matches Thai Customs and leaves re-exports out, and imports from the Ministry's open API. The Ministry's headline export totals include re-exports and are 0.03% to 0.6% higher each month.
  • The newest month depends on the office's release schedule and is in latest_period. A month the office has not published answers 404 period_not_published. Figures are served as held now: offices revise them, and there is no as_of. Where an office publishes an update date, Narwhal checks it every few hours and reads again any month back to January of last year that the office has revised since. For the other offices it reads again the newest 7 months, daily or weekly. A revision to an older month at those offices is not picked up.
  • HS editions are never converted into each other. A row names the edition of its source month.

Planned offices

More offices are planned: South Korea, India, Indonesia, Turkey, South Africa, Saudi Arabia, Pakistan, Kazakhstan, Kyrgyzstan, Moldova, Namibia, Uruguay, Vanuatu, Bahrain, Ghana and Iceland. Until an office is loaded, its country is answered as every other country is, below. When it is loaded, the same request answers with basis own, and nothing in your request changes.

Every other country

Every other country of the 181 in the coverage list is answered from UN Comtrade or from other countries' reports. A country outside the list answers 404 country_not_covered. A request without basis takes own, then UN Comtrade, then partner reports. By product it takes own and then partner reports.

UN Comtrade (third_party, source UN Comtrade) is the country's own monthly filing with the United Nations. It gives partner totals only, with no products. A country files on its own schedule, so its latest month can be well behind: comtrade_latest_period on the coverage route shows it.

Partner-reported (partner_reported) is built from what other countries report about the country, with the flows swapped: their imports from it are its exports, and their exports to it are its imports. reporters_included lists the countries whose reports were used, and note says what the figures are. It reaches chapters (2 digits) only, covers at most 12 months, has no official total and takes no top, share, ytd or change.

A partner-reported answer is a different measurement from the country's own figures and can differ widely from them. Two countries seldom record the same trade at the same value: one counts FOB and the other CIF, and they can name different partners for goods that pass through a third country. Use the label, and do not read a partner-reported figure as the country's official one.

Check a country

GET /v1/trade/coverage returns one row for each country. answers_with is the source that answers today, tiers_held lists every source that has rows, first_period and latest_period are the months held from the country's own office, and products_tier says who answers by product. The route is free.

Trade coverage route · Trade API reference

Was this page helpful?