Locations v1 / Referință & business

Primărie după CUI

Datele primăriei (UAT deservit + reședință) după codul fiscal (CUI).

GET

https://oneapi.ro/api/locations/v1/primarii/{cui}

Parametri de cale

NumeTipDescriereExemplu

cuiobligatoriu string CUI-ul primăriei (al unităţii administrativ-teritoriale ca persoană juridică).

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Reverse lookup exact pe CUI. CUI-ul e cunoscut pentru ~89% dintre UAT-uri (parity cu /uat/{cod}/primarie); restul → 404.

La ce folosește

Reverse lookup de la CUI la UAT-ul deservit, pentru reconcilierea facturilor / plăților
Validarea unui CUI de instituție publică introdus într-un formular
Îmbogățirea unei baze de furnizori publici cu UAT-ul și județul aferent

Structura răspunsului

CâmpTipDescriere

data.cui string Codul fiscal al primăriei.

data.uat object UAT-ul deservit de primărie (cod_siruta, nume, tip) — link în jos.

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 object Județul: indicativ auto + nume.

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/primarii/4561898

{
    "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/primarii/14756536

{
    "data": {
        "cui": "14756536",
        "uat": {
            "cod_siruta": 155243,
            "nume": "Timișoara",
            "tip": "municipiu"
        },
        "judet": {
            "cod": "TM",
            "nume": "Timiș"
        },
        "resedinta": "Timișoara"
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/primarii/4541580

{
    "data": {
        "cui": "4541580",
        "uat": {
            "cod_siruta": 95060,
            "nume": "Iași",
            "tip": "municipiu"
        },
        "judet": {
            "cod": "IS",
            "nume": "Iași"
        },
        "resedinta": "Iași"
    },
    "meta": {
        "actualizat": {
            "administrativ": "2026-08-15T16: 39: 14+03: 00"
        }
    }
}

GEThttps://oneapi.ro/api/locations/v1/primarii/4562516

{
    "data": {
        "cui": "4562516",
        "uat": {
            "cod_siruta": 1071,
            "nume": "Ciugud",
            "tip": "comuna"
        },
        "judet": {
            "cod": "AB",
            "nume": "Alba"
        },
        "resedinta": "Ciugud"
    },
    "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 necunoscut.
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 necunoscut."
    }
}