# Search the CAEN Rev.3 classification

Official Romanian CAEN Rev.3 activity classification (in force since 2025-01-01), hierarchical: section (letter A–U) → division (2 digits) → group (3) → class (4). No filters returns the whole nomenclature, paginated. Free of charge.

- REST: `GET https://api.datero.ro/v1/caen-codes`
- Tool MCP: `search_caen_codes` (endpoint: https://api.datero.ro/mcp)
- Cost: gratuit (0 credite)
- Autentificare: opțională — funcționează și fără cheie (doar rate-limited)

## Parametri

| Nume | În | Tip | Obligatoriu | Descriere |
| --- | --- | --- | --- | --- |
| `q` | query | string | nu | Free text (activity name, diacritics-insensitive) or a code prefix. |
| `code` | query | string | nu | Exact codes, comma-separated, e.g. "6210,6220". |
| `type` | query | string | nu | Hierarchy level: "section", "division", "group" or "class". |
| `parent` | query | string | nu | Parent code — returns its direct children, e.g. "J", "62", "620". |
| `limit` | query | string | nu | 1–100, default 50. |
| `offset` | query | string | nu | 0–999999, default 0. |

## Exemplu: Căutare după denumirea activității

Full-text, fără diacritice — găsește grupa și clasele "software".

```bash
curl "https://api.datero.ro/v1/caen-codes?q=software&limit=2"
```

Răspuns:

```json
{
  "totalCount": 3,
  "limit": 2,
  "offset": 0,
  "items": [
    {
      "code": "582",
      "name": "Activități de editare a produselor software",
      "type": "group",
      "description": null,
      "parentCode": "58"
    },
    {
      "code": "5829",
      "name": "Activități de editare a altor produse software",
      "type": "class",
      "description": null,
      "parentCode": "582"
    }
  ]
}
```

## Exemplu: Copiii direcți ai unei diviziuni

parent="62" listează grupele diviziunii 62.

```bash
curl "https://api.datero.ro/v1/caen-codes?parent=62&type=group"
```

Răspuns:

```json
{
  "totalCount": 3,
  "limit": 50,
  "offset": 0,
  "items": [
    {
      "code": "621",
      "name": "Activități de programare",
      "type": "group",
      "description": null,
      "parentCode": "62"
    },
    {
      "code": "622",
      "name": "Activități de consultanță în tehnologia informației și de management (gestiune și exploatare) al mijloacelor de calcul",
      "type": "group",
      "description": null,
      "parentCode": "62"
    },
    {
      "code": "629",
      "name": "Alte activități de servicii privind tehnologia informației",
      "type": "group",
      "description": null,
      "parentCode": "62"
    }
  ]
}
```

Documentație completă: https://datero.ro/docs/api/caen/search · OpenAPI: https://api.datero.ro/openapi.json