Skip to content
Developers

CAEN data, one API call away.

A free, read-only JSON API for the CAEN Rev. 3 nomenclature, with bilingual content, related codes and Rev. 2 conversions.

No API key required 60 requests/minute/IP ETag / 304 JSON + OpenAPI

Search & lookup

Find codes by number or text, with diacritics normalization and fuzzy matching.

Rev. 2 conversions

Map old codes to the new structure, including partial and multiple correspondences.

Bilingual content

RO and EN descriptions, activities, FAQ, related codes and metadata in one response.

Endpoints

Method Path Description
GET /api/v1 API metadata
GET /api/v1/codes/{code} Full code details
GET /api/v1/search?q=...&rev=3 Search by code or text
GET /api/v1/sections All A–V sections
GET /api/v1/conversions/{rev2} Rev. 2 correspondences
GET /api/v1/openapi.yaml OpenAPI 3.0

Quick start

Fetch a code or search the nomenclature.


curl -H "Accept: application/json" \
  https://cecaen.ro/api/v1/codes/0113

curl -G -H "Accept: application/json" \
  --data-urlencode "q=constructii" \
  https://cecaen.ro/api/v1/search

use Illuminate\Support\Facades\Http;

$response = Http::withHeaders(['Accept' => 'application/json'])
    ->get('https://cecaen.ro/api/v1/search', [
        'q' => 'constructii',
        'per_page' => 20,
    ]);

$data = $response->json();

const response = await fetch(
  'https://cecaen.ro/api/v1/codes/0113',
  { headers: { Accept: 'application/json' } }
);

const { data, conversions } = await response.json();
console.log(data.code, data.description.en);

Caching & fields

  • • Every GET response includes an ETag; send If-None-Match to get 304.
  • • ?fields=code,name,url limits the payload.
  • • Cache-Control: public, max-age=60.

Usage & integrations

The public API is free for reasonable use. For ERP integrations, bulk migration, white-label data feeds or higher limits, contact us.

Contact for API access
Need bulk conversion? Use the Rev. 2 → Rev. 3 converter or the OpenAPI specification.