Glossary¶

Terms and abbreviations used in the API, the series names and these docs.

Trade and classification¶

HS code, HS6¶

The Harmonized System: the international product classification used by customs everywhere. The first 6 digits are the same worldwide (HS6); countries add more digits for national detail (8 in the EU's Combined Nomenclature, 10 in the Russian TN VED, up to 12 in Türkiye's GTİP). GET /v1/products/{hs6} needs exactly six digits (382440). The restriction checks (/v1/restrictions/{hs}) accept longer codes with dots or spaces and compare on the first digits they need. Two-digit codes are HS chapters (38 is chemical products); China's monthly trade with Russia after 2024-12 is published at chapter level only.

GTİP, TN VED¶

Local names for the national tariff codes: GTİP in Türkiye (Gümrük Tarife İstatistik Pozisyonu), TN VED (ТН ВЭД) in Russia and the Eurasian Economic Union. The first 6 digits are HS6.

Mirror data¶

Trade statistics reported by the partner instead of the country itself. Russia's imports from Türkiye as recorded by Türkiye's exports to Russia are mirror data. The service uses mirror data to see Russian imports by supplier because Russia publishes little itself: ru.mirror.imports_from.<country>.usd are the exporter's reported exports to Russia, and the product_check supplier tables are built the same way.

Mirror data have limits. Each country reports on its own schedule, so the newest month or year may include only some reporters. Valuation and timing differ between reporter and partner (see FOB/CIF). Values rarely match the importer's own figures exactly.

FOB, CIF¶

Two ways to value goods in trade. FOB (free on board) values goods at the exporter's border, without freight and insurance. CIF (cost, insurance, freight) includes them up to the importer's border. Exports are usually recorded FOB and imports CIF, so the same shipment is worth more in the importer's statistics than in the exporter's. This is one reason mirror data do not match.

Parallel import¶

Russia's scheme, in force since 2022, that allows importing certain branded goods without the rights holder's consent. The parallel_import source holds the Ministry of Industry and Trade list (order No. 2701 of 21.07.2023, as updated), by TN VED code, with the brands listed (mode: brand) or excluded (mode: excluded). It appears in the restrictions block of a product check.

Russian company identifiers¶

INN, OGRN, KPP¶

INN (ИНН): taxpayer number. 10 digits for a legal entity, 12 for an individual. The main key for company lookups: GET /v1/companies/{inn}.
OGRN (ОГРН): state registration number. 13 digits for legal entities.
KPP (КПП): 9-digit registration reason code. One legal entity has one INN and may have several KPPs (one per branch).

OKVED¶

The Russian classification of economic activities (ОКВЭД). Codes are hierarchical: 20 is manufacture of chemicals, 46.75 is wholesale of chemical products. okved_prefix in company search matches from the start of the code.

Size and revenue bands¶

The registry gives companies in bands (for example size micro, small, medium, large; revenue lt_100m, gt_10b), never exact figures.

Sanctions and export controls¶

OFAC, SDN, CSL¶

OFAC is the US Treasury's Office of Foreign Assets Control. Its SDN list (Specially Designated Nationals) names persons and entities whose assets are blocked. CSL is the US Consolidated Screening List published by the Department of Commerce through trade.gov; it merges several US lists, among them the BIS Entity List and the Sectoral Sanctions Identifications list. In GET /v1/sanctions/check each hit carries a list value (OFAC, CSL, EU, UK, UN).

OFAC also issues general licenses that authorise otherwise prohibited transactions, often with an expiry date; they appear in the calendar (ofac_gl_expiry) and the document search.

Annex (EU Regulation 833/2014)¶

Council Regulation (EU) No 833/2014 sets the EU's sectoral measures against Russia (trade bans, export controls). The goods covered are listed in numbered annexes (for example Annex XXI for import bans on revenue-generating goods, Annex XXIII for industrial-capacity goods export bans). Each match from the service carries the annex, the CN code in it, the restriction label, the article reference and the consolidated date. Annexes such as XXIV, XXXI and XXXII are derogation or quota lists, not bans. This is documentation help, not legal advice.

CHP list¶

The Common High Priority Items List: a list of HS codes of items that the US, EU, UK and Japan identify as most sought after for Russia's military supply chains. The service reads the BIS page. Entries have tiers; tier 1 is the highest priority. on_chp_list in /v1/restrictions/{hs} tells you whether an HS6 matches.

Data providers and bodies¶

CBR¶

The Central Bank of the Russian Federation (Bank of Russia, Центральный банк). Source of the key rate, official FX rates, RUONIA, reserves and the external-sector statistics.

TCMB, EVDS¶

TCMB (Türkiye Cumhuriyet Merkez Bankası) is the Central Bank of the Republic of Türkiye; PPK is its Monetary Policy Committee. EVDS (Elektronik Veri Dağıtım Sistemi) is TCMB's electronic data delivery system, the source for Turkish rates, FX, inflation, visitor numbers, truck counts and more. In the API it is the evds source.

TİM¶

Türkiye İhracatçılar Meclisi, the Turkish Exporters Assembly. It publishes monthly exports by country and sector. The tr.exports_to.* series are "TİM consolidated" figures.

TÜİK¶

Türkiye İstatistik Kurumu, the Turkish Statistical Institute (also written TurkStat). Source of foreign trade by country and HS code (tuik_trade, series tr.tuik.*) and housing sales to foreigners (tuik_housing). TÜİK and TİM figures for the same flow differ; see the FAQ.

KTB¶

Kültür ve Turizm Bakanlığı, the Turkish Ministry of Culture and Tourism. Publishes border entry and exit statistics (ktb_border), which the API serves as /v1/border/arrivals and the tr.border.arrivals.* series.

GACC¶

China's General Administration of Customs. It publishes China's monthly trade by partner. The service uses it for China's exports to Russia, which after 2024-12 are available by HS chapter (2 digits) only.

Other source names¶

Name	What it is
Comtrade	The UN's international trade statistics database, source of the mirror data
TOBB	Union of Chambers and Commodity Exchanges of Türkiye; statistics on companies founded, including foreign-capital companies
EPDK	Turkish Energy Market Regulatory Authority; gas and oil import statistics
CREA	Centre for Research on Energy and Clean Air; tracks fossil fuel exports
DHMI	Turkish State Airports Authority (Devlet Hava Meydanları İşletmesi); airport statistics
ENTSOG	European network of gas transmission operators; gas flows at interconnection points
FNS	Russian Federal Tax Service; origin of the company registry
Minfin	Russian Ministry of Finance; budget, fiscal rule and NWF data
BIS	Depends on context: the Bank for International Settlements (policy-rate series named "BIS, monthly") or the US Bureau of Industry and Security (CHP list, Entity List)
OFZ	Russian federal government bonds; `ru.ofz.*` are yields
RUONIA	The Ruble Overnight Index Average, Russia's overnight reference rate

API terms¶

as_of and fetched_at¶

Two dates on every source in meta.sources. as_of is the newest data date in the response, the period the numbers are about. fetched_at is when the service last refreshed that source successfully. A recent fetched_at with an older as_of is normal for monthly data. Details: Responses and sources.

Series id¶

The dotted name of one time series (ru.key_rate). See Series ids and units.

Truncated¶

truncated: true in a response: a row cap cut the result and row_count is less than what matched. Narrow the request.

MCP¶

The Model Context Protocol: an open standard that lets AI assistants call tools offered by a server. The TRRU MCP server at https://trru.atapinar.com/mcp exposes the same data as the REST API as tools such as latest, get_series and product_check. It uses the same API key.

Bearer token¶

A credential sent in the Authorization: Bearer <token> header. Whoever holds the token can use it, so treat it as a password. In TRRU the token is your API key. See Authentication.

Scope¶

The permission level attached to a key: data (all read access) or admin (also company contact details and the SQL tool over MCP).