Business v1 / Nomenclatoare

Financial indicators

The dictionary of balance-sheet lines: what each code in the financial statements means, by family and by year, because the forms changed over time.

GET

https://oneapi.ro/api/business/v1/indicatori-financiari

Query parameters

NameTypeDescriptionAccepted values

anoptional integer | null The financial year, to see the indicators published for it. e.g. 2023e.g. 2022

familieoptional string | null Reporting family (web, webbanci, webasig…). Specialised families publish every indicator; web omits the null ones. e.g. webasig

How it behaves

The dictionary of financial indicators (the "I1…In" balance-sheet codes and their friendly names, per family and year) — the reference by which /firme/{cui}/financiar is decoded.

What it is for

Decoding balance-sheet codes into names when displaying financial statements.
Building your own derived indicators, knowing what each code represents.
The reference for reading the response from /firme/{cui}/financiar.

Response structure

All fields below live inside data[].

FieldTypeDescription

familie string The family of financial indicators.

an integer The reference year.

cod string The code.

denumire string The name.

ordine integer Display order.

Response examples

GEThttps://oneapi.ro/api/business/v1/indicatori-financiari?an=2023

{
    "data": [
        {
            "familie": "webasig",
            "an": 2023,
            "cod": "I1",
            "denumire": "Imobilizari necorporale",
            "ordine": 1
        }
    ]
}

GEThttps://oneapi.ro/api/business/v1/indicatori-financiari?an=2022

{
    "data": [
        {
            "familie": "webasig",
            "an": 2022,
            "cod": "I1",
            "denumire": "Imobilizari necorporale",
            "ordine": 1
        }
    ]
}

GEThttps://oneapi.ro/api/business/v1/indicatori-financiari?familie=webasig

{
    "data": [
        {
            "familie": "webasig",
            "an": 2008,
            "cod": "I1",
            "denumire": "Asigurari generale",
            "ordine": 1
        }
    ]
}

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	An undeclared parameter or a value that fails validation (`an`, `familie`). The offending field is in `detalii`.
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": "An undeclared parameter or a value that fails validation (an, familie). The offending field is in detalii.",
        "detalii": {
            "an": [
                "The value sent does not satisfy the parameter rule."
            ]
        }
    }
}