API CUI: cum afli datele unei firme românești după CUI

ANAF publică gratuit un serviciu web pentru contribuabili, iar Registrul Comerțului (ONRC) ține datele de înmatriculare. Iată ce primești de la fiecare și ce adaugă un singur API cu răspuns JSON uniform, folosit și pentru alte 28 de țări.

Ce înseamnă „API CUI”

CUI (codul unic de identificare) este numărul sub care o firmă este cunoscută de Registrul Comerțului și de fisc. Un „API CUI” este un apel HTTP care primește acest număr și întoarce datele firmei într-un format pe care aplicația ta îl poate citi: denumire, formă juridică, status, adresă, număr de TVA. Se folosește la crearea clientului în aplicația de facturare, la onboarding KYB și la verificarea furnizorilor.

Serviciul public ANAF

ANAF oferă un serviciu web public, gratuit și fără cheie, în care trimiți CUI-uri și primești datele de contribuabil: denumirea, adresa și situația înregistrării în scopuri de TVA. Este potrivit pentru întrebarea „este acest CUI înregistrat la TVA și când?” și rămâne sursa fiscală a acestui răspuns. El pornește de la CUI: nu poți căuta o firmă după denumire și nu primești date de registru, precum forma juridică sau codurile CAEN autorizate.

Ce adaugă un API din Registrul Comerțului

Prometiam servește datele Registrului Comerțului (ONRC) pentru persoane juridice, prin același API folosit pentru celelalte țări. O căutare după CUI costă 1 credit:

curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=RO&company_number=5022670' \n  -H 'Authorization: Bearer rk_live_...'

import requests

BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}

def firma_dupa_cui(cui: str):
    r = requests.get(f'{BASE}/companies/search', headers=H,
                     params={'country': 'RO', 'company_number': cui})
    r.raise_for_status()
    date = r.json().get('data', [])
    return date[0] if date else None  # None: CUI inexistent sau persoană neservită

• Căutare și după denumire, nu doar după CUI: GET /companies/search?country=RO&name=....
• Câmpuri de registru: company_name, legal_form, status, adresa înregistrată, data înființării și codurile CAEN în registry_details.caen_codes.
• Număr de TVA în vat_number, construit după regulă (RO + CUI); GET /vat/RO... interoghează VIES pentru confirmare.
• Monitorizare: POST /monitor trimite un webhook când firma își schimbă statusul, denumirea, forma juridică sau adresa, iar GET /company-events/search listează modificările din registru.
• Același format în 29 de țări: aceleași câmpuri pentru o firmă română, una poloneză sau una spaniolă, cu o singură cheie.

Limite

• Doar persoanele juridice din Registrul Comerțului; persoanele fizice autorizate și întreprinderile individuale (PFA, II, IF), precum și sucursalele nu sunt servite.
• Fără administratori, capital social sau anunțuri de insolvență pentru România: falimentul, lichidarea sau reorganizarea apar în status și în evenimentele din registru.
• Sursa se citește lunar: o modificare din ultimele zile poate lipsi.
• vat_number este construit din CUI și nu confirmă înregistrarea la TVA; confirmarea o dă GET /vat/RO... (VIES).
• Cifra de control a CUI este orientativă, iar o valoare de 13 cifre (cod numeric personal) este refuzată.

Costuri

Un apel de căutare costă 1 credit, evenimentele 2 credite, erorile nimic. Starter costă 9,99 EUR pe lună pentru 1.000 de credite, Professional 29,99 EUR pentru 10.000 și Scale 99,99 EUR pentru 50.000. Proba gratuită durează 14 zile, cu 500 de credite: cardul este necesar, dar nu se încasează nimic în timpul probei.

Contains data from the National Trade Register Office (ONRC), CC BY 4.0

Pagini conexe

• Căutare CUI gratuită
• Ce este ONRC?
• e-Factura: verifică clientul
• Verificare KYB
• API date firme România (în engleză)

Începe perioada de probă gratuită de 14 zile · Documentația API

Perioada de probă durează 14 zile și include 500 de credite. Cardul este necesar, dar nu se încasează nimic în timpul probei; apoi continuă planul Starter (9,99 EUR pe lună), dacă nu anulezi.