Financiar v1 / Serii

NBR statistical classes

The classes the series come from, with the number of series, the total number of values and each one's coverage. Useful as a starting point: you pick a class, then filter the catalogue on it.

GET

https://oneapi.ro/api/financiar/v1/clase

Query parameters

NameTypeDescriptionAccepted values

cautaoptional string | null Text in the class name, at least 2 characters. Diacritic-insensitive. e.g. Cluje.g. credit

How it behaves

The classes the series come from, with the number of series, the total number of values and the time coverage of each.
It is the natural starting point: pick a class, then filter the catalogue on it with /serii?clasa=.
Search ignores diacritics: ?cauta=dobanzi finds "Ratele dobânzilor BNR".
The counts cover time series only; registers are not included, as in the catalogue.

What it is for

Browsing the central bank catalogue by class, in a picker.
Estimating how much each class covers, before integrating.
The starting point for finding the series code you need.

Response structure

FieldTypeDescription

data.clase[] object[]

meta[] string[] The response envelope: the source, the freshness and the notes that go with the data.

data.clase[].clasa string The class name, exactly as the NBR publishes it.

data.clase[].serii integer How many time series the class holds. Registers are NOT counted here.

data.clase[].valori integer How many observations the class's series add up to.

data.clase[].prima_data string The earliest observation in the class. null for classes without values.

data.clase[].ultima_data string The latest observation in the class. null for classes without values.

Response examples

GEThttps://oneapi.ro/api/financiar/v1/clase

{
    "data": {
        "clase": [
            {
                "clasa": "Arhivă a cursului de schimb (ROL) - serii anuale",
                "serii": 2,
                "valori": 28,
                "prima_data": "1985-01-01",
                "ultima_data": "2005-01-01"
            }
        ]
    },
    "meta": {
        "clase": 105,
        "sursa": "Banca Naţională a României — baza de date interactivă.",
        "nota": "Numărul de serii şi de valori acoperă doar seriile temporale; registrele nu sunt incluse."
    }
}

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

{
    "data": {
        "clase": []
    },
    "meta": {
        "clase": 0,
        "sursa": "Banca Naţională a României — baza de date interactivă.",
        "cauta": "Cluj",
        "nota": "Numărul de serii şi de valori acoperă doar seriile temporale; registrele nu sunt incluse."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/clase?cauta=credit

{
    "data": {
        "clase": [
            {
                "clasa": "Centrala Riscului de Credit - Credite acordate de IFN, instituţiile emitente de monedă electronică (IEME) şi instituţiile de plată (IP)",
                "serii": 45,
                "valori": 7125,
                "prima_data": "2009-12-01",
                "ultima_data": "2026-07-01"
            }
        ]
    },
    "meta": {
        "clase": 30,
        "sursa": "Banca Naţională a României — baza de date interactivă.",
        "cauta": "credit",
        "nota": "Numărul de serii şi de valori acoperă doar seriile temporale; registrele nu sunt incluse."
    }
}

Error codes

Code	Slug	When it occurs
401	neautentificat	Missing or invalid token.
403	feature_indisponibil	`financiar.serii` is not in the current plan.
422	validare	A parameter failed validation (`cauta`); `detalii` says which and why.
429	cota_depasita	The plan's rate limit or quota has been exceeded.

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 (cauta); detalii says which and why.",
        "detalii": {
            "cauta": [
                "The value sent does not satisfy the parameter rule."
            ]
        }
    }
}