oneapi
Sign in
Financiar v1 / Inflatie

Nomenclature of partner countries

The 249 countries foreign trade is published on, with the group, the flows they appear on and each one's years. The ue group marks the 27 Union countries — the only ones with a product breakdown.

GET
https://oneapi.ro/api/financiar/v1/comert-exterior/tari/nomenclator

Query parameters

NameTypeDescriptionAccepted values
grup_tarioptional string | null toate (default) or ue — the list narrows to member states. The section breakdown exists only for EU countries. toateue

How it behaves

  • The 249 countries external trade is published for, with the group, the flows they appear on and the years of each.
  • The ue group marks the 27 European Union countries — the only ones with a nomenclature-section breakdown. The rest appear with the country total only.
  • ⚠️ This is also where the uneven coverage shows: imports by country of origin stop in 2006, imports by country of dispatch begin there.

What it is for

  • Finding the right slug before requesting the series.
  • Checking the years in which a country actually appears in the data.

Response structure

FieldTypeDescription
data.tari integer Countries covered by the response.
data.pe_grup object How many countries each group holds.
data.pe_grup.toate integer
data.pe_grup.ue integer
data.grupuri.toate[].tara string The country the value refers to.
data.grupuri.toate[].denumire string The name, exactly as the source publishes it.
data.grupuri.toate[].fluxuri array Flow directions for which values exist.
data.grupuri.toate[].de_la integer Start of the covered interval.
data.grupuri.toate[].pana_la integer End of the covered interval, inclusive.
data.grupuri.ue[] array The 27 countries with a product breakdown.
data.grupuri.ue[].tara string The country the value refers to.
data.grupuri.ue[].denumire string The name, exactly as the source publishes it.
data.grupuri.ue[].fluxuri array Flow directions for which values exist.
data.grupuri.ue[].de_la integer Start of the covered interval.
data.grupuri.ue[].pana_la integer End of the covered interval, inclusive.
data.nota string A note on how to read the data — a pitfall, a convention or a limit of the source.
data.nota_concept string
data.nota_coduri string
meta.sursa string The official source the data comes from, with its licence where one is required.
meta.fara_date data is null and this says why. The projection over the INS data is empty.
meta.fara_date_cod The short, STABLE word for the reason, for clients that branch on it in code: fara_date is prose and may be rephrased, this is not.

Response examples

GEThttps://oneapi.ro/api/financiar/v1/comert-exterior/tari/nomenclator
{
    "data": {
        "tari": 277,
        "pe_grup": {
            "toate": 250,
            "ue": 27
        },
        "grupuri": {
            "toate": [
                {
                    "tara": "afganistan",
                    "denumire": "Afganistan",
                    "fluxuri": [
                        "export",
                        "import"
                    ],
                    "de_la": 1991,
                    "pana_la": 2025
                }
            ],
            "ue": [
                {
                    "tara": "austria",
                    "denumire": "Austria",
                    "fluxuri": [
                        "export",
                        "import"
                    ],
                    "de_la": 1991,
                    "pana_la": 2025
                }
            ]
        },
        "nota": "Grupul `toate` are totalul pe ţară parteneră; `ue` are cele 27 de ţări ale Uniunii, singurele cu defalcare pe secţiuni de nomenclator.",
        "nota_concept": "⚠️ La import, ţara parteneră înseamnă **ţara de origine** până în 2006 şi **ţara de expediere** după — pentru schimburile intra-UE. Cele două nu se lipesc.",
        "nota_coduri": "Codul e slugul denumirii de la sursă; nu există un nomenclator ISO în platformă cu care să se poată lega, deci denumirea originală rămâne în `denumire`."
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — nomenclatorul de ţări al matricilor EXP101B, EXP102G, EXP102E, EXP101D şi EXP102C (TEMPO)."
    }
}

Error codes

CodeSlugWhen it occurs
401neautentificatMissing or invalid token.
403feature_indisponibilfinanciar.indici is not in the current plan.
422validareA parameter failed validation (grup_tari); detalii says which and why.
429cota_depasitaThe plan's monthly quota has been exceeded (see Retry-After).

All errors share the same shape. eroare.cod is stable and is the value you should branch on in code — not the text in mesaj, which may change.

{
    "eroare": {
        "cod": "validare",
        "mesaj": "A parameter failed validation (grup_tari); detalii says which and why.",
        "detalii": {
            "grup_tari": [
                "The value sent does not satisfy the parameter rule."
            ]
        }
    }
}