Location Active
Address API
Access comprehensive Romanian address data including counties (județe), cities (localități), streets (artere), and postal codes. Parse and normalize Romanian addresses with intelligent parsing. Updated daily from official government sources for maximum accuracy.
https://address.localapi.ro < 100ms Response Time
1/sec Rate Limit
None Auth Required
Free Pricing
Quick Start
Request
# List all counties
curl "https://address.localapi.ro/judete/"
# Get localities in a county (with optional filter)
curl "https://address.localapi.ro/judete/40/localitati/?q=6" Request
import requests
# List all counties
response = requests.get("https://address.localapi.ro/judete/")
judete = response.json()
for judet in judete['judete']:
print(f"{judet['denumire']} ({judet['auto']})")
# Get localities in a county
response = requests.get(
"https://address.localapi.ro/judete/40/localitati/",
params={"q": "sector"}
)
for loc in response.json()['localitati']:
print(f"{loc['denumire_completa']} (SIRUTA: {loc['siruta']})") Request
// List all counties
const response = await fetch("https://address.localapi.ro/judete/");
const data = await response.json();
data.judete.forEach(judet => {
console.log(`${judet.denumire} (${judet.auto})`);
});
// Get localities in a county
const locResponse = await fetch(
"https://address.localapi.ro/judete/40/localitati/?q=sector"
);
const locData = await locResponse.json();
locData.localitati.forEach(loc => {
console.log(`${loc.denumire_completa} (SIRUTA: ${loc.siruta})`);
});Response
200 OK application/json
{
"judete": [
{ "denumire": "Alba", "siruta": "10001", "cod_jud": "1", "auto": "AB" },
{ "denumire": "Arad", "siruta": "20001", "cod_jud": "2", "auto": "AR" },
{ "denumire": "București", "siruta": "403", "cod_jud": "40", "auto": "B" }
]
}Available Endpoints
POST
/adresa/ Parse and normalize a Romanian address string.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
adresa | string | Yes | Address to parse (4-200 characters) |
POST
/cauta-localitate/ Search for localities matching an address fragment.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
adresa | string | Yes | Locality search text (4-50 characters) |
GET
/judete/ List all Romanian counties (județe).
GET
/judete/{cod_jud}/ Get details for a specific county.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
cod_jud | string | Yes | County code (e.g., "40" for București) |
GET
/judete/{cod_jud}/localitati/ List localities in a county.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
cod_jud | string | Yes | County code |
q | string | No | Filter text (min 1 character) |
GET
/judete/{cod_jud}/localitati/{cod_loc}/ Get details for a specific locality.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
cod_jud | string | Yes | County code |
cod_loc | string | Yes | Locality code |
GET
/judete/{cod_jud}/localitati/{cod_loc}/artere/ List streets in a locality.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
cod_jud | string | Yes | County code |
cod_loc | string | Yes | Locality code |
q | string | No | Filter text (min 1 character) |
GET
/judete/{cod_jud}/localitati/{cod_loc}/artere/{cod_art}/ Get details for a specific street, including postal codes.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
cod_jud | string | Yes | County code |
cod_loc | string | Yes | Locality code |
cod_art | string | Yes | Street code |
GET
/siruta/{cod}/ Get locality details by SIRUTA code.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
cod | string | Yes | SIRUTA code |
Error Codes
| Code | Description |
|---|---|
400 | Bad request - address could not be parsed |
422 | Validation error - invalid parameters |
429 | Rate limit exceeded |
500 | Internal server error |