oneapi
Autentificare
Locations v1 / Referință & business

Firme de pe o stradă

Firmele cu sediul pe strada dată (id intern). Sediul e legat la stradă pentru ~79% din firme.

GET
https://oneapi.ro/api/locations/v1/strazi/{id}/firme

Parametri de cale

NumeTipDescriereExemplu
idobligatoriu string Identificatorul intern al străzii — se obţine din căutarea de străzi.

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 /strazi/216508/firme/sumar.

La ce folosește

  • Câte firme și care sunt, într-o singură stradă
  • 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/strazi/216508/firme
{
    "data": [
        {
            "cui": 55525253,
            "denumire": "POP TIMOTEI PERSOANĂ FIZICĂ AUTORIZATĂ",
            "stare": {
                "cod": "1048",
                "denumire": "funcțiune",
                "categorie": "activa"
            },
            "caen_principal": "7311",
            "platitor_tva": false,
            "data_inmatriculare": "2026-09-02"
        }
    ],
    "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": 26765,
            "pagini": 1339
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitEntitatea [{id}] 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": {
            "id": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}