oneapi
Sign in
Business v1 / Nomenclatoare

CAEN code detail

One NACE code with its parent hierarchy (names), the explanatory notes (includes/excludes) and the number of companies that hold it as their main code. ?versiune=2|3 (3 by default).

GET
https://oneapi.ro/api/business/v1/caen/{cod}

Path parameters

NameTypeDescriptionExample
codrequired string NACE Rev. 2 (CAEN) code, four digits (e.g. 6201).

Query parameters

NameTypeDescriptionAccepted values
versiuneoptional string | null 0|1|2|3. Defaults to 3. 0123

How it behaves

  • A CAEN code with the parent names (section, division, group), the explanatory notes (include/exclude) and the number of companies that have it as their primary CAEN. ?versiune= selects the edition.

What it is for

  • Showing a code's name and hierarchy next to a company profile.
  • Checking, through the include/exclude notes, whether a code covers your activity.
  • Estimating a sector's size from the number of companies declaring it.

Response structure

All fields below live inside data.

FieldTypeDescription
cod string The code.
denumire string | null The name.
versiune string The nomenclature revision.
nivel string The level in the hierarchy (section, division, group, class).
ierarhie.sectiune.cod string The code.
ierarhie.sectiune.denumire string | null The name.
ierarhie.diviziune.cod string The code.
ierarhie.diviziune.denumire string | null The name.
ierarhie.grupa.cod string The code.
ierarhie.grupa.denumire string | null The name.
note.include string What the activity includes, from the CAEN explanatory notes.opțional
note.include_de_asemenea string What else it includes, from the CAEN explanatory notes.opțional
note.exclude string What it does NOT include, from the CAEN explanatory notes.opțional
nr_firme integer | null The companies whose primary activity falls under the code, across all revisions companies carry (62 also counts those in 6201, 6202…).

Response examples

GEThttps://oneapi.ro/api/business/v1/caen/6201
{
    "data": {
        "cod": "6201",
        "denumire": "Activități de realizare a soft-ului la comandă (software orientat client)",
        "versiune": "CAEN Rev.2",
        "nivel": "clasa",
        "ierarhie": {
            "sectiune": {
                "cod": "J",
                "denumire": "INFORMAŢII ŞI COMUNICAŢII"
            },
            "diviziune": {
                "cod": "62",
                "denumire": "Activități de servicii în tehnologia informației"
            },
            "grupa": {
                "cod": "620",
                "denumire": "Activități de servicii în tehnologia informației"
            }
        },
        "note": [],
        "nr_firme": 65600
    }
}

Error codes

CodeSlugWhen it occurs
401neautentificatToken missing, invalid, expired or revoked.
403feature_indisponibilThe current plan does not include the feature the route depends on.
404negasitThe code does not exist in the requested version.
422validareA parameter failed validation (versiune); 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 (versiune); detalii says which and why.",
        "detalii": {
            "cod": [
                "The value sent does not satisfy the parameter rule."
            ]
        }
    }
}