# List / search Romanian counties (județe)

The 41 counties + Bucharest, with slug, plate code (e.g. "CJ"), ANAF and SIRUTA codes. No filters returns the full list; "q" is a fuzzy, diacritics-insensitive name match. Free of charge.

- REST: `GET https://api.datero.ro/v1/counties`
- Tool MCP: `search_counties` (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 | County name, fuzzy (e.g. "cluj", "Bucuresti"). |
| `id` | query | string | nu | Exact ids, comma-separated. |
| `limit` | query | string | nu | 1–100, default 50. |
| `offset` | query | string | nu | 0–999999, default 0. |

## Exemplu: Căutare județ după nume

Match fuzzy, fără diacritice — "cluj" găsește județul CLUJ.

```bash
curl "https://api.datero.ro/v1/counties?q=cluj"
```

Răspuns:

```json
{
  "totalCount": 1,
  "limit": 50,
  "offset": 0,
  "items": [
    {
      "id": 12,
      "name": "CLUJ",
      "slug": "cluj",
      "shortCode": "CJ",
      "anafCode": 12,
      "sirutaCode": 13
    }
  ]
}
```

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