Locations v1 / Referință & business

Primăria unui UAT

CUI-ul primăriei + reședința pentru un UAT (cod_siruta).

GET

https://oneapi.ro/api/locations/v1/uat/{cod}/primarie

Parametri de cale

NumeTipDescriereExemplu

codobligatoriu string Codul SIRUTA al unităţii administrativ-teritoriale (ex. 54975 pentru Cluj-Napoca).

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

CUI-ul cunoscut pentru ~89% dintre UAT-uri; altfel 404.

La ce folosește

Obținerea CUI-ului primăriei pentru emiterea de facturi către administrația locală
Pre-completarea datelor de facturare la contractare cu un UAT
Verificarea existenței unei primării cunoscute pentru un UAT dat

Structura răspunsului

CâmpTipDescriere

data.cui string Codul fiscal (CUI) al primăriei.

data.uat object UAT-ul deservit: cod_siruta, nume, tip.

data.uat.cod_siruta integer Codul SIRUTA al UAT-ului — chainable spre /uat/{cod}.

data.uat.nume string Denumirea UAT-ului.

data.uat.tip string Tipul UAT-ului (municipiu/oraș/comună).

data.judet.cod string Indicativul auto al județului.

data.judet.nume string Numele județului.

data.resedinta string | null Reședința UAT-ului.

meta.actualizat object Prospețimea datelor pe domenii (dată ISO 8601).

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/uat/2915/primarie

{
    "data": {
        "cui": "4561898",
        "uat": {
            "cod_siruta": 2915,
            "nume": "Baia de Arieș",
            "tip": "oras"
        },
        "judet": {
            "cod": "AB",
            "nume": "Alba"
        },
        "resedinta": "Baia de Arieș"
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/uat/CJ/primarie

{
    "data": null,
    "meta": {
        "fara_date": "Primăria UAT-ului [CJ] nu e cunoscută.",
        "fara_date_cod": "fara_potrivire"
    }
}

GEThttps://oneapi.ro/api/locations/v1/uat/54975/primarie

{
    "data": {
        "cui": "4305857",
        "uat": {
            "cod_siruta": 54975,
            "nume": "Cluj-Napoca",
            "tip": "municipiu"
        },
        "judet": {
            "cod": "CJ",
            "nume": "Cluj"
        },
        "resedinta": "Cluj-Napoca"
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00"
        }
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	feature_indisponibil	Planul curent nu include funcţia de care ţine ruta.
404	negasit	CUI-ul UAT-ului nu e cunoscut.
429	cota_depasita	Cota lunară a planului a fost depăşită (vezi `Retry-After`).

Toate erorile au aceeași formă. eroare.cod e stabil și e cel după care trebuie să ramifici în cod — nu după textul din mesaj, care se poate schimba.

{
    "eroare": {
        "cod": "negasit",
        "mesaj": "CUI-ul UAT-ului nu e cunoscut."
    }
}