API Județe și localități din România

Nomenclatorul administrativ complet: 42 de județe și toate localitățile — municipii, orașe, comune, sate și sectoarele Bucureștiului — cu slug-uri normalizate, coduri ANAF și coduri SIRUTA. Ideal pentru validare de adrese, formulare și e-Factura.

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/counties?q=cluj"

{
  "totalCount": 1,
  "items": [
    {
      "id": 12,
      "name": "CLUJ",
      "slug": "cluj",
      "shortCode": "CJ",
      "anafCode": 12,
      "sirutaCode": 13
    }
  ]
}

Endpoint-uri

GET /v1/counties

Listă și căutare județe

Cele 41 de județe plus București. Fără filtre returnează lista completă. Căutarea după nume e fuzzy și insensibilă la diacritice.

Parametri pentru /v1/counties
Parametru	Tip	Descriere
`q`	string	Nume județ, fuzzy. Ex: "cluj", "Bucuresti".
`id`	string	Id-uri exacte, separate prin virgulă. Ex: id=12,40.
`limit`	integer	1–100, implicit 50.
`offset`	integer	Pentru paginare, implicit 0.

Exemplu — cURL

curl "https://api.datero.ro/v1/counties?limit=3"

Răspuns

{
  "totalCount": 42,
  "limit": 3,
  "offset": 0,
  "items": [
    { "id": 1, "name": "ALBA",  "slug": "alba",  "shortCode": "AB", "anafCode": 1, "sirutaCode": 1 },
    { "id": 2, "name": "ARAD",  "slug": "arad",  "shortCode": "AR", "anafCode": 2, "sirutaCode": 2 },
    { "id": 3, "name": "ARGEŞ", "slug": "arges", "shortCode": "AG", "anafCode": 3, "sirutaCode": 3 }
  ]
}

GET /v1/cities

Căutare localități

Toate localitățile, cu tipul lor (municipality, city, commune, village, sector, locality), județul părinte și codurile oficiale.

Parametri pentru /v1/cities
Parametru	Tip	Descriere
`q`	string	Nume localitate, fuzzy, fără diacritice necesare. Ex: "cluj napoca".
`county`	string	Filtru pe id-uri de județ (din /v1/counties), separate prin virgulă. Ex: county=12.
`id`	string	Id-uri exacte, separate prin virgulă.
`limit`	integer	1–100, implicit 25.
`offset`	integer	Pentru paginare, implicit 0.

Exemplu — cURL

curl "https://api.datero.ro/v1/cities?q=turda&county=12"

Răspuns — căutare în interiorul județului Cluj

{
  "totalCount": 1,
  "limit": 25,
  "offset": 0,
  "items": [
    {
      "id": 467,
      "name": "Turda",
      "slug": "turda",
      "type": "municipality",
      "countyId": 12,
      "countyName": "CLUJ",
      "countyCode": "CJ",
      "anafCode": 452,
      "sirutaCode": 55259
    }
  ]
}

Bine de știut

Gratuit, cu sau fără cheie. Endpoint-urile de localități 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.
Coduri oficiale incluse. Fiecare entitate vine cu codul SIRUTA (nomenclatorul INS) și codul ANAF — exact identificatorii ceruți de e-Factura, declarații și schimburi de date cu instituțiile publice.
Firme pe județe. Combină cu API-ul de companii: GET /v1/companies?county=Cluj sau explorează directorul de firme pe județe.
MCP pentru agenți AI. Aceleași operații sunt disponibile ca tool-uri MCP (search_counties, search_cities) la https://api.datero.ro/mcp.

Întrebări frecvente

Ce localități acoperă API-ul?

Toate unitățile administrative din România: municipii, orașe, comune, sate și sectoarele Bucureștiului. Fiecare localitate are tipul ei (municipality, city, commune, village, sector, locality), județul părinte și slug normalizat, fără diacritice.

Ce sunt codurile SIRUTA și ANAF din răspunsuri?

SIRUTA este nomenclatorul oficial INS al unităților administrativ-teritoriale — codul standard folosit în statistică și în schimburile de date cu instituțiile. Codul ANAF este identificatorul folosit de sistemele ANAF (de exemplu în e-Factura și declarații). Ambele sunt incluse pentru fiecare județ și localitate.

Cum filtrez localitățile unui județ?

Cu parametrul county, folosind id-ul județului din /v1/counties: GET /v1/cities?county=12 returnează localitățile din Cluj. Poți combina cu q pentru căutare după nume în interiorul județului.

Cum sunt tratate sectoarele Bucureștiului?

Sectoarele 1–6 sunt localități de tip "sector" în județul București. Util pentru validarea adreselor și pentru e-Factura, unde Bucureștiul trebuie exprimat ca SECTOR1–SECTOR6.

API-ul de localități este gratuit?

Da. Endpoint-urile de județe și localități 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.

API Județe și localități din România

Endpoint-uri

Listă și căutare județe

Căutare localități

Bine de știut

Întrebări frecvente

Alte API-uri Datero

API Date firme

API Coduri CAEN

API Curs valutar BNR