Business v1 / Firme

Caută entităţi după nume

Caută după nume peste TOATE entităţile cu cod fiscal românesc, nu doar peste societăţile comerciale din Registrul Comerţului. Cu doar_neinregistrate=true întoarce exclusiv entităţile pe care căutarea de firme nu le vede.

GET

https://oneapi.ro/api/business/v1/entitati/cauta

Parametri de interogare

NumeTipDescriereValori acceptate

qopțional string | null Denumirea căutată, integral sau parţial. Minimum două caractere. Diacriticele nu contează. ex. parohiaex. Cluj

judetopțional string | null Numele sau codul auto al judeţului: CJ, Cluj, Argeș, ARGEŞ. Diacriticele nu contează, iar un judeţ necunoscut dă 422, nu o listă goală. max 64 car.

tip_contribopțional string | null PJ (persoană juridică) sau PF (persoană fizică autorizată). PJPF

doar_neinregistrateopțional boolean | null true = doar entităţile care NU sunt în Registrul Comerţului. ex. true

Cum se comportă

⚠️ Caută altundeva decât /firme/cauta. Aceea interoghează Registrul Comerţului; aici se caută peste evidenţa plătitorilor, care include şi cele 611.818 entităţi care nu sunt societăţi comerciale — asociaţii, spitale, parohii, fundaţii, şcoli, primării. Până la ruta asta, ele nu se puteau găsi după nume nicăieri: /entitati/{cui} le deschidea o uşă, dar numai dacă ştiai dinainte codul fiscal.
doar_neinregistrate=true e parametrul care dă sensul rutei. Fără el, rezultatele sunt în majoritate societăţi comerciale, pe care le găseşti oricum la /firme/cauta. Cu el, rămân exact entităţile pe care cealaltă rută nu le vede.
Potrivirea e pe similaritate, nu pe egalitate: numele scris aproximativ sau parţial găseşte. Ordonarea e după cât de bine se potriveşte, apoi alfabetic, ca două potriviri egale să iasă în aceeaşi ordine la fiecare cerere.
Fiecare rezultat spune prin e_firma dacă entitatea e şi în Registrul Comerţului. Pentru detaliile complete, /entitati/{cui}.

La ce folosește

Găsirea codului fiscal al unei şcoli, parohii sau asociaţii, pornind de la denumire.
Verificarea existenţei unei entităţi non-comerciale înainte de a o introduce într-un contract.
Listarea entităţilor non-comerciale dintr-un judeţ.

Structura răspunsului

CâmpTipDescriere

data[].cui integer Codul fiscal.

data[].denumire string Denumirea oficială, din evidenţa Ministerului Finanţelor.

data[].tip_contrib string PJ sau PF.

data[].e_firma boolean true dacă entitatea e şi în Registrul Comerţului.

data[].judet string Judeţul din adresa fiscală.

data[].localitate string Localitatea din adresa fiscală.

data[].stare string Starea înregistrării fiscale.

data[].an integer Anul ediţiei instantaneului din care vin datele.

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/business/v1/entitati/cauta?q=parohia&doar_neinregistrate=true

{
    "data": [
        {
            "cui": 40973801,
            "denumire": "PAROHIA 1 DECEMBRIE",
            "tip_contrib": "PJ",
            "e_firma": false,
            "judet": "ILFOV",
            "localitate": "1 Decembrie",
            "stare": "INREGISTRAT",
            "an": 2026
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 14440,
            "pagini": 722
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/entitati/cauta?judet=CLUJ&doar_neinregistrate=true

{
    "data": [
        {
            "cui": 46491089,
            "denumire": "3R GREEN CLUSTER",
            "tip_contrib": "PJ",
            "e_firma": false,
            "judet": "CLUJ",
            "localitate": "Cluj-Napoca",
            "stare": "INREGISTRAT",
            "an": 2026
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 20,
            "total": 34339,
            "pagini": 1717
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/entitati/cauta?per_pagina=3

{
    "data": [
        {
            "cui": 41572620,
            "denumire": "$COMPANYNAME S.R.L.",
            "tip_contrib": "PJ",
            "e_firma": true,
            "judet": "ARAD",
            "localitate": "Oraş Sântana",
            "stare": "SUSPENDARE ACTIVITATE",
            "an": 2026
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 3,
            "total": 2647765,
            "pagini": 882589
        }
    }
}

GEThttps://oneapi.ro/api/business/v1/entitati/cauta?per_pagina=3&q=Cluj

{
    "data": [
        {
            "cui": 49893358,
            "denumire": "CLUJ 1 PAWNBROKER S.R.L.",
            "tip_contrib": "PJ",
            "e_firma": true,
            "judet": "ALBA",
            "localitate": "Aiud",
            "stare": "INREGISTRAT",
            "an": 2026
        }
    ],
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 3,
            "total": 5405,
            "pagini": 1802
        }
    }
}

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.
422	validare	Fără niciun filtru nu se caută: dă cel puţin unul (`q`, `judet`, `tip_contrib`).
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": "validare",
        "mesaj": "Fără niciun filtru nu se caută: dă cel puţin unul (q, judet, tip_contrib).",
        "detalii": {
            "q": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}