oneapi
Autentificare
Business v1 / Firme

Firme noi

Firmele nou înmatriculate, cele mai recente întâi. Filtre: ?an=, ?luna=, ?judet=. Paginat.

GET
https://oneapi.ro/api/business/v1/firme/noi

Parametri de interogare

NumeTipDescriereValori acceptate
anopțional integer | null Anul înmatriculării. ex. 2024
judetopțional string | null Judeţul sediului. ex. CJ
lunaopțional integer | null Luna înmatriculării. 1 – 12
zileopțional integer | null Fereastra implicită, fără an: câte zile înapoi de la cea mai nouă înmatriculare. Implicit 30, maxim 366. Nu se combină cu an. 1 – 366

Cum se comportă

  • Firmele înmatriculate recent, cele mai noi întâi. Cu an (şi opţional luna) primeşti o perioadă anume; fără ele, ultimele zile zile din registru (implicit 30). Intervalul aplicat e în meta.interval.
  • Fereastra se socoteşte de la cea mai nouă înmatriculare din bază, nu de la azi: registrul ONRC se publică lunar, iar „ultimele 30 de zile de azi" ar fi goale în săptămânile dinaintea unei noi ediţii. Deci pana e data ultimei ediţii, nu data curentă.
  • Filtrul judet lucrează pe sediul legat la nomenclatorul de localităţi. Firmele apărute în ultima ediţie se leagă la importul zilnic; până atunci nu apar la filtrarea pe judeţ.

La ce folosește

  • Alimentarea unei liste de prospectare cu firmele înfiinţate luna trecută în judeţul tău.
  • Monitorizarea concurenţei noi pe un sector şi o zonă.
  • Un flux zilnic de lead-uri proaspete către echipa de vânzări.

Structura răspunsului

CâmpTipDescriere
data[].cui integer Codul fiscal.
data[].denumire string | null Denumirea.
data[].cod_inmatriculare string | null Numărul de ordine în registrul comerţului (J…).
data[].forma_juridica string | null Forma juridică (SRL, SA, PFA…).
data[].stare string | null 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[].data_inmatriculare string | null Data înmatriculării la registrul comerţului.
data[].radiere.vazut_la string
data[].radiere.dupa string | null
data[].sediu.judet string Judeţul sediului social.opțional
data[].sediu.localitate string Localitatea sediului social.opțional
data[].sediu.cod_siruta integer Codul SIRUTA al localităţii — chainable spre /locations/v1.opțional
data[].caen_principal.cod string Codul CAEN principal.
data[].caen_principal.denumire string | null Denumirea activităţii principale.
data[].fiscal.tva boolean Plătitoare de TVA.
data[].fiscal.inactiv boolean Declarată inactivă fiscal.
data[].fiscal.e_factura boolean Înrolată în e-Factura.
data[].financiar object Ultimul bilanţ depus (an, cifră de afaceri, profit net, salariaţi); null la firmele fără bilanţ — PFA-uri, firme noi —, nu zero.
data[].financiar.an integer Anul bilanţului.
data[].financiar.cifra_afaceri number | null Cifra de afaceri netă, în lei.
data[].financiar.profit_net number | null Profitul net, în lei; negativ = pierdere.
data[].financiar.salariati integer | null Numărul mediu de salariaţi.
meta.paginare.pagina integer Pagina curentă.
meta.paginare.per_pagina integer Rezultate pe pagină.
meta.paginare.total integer Total rezultate.
meta.paginare.pagini integer Număr de pagini.
meta.interval object Intervalul de înmatriculare aplicat: {de, pana}. Fără an, sunt ultimele zile zile din registru.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/noi?zile=30
{
    "data": [
        {
            "cui": 55526755,
            "denumire": "ARUA DEVICE S.R.L.",
            "cod_inmatriculare": "J2026052729009",
            "forma_juridica": "SRL",
            "stare": {
                "cod": "1048",
                "denumire": "funcțiune",
                "categorie": "activa"
            },
            "data_inmatriculare": "2026-09-02",
            "sediu": {
                "judet": "Bihor",
                "localitate": "Oradea",
                "cod_siruta": 26573
            },
            "caen_principal": {
                "cod": "6210",
                "denumire": "Activități de realizare a soft-ului la comandă (software orientat client)"
            },
            "fiscal": {
                "tva": false,
                "inactiv": false,
                "e_factura": false
            },
            "financiar": null
        }
    ],
    "meta": {
        "interval": {
            "de": "2026-08-04",
            "pana": "2026-09-02"
        },
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 7877,
            "pagini": 394
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
422validareUn parametru nedeclarat ori o valoare care nu trece validarea (an, judet, luna, zile). Câmpul vinovat e în detalii.
422filtru_necunoscutUn filtru care nu corespunde niciunei entităţi (judeţ, localitate, UAT, formă juridică, stare scrise greşit) — nu o listă goală; detalii.camp spune care.
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": "Un parametru nedeclarat ori o valoare care nu trece validarea (an, judet, luna, zile). Câmpul vinovat e în detalii.",
        "detalii": {
            "an": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}