Financiar v1 / Inflatie

ECOICOP categories

The code list of consumption categories used by the HICP, filterable by code prefix or by text in the name. Every code comes with its classification and version.

GET

https://oneapi.ro/api/financiar/v1/hicp/categorii

Query parameters

NameTypeDescriptionAccepted values

prefixoptional string | null Optional. A piece of an ECOICOP code, e.g. CP01. e.g. CP01

cautaoptional string | null Optional. Text searched in the name, at least 2 characters. Names are in English, as published by Eurostat (bread). max 60 car.

How it behaves

The nomenclature of consumption categories used by HICP, filterable by code prefix or by text in the name.
Every code comes with its classification and version, for the same reason as in the value series: the code alone does not stably identify a category across versions of the classification.
The prefix filter is useful for descending the hierarchy: CP01 returns the food category and all its subdivisions.

What it is for

Finding a category code before requesting the series.
Populating a category selection list.

Response structure

FieldTypeDescription

data.categorii[] object[] Available categories.

meta.categorii integer Available categories.

meta.sursa string The official source the data comes from, with its licence where one is required.

meta.nota string A note on how to read the response — a pitfall, a convention or a limit of the source.

data.categorii[].cod string The ECOICOP code. ⚠️ On its own it does NOT identify a category stably — the same code may mean something else in another version.

data.categorii[].denumire string The Eurostat name, in English (the nomenclature is not translated at source).

data.categorii[].clasificare string The classification the code comes from, usually ecoicop.

data.categorii[].versiune string The classification version. Sent together with the code, here and in the value series.

Response examples

GEThttps://oneapi.ro/api/financiar/v1/hicp/categorii?per_pagina=3

{
    "data": {
        "categorii": [
            {
                "cod": "AP",
                "denumire": "Administered prices",
                "clasificare": "ecoicop",
                "versiune": "2"
            }
        ]
    },
    "meta": {
        "categorii": 555,
        "sursa": "Eurostat — nomenclatorul ECOICOP.",
        "nota": "Codul singur nu identifică stabil o categorie: acelaşi cod poate desemna altceva în versiuni diferite ale clasificării. De aceea `clasificare` şi `versiune` însoţesc mereu codul, aici şi în seria de valori."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/hicp/categorii?per_pagina=3&cauta=bread

{
    "data": {
        "categorii": [
            {
                "cod": "CP01113",
                "denumire": "Bread and bakery products (ND)",
                "clasificare": "ecoicop",
                "versiune": "2"
            }
        ]
    },
    "meta": {
        "categorii": 2,
        "sursa": "Eurostat — nomenclatorul ECOICOP.",
        "nota": "Codul singur nu identifică stabil o categorie: acelaşi cod poate desemna altceva în versiuni diferite ale clasificării. De aceea `clasificare` şi `versiune` însoţesc mereu codul, aici şi în seria de valori."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/hicp/categorii?cauta=Cluj

{
    "data": {
        "categorii": []
    },
    "meta": {
        "categorii": 0,
        "sursa": "Eurostat — nomenclatorul ECOICOP.",
        "nota": "Codul singur nu identifică stabil o categorie: acelaşi cod poate desemna altceva în versiuni diferite ale clasificării. De aceea `clasificare` şi `versiune` însoţesc mereu codul, aici şi în seria de valori."
    }
}

Error codes

Code	Slug	When it occurs
401	neautentificat	Token missing, invalid, expired or revoked.
403	feature_indisponibil	The current plan does not include the feature the route depends on.
422	validare	Malformed prefix or search text too short.
429	cota_depasita	The 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": "Malformed prefix or search text too short.",
        "detalii": {
            "prefix": [
                "The value sent does not satisfy the parameter rule."
            ]
        }
    }
}