Business v1 / Firme

Date de contact

Datele de contact ale firmei (telefon, fax, e-factura, domiciliu fiscal, organ fiscal) din ANAF.

GET

https://oneapi.ro/api/business/v1/firme/{cui}/contact

Parametri de cale

NumeTipDescriereExemplu

cuiobligatoriu string Codul de identificare fiscală al firmei, fără prefixul RO (ex. 6719278).

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Datele de contact publice ale firmei, aşa cum apar în surse. Acoperirea variază — multe firme n-au telefon sau e-mail publicat.
Site-ul, emailurile şi telefoanele publicate de firmă pe propriul site sunt la /firme/{cui}/web (plan Pro).
⚠️ O firmă care e în registru dar n-are fişă fiscală la ANAF întoarce 200 cu data: null şi meta.fara_date, NU 404 — sunt 15.785 de cazuri din 3.909.449 (0,4%). 404 rămâne doar pentru CUI-uri care nu există în registru. Până pe 30 sep 2026 amândouă dădeau acelaşi 404, iar clientul nu le putea deosebi: un 404 adevărat trecea drept „n-are date de contact".

La ce folosește

Completarea automată a telefonului şi e-mailului la crearea unui client în CRM.
Îmbogăţirea unei liste de lead-uri cu datele de contact publicate.
Verificarea faptului că datele de contact pe care le ai coincid cu cele publice.

Structura răspunsului

Toate câmpurile de mai jos sunt în data.

CâmpTipDescriere

cui integer Codul fiscal.

telefon string | null Telefonul din evidenţa ANAF.

fax string | null Faxul din evidenţa ANAF.

e_factura boolean Înrolată în e-Factura.

domiciliu_fiscal string | null Domiciliul fiscal, în forma publicată de ANAF.

organ_fiscal string | null Administraţia fiscală de care aparţine.

Exemple de răspuns

GEThttps://oneapi.ro/api/business/v1/firme/6719278/contact

{
    "data": {
        "cui": 6719278,
        "telefon": "0212246677",
        "fax": null,
        "e_factura": false,
        "domiciliu_fiscal": "MUNICIPIUL BUCUREŞTI, Sector 6 Mun. Bucureşti, Bld. Timişoara, nr. 26",
        "organ_fiscal": "Direcţia Generală de Administrare a Marilor Contribuabili"
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/14399840/contact

{
    "data": {
        "cui": 14399840,
        "telefon": null,
        "fax": null,
        "e_factura": false,
        "domiciliu_fiscal": "MUNICIPIUL BUCUREŞTI, Sector 2 Mun. Bucureşti, Str. Gara Herăstrău, nr. 6",
        "organ_fiscal": "Direcţia Generală de Administrare a Marilor Contribuabili"
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/2054341/contact

{
    "data": {
        "cui": 2054341,
        "telefon": "0233743401",
        "fax": "0233744490",
        "e_factura": false,
        "domiciliu_fiscal": "IAŞI, Mun. Iaşi, Aleea Strugurilor, nr. 98",
        "organ_fiscal": "Administraţia Judeţeană a Finanţelor Publice Iaşi"
    }
}

GEThttps://oneapi.ro/api/business/v1/firme/24890577/contact

{
    "data": {
        "cui": 24890577,
        "telefon": "0744397587",
        "fax": null,
        "e_factura": true,
        "domiciliu_fiscal": "HARGHITA, Mun. Gheorgheni, Str. Pompierilor, nr. 118",
        "organ_fiscal": "Unitatea Fiscală Municipală Gheorgheni"
    }
}

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	Firma cu CUI [{cui}] nu a fost găsită în Registrul Comerţului. „Există, dar n-are date de contact" NU e 404 — e 200 cu `meta.fara_date`.
422	validare	Ruta nu primeşte parametri, în afară de `lang`: orice alt parametru dă 422, nu e ignorat.
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": "Ruta nu primeşte parametri, în afară de lang: orice alt parametru dă 422, nu e ignorat.",
        "detalii": {
            "cui": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}