API Coduri CAEN Rev.3

Nomenclatorul CAEN complet, în versiunea Rev.3 (în vigoare din 1 ianuarie 2025): căutare după denumire sau cod, ierarhia secțiune → diviziune → grupă → clasă și conversia vechilor coduri Rev.2. Răspunsuri JSON, gratuit.

Gratuit
Funcționează fără cheie API
JSON / HTTPS
OpenAPI 3.1

Obține o cheie API gratuită Documentație API

Terminal — încearcă fără cheie API

$ curl "https://api.datero.ro/v1/caen-codes?q=software&limit=3"

{
  "totalCount": 3,
  "items": [
    { "code": "582",  "name": "Activități de editare a produselor software",
      "type": "group", "parentCode": "58" },
    { "code": "5829", "name": "Activități de editare a altor produse software",
      "type": "class", "parentCode": "582" },
    { "code": "6210", "name": "Activități de realizare a softului la comandă
      (software orientat client)", "type": "class", "parentCode": "621" }
  ]
}

Endpoint-uri

GET /v1/caen-codes

Caută în nomenclatorul CAEN

Fără filtre returnează tot nomenclatorul, paginat. Filtrele se combină cu AND.

Parametri pentru /v1/caen-codes
Parametru	Tip	Descriere
`q`	string	Text liber în denumire (insensibil la diacritice) sau prefix de cod. Ex: "software", "62".
`code`	string	Coduri exacte, separate prin virgulă. Ex: code=6210,6220.
`type`	string	Nivel ierarhic: section, division, group sau class.
`parent`	string	Codul părintelui — returnează copiii direcți. Ex: parent=J, parent=62.
`limit`	integer	1–100, implicit 50.
`offset`	integer	Pentru paginare, implicit 0.

Exemplu — cURL

curl "https://api.datero.ro/v1/caen-codes?parent=62"

Răspuns — copiii direcți ai diviziunii 62

{
  "totalCount": 3,
  "limit": 50,
  "offset": 0,
  "items": [
    { "code": "621", "name": "Activități de programare",
      "type": "group", "parentCode": "62" },
    { "code": "622", "name": "Activități de consultanță în tehnologia informației …",
      "type": "group", "parentCode": "62" },
    { "code": "629", "name": "Alte activități de servicii privind tehnologia informației",
      "type": "group", "parentCode": "62" }
  ]
}

GET /v1/caen-codes/{cod}

Detaliul unui cod CAEN, cu ierarhie și echivalențe Rev.2

Acceptă litera unei secțiuni (J) sau un cod de 2–4 cifre. Răspunsul include lanțul complet de părinți (secțiunea prima), copiii direcți și codurile Rev.2 absorbite de acest cod.

Parametri pentru /v1/caen-codes/{cod}
Parametru	Tip	Descriere
`cod` obligatoriu	string	Cod CAEN: literă de secțiune ("J") sau 2–4 cifre ("62", "620", "6210").

Exemplu — cURL

curl "https://api.datero.ro/v1/caen-codes/6210"

Răspuns

{
  "code": "6210",
  "name": "Activități de realizare a softului la comandă (software orientat client)",
  "type": "class",
  "parentCode": "621",
  "parents": [
    { "code": "K",   "name": "Telecomunicații; activități de programare …", "type": "section" },
    { "code": "62",  "name": "Activități de programare și …",               "type": "division" },
    { "code": "621", "name": "Activități de programare",                    "type": "group" }
  ],
  "children": [],
  "replacesRev2Codes": ["6201"]
}

GET /v1/caen-codes/{cod-vechi}

Conversia unui cod CAEN Rev.2 dispărut

Dacă ceri un cod Rev.2 care nu mai există în Rev.3 (de exemplu 6201 — fostul cod pentru dezvoltare software), primești 404 împreună cu succesorii lui Rev.3 — exact ce ai nevoie ca să migrezi datele vechi.

Exemplu — cURL

curl "https://api.datero.ro/v1/caen-codes/6201"

Răspuns — 404 cu indicarea succesorilor

HTTP/2 404
{
  "type": "about:blank",
  "title": "Not found",
  "status": 404,
  "detail": "CAEN \"6201\" is a Rev.2 code replaced in Rev.3 (since 2025-01-01); use: 6210"
}

Bine de știut

Gratuit, cu sau fără cheie. Endpoint-urile CAEN nu consumă credite. Fără autentificare se aplică o limită de rată per IP; cu o cheie API gratuită limita devine dedicată contului tău (nu partajată per IP) și primești acces și la datele de firme.
Sursa. Nomenclatorul oficial CAEN Rev.3 (Ordin INS 377/2024), cu maparea oficială Rev.2 → Rev.3.
Firme după cod CAEN. Caută companiile care activează într-un domeniu cu GET /v1/companies?naceCode=6210 sau explorează directorul de firme pe domenii.
MCP pentru agenți AI. Aceleași operații sunt disponibile ca tool-uri MCP (search_caen_codes, get_caen_code) la https://api.datero.ro/mcp.

Întrebări frecvente

Ce este CAEN Rev.3 și de când se aplică?

CAEN Rev.3 este clasificarea oficială a activităților economice din România (Ordin INS 377/2024), în vigoare de la 1 ianuarie 2025. Înlocuiește CAEN Rev.2; multe coduri vechi au fost redenumite, comasate sau împărțite.

Cum convertesc un cod CAEN vechi (Rev.2) în noul Rev.3?

Cere codul vechi la GET /v1/caen-codes/{cod}. Dacă acel cod a dispărut în Rev.3, răspunsul este 404 și include lista codurilor Rev.3 care îl înlocuiesc. Invers, fiecare cod Rev.3 expune câmpul replacesRev2Codes cu codurile vechi pe care le acoperă.

Cum este structurat nomenclatorul CAEN?

Pe 4 niveluri ierarhice: secțiune (literă A–U), diviziune (2 cifre), grupă (3 cifre) și clasă (4 cifre — codul folosit la înregistrarea firmelor). API-ul expune ierarhia prin câmpurile parentCode, parents și children, iar parametrul parent listează copiii direcți ai oricărui cod.

API-ul de coduri CAEN este gratuit?

Da. Endpoint-urile CAEN sunt gratuite și funcționează și fără cheie API (cu limită de rată per IP). Cu o cheie API gratuită limita e dedicată contului tău, iar accesul la restul API-urilor Datero e inclus.

Căutarea ține cont de diacritice?

Nu e nevoie de diacritice: căutarea după denumire este insensibilă la diacritice ("constructii" găsește "construcții"). Poți căuta și după prefix de cod, de exemplu q=62.

API Coduri CAEN Rev.3

Endpoint-uri

Caută în nomenclatorul CAEN

Detaliul unui cod CAEN, cu ierarhie și echivalențe Rev.2

Conversia unui cod CAEN Rev.2 dispărut

Bine de știut

Întrebări frecvente

Alte API-uri Datero

API Date firme

API Județe și localități

API Curs valutar BNR