# Search Romanian localities (localități)

Romanian localities — municipalities, towns, communes, villages, Bucharest sectors — with type, county, ANAF and SIRUTA codes. Filter by "q" (name, diacritics-insensitive) and/or "county" (county ids). Free of charge.

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

## Exemplu: Căutare localitate după nume

Răspunsul include tipul localității, județul și codurile ANAF/SIRUTA.

```bash
curl "https://api.datero.ro/v1/cities?q=cluj-napoca&limit=1"
```

Răspuns:

```json
{
  "totalCount": 1,
  "limit": 1,
  "offset": 0,
  "items": [
    {
      "id": 115,
      "name": "Cluj-Napoca",
      "slug": "cluj-napoca",
      "type": "municipality",
      "countyId": 12,
      "countyName": "CLUJ",
      "countyCode": "CJ",
      "anafCode": 103,
      "sirutaCode": 54975
    }
  ]
}
```

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