oneapi
Autentificare
Locations v1 / Referință & business

Firme dintr-un UAT

Firmele cu sediul în UAT (cod SIRUTA), cele mai noi întâi. Paginat.

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

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ă

  • Firmele sunt legate de Locations prin sediul social rezolvat (99,9% la localitate, ~79% la stradă) — vezi modulul Firme.
  • Ordonate după data înmatriculării, cele mai noi întâi. Agregatele (total, TVA, top CAEN, pe stare) sunt la /uat/54975/firme/sumar.

La ce folosește

  • Câte firme și care sunt, într-un UAT (comună/oraș)
  • Prospectare / analiză de piață pe o zonă geografică
  • Verificarea densității economice a unei zone

Structura răspunsului

CâmpTipDescriere
data[].cui integer Codul fiscal al firmei.
data[].denumire string Denumirea, aşa cum o publică sursa.
data[].stare object Starea firmei, ca obiect: denumire e textul brut din ONRC (107 valori distincte folosite), categorie e clasificarea noastră în 7 cutii — activa, suspendata, dizolvata, lichidare, radiata, insolventa, alta — pe care o foloseşti ca să filtrezi sau să grupezi. cod e codul ONRC al stării.
data[].stare.cod string Codul din nomenclatorul sursei — cheia pe care se filtrează.
data[].stare.denumire string Denumirea, aşa cum o publică sursa.
data[].stare.categorie string Categoria din clasificarea sursei.
data[].caen_principal string CAEN principal, din starea fiscală ANAF.
data[].platitor_tva boolean Plătitor de TVA la ultima sincronizare.
data[].data_inmatriculare string Data înmatriculării la registrul comerţului.
meta.actualizat.firme string Când s-a împrospătat ultima dată chiar setul ăsta de date.
meta.actualizat.agregate string Agregatele disponibile în răspuns.
meta.paginare.pagina integer Pagina curentă, numărată de la 1.
meta.paginare.per_pagina integer Câte înregistrări are o pagină.
meta.paginare.total integer Totalul înregistrărilor care se potrivesc, dincolo de pagina curentă.
meta.paginare.pagini integer Câte pagini are lista.

Exemple de răspuns

GEThttps://oneapi.ro/api/locations/v1/uat/54975/firme
{
    "data": [
        {
            "cui": 55522575,
            "denumire": "STROPIA S.R.L.",
            "stare": {
                "cod": "1048",
                "denumire": "funcțiune",
                "categorie": "activa"
            },
            "caen_principal": "9329",
            "platitor_tva": false,
            "data_inmatriculare": "2026-09-01"
        }
    ],
    "meta": {
        "actualizat": {
            "firme": "2026-09-18T07: 16: 22+03: 00",
            "agregate": "2026-10-06T23: 13: 50+03: 00"
        },
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 114118,
            "pagini": 5706
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitEntitatea [{cod}] nu există.
422validareRuta nu primeşte parametri, în afară de lang: orice alt parametru dă 422, nu e ignorat.
429cota_depasitaCota 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": "validare",
        "mesaj": "Ruta nu primeşte parametri, în afară de lang: orice alt parametru dă 422, nu e ignorat.",
        "detalii": {
            "cod": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}