Financiar v1 / Meta

Meta / module state

Which datasets the Financiar module holds, how much each one covers and how fresh they are. Lagging states are reported as such (stare: "in_urma"), not hidden.

GET

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

Query parameters

This route accepts no query parameters.

How it behaves

Which datasets the Financiar module holds, how much each covers, and how fresh it is.
Lagging states are reported as such (stare: "in_urma"). A dataset that no longer receives new data at the source appears with stare: "incheiata", not as an error.
The route requires no plan feature: it is a discovery route, and if it were gated by plan, a client could not find out what the module contains before buying.

What it is for

Checking freshness before building on a particular series.
Discovering the available datasets and the range each covers.

Response structure

FieldTypeDescription

data.modul string

data.versiune string Version of the dataset or artefact the values come from.

data.seturi[] object[]

meta.generat_la string When the response was built (ISO 8601).

data.seturi[].cod string The stable identifier of the dataset (curs_bnr, hicp, …). It does not change after publication.

data.seturi[].sursa string The authority publishing the data, as it should be cited.

data.seturi[].acoperire object The first and last period for which data exists.

data.seturi[].entitati integer How many distinct things the dataset covers: currencies, series, categories.

data.seturi[].valori integer How many observations are stored.

data.seturi[].stare string curenta = up to date; in_urma = the source has published more recently than we hold; incheiata = the series receives no new data.

Response examples

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

{
    "data": {
        "modul": "financiar",
        "versiune": "v1",
        "seturi": [
            {
                "cod": "curs_bnr",
                "nume": "Curs de schimb BNR",
                "sursa": "Banca Naţională a României",
                "periodicitate": "zilnic",
                "acoperire": {
                    "de_la": "2005-01-03",
                    "pana_la": "2026-09-21"
                },
                "entitati": 40,
                "valori": 160124,
                "stare": "in_urma"
            }
        ]
    },
    "meta": {
        "generat_la": "2026-10-07T01: 57: 56+03: 00"
    }
}

Error codes

Code	Slug	When it occurs
401	neautentificat	Missing or invalid token. This is the module's only route without a feature requirement, so a valid token sees it on any plan.
403	modul_interzis	The token has no access to the route's module.
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": "neautentificat",
        "mesaj": "Missing or invalid token. This is the module's only route without a feature requirement, so a valid token sees it on any plan."
    }
}