Quickstart

Integrare în
5 minute

PlusFirme API îți oferă date complete despre orice firmă din România — ONRC, adresă, stare fiscală și bilanțuri financiare 2009–2023. Un singur endpoint, un singur call.

01

Creează cont gratuit

Înregistrare la plusfirme.ro — 30 secunde, fără card.

Înregistrare gratuită →

02

Obține cheia API

Dashboard → Chei API → Generează cheie nouă. Copiez cheia și o folosești în header-ul Authorization.

03

Primul call

Înlocuiești YOUR_API_KEY cu cheia ta și apelezi endpoint-ul cu CUI-ul dorit.

curl https:#475569">//api.plusfirme.ro/v1/firme/12345678 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response JSON

{
  "cui": 12345678,
  "denumire": "Demo SRL",
  "cod_inmat": "J40/1234/2020",
  "data_inmat": "15/03/2020",
  "forma_jur": "SRL",
  "adresa": {
    "strada": "Calea Victoriei, nr. 100",
    "localitate": "Municipiul Ploiești",
    "judet": "Ilfov",
    "cod_postal": "077190",
    "tara": "România"
  },
  "financiar": {
    "cel_mai_recent": {
      "an": 2023,
      "cifra_afaceri": 4500000,
      "profit_net": 820000,
      "nr_angajati": 18,
      "active_circulante": 1250000,
      "datorii": 980000,
      "capitaluri": 1450000
    },
    "istoric": [ ... ]
  },
  "actualizat": "2024"
}

Autentificare

PlusFirme API folosește Bearer token — standard modern HTTP Authorization. Cheia ta API se trimite în header-ul fiecărui request.

Header obligatoriu

Authorization: Bearer <YOUR_API_KEY>

Bearer token per request

Cheie unică per cont. Nu expiră automat.

HTTPS obligatoriu

Toate requesturile trebuie făcute pe HTTPS.

Monitorizare usage

Veți vedea callurile în dashboard în timp real.

Rotire cheie

Poți genera o cheie nouă oricând din dashboard.

Securitate: Nu expune cheia API în cod client-side (JavaScript frontend). Folosește-o exclusiv din backend sau variabile de mediu.

GET/v1/firme/{cui}

Date complete firmă

Returnează toate datele disponibile pentru o firmă identificată prin CUI: date ONRC, adresă, stare fiscală și bilanțurile financiare din ultimii ani disponibili (2009–2023).

Parametri

Parametru	Tip	Necesar	Descriere
`cui`	integer	DA	Codul Unic de Înregistrare al firmei. Ex: `12345678`

Câmpuri response

Câmp	Tip	Descriere
`cui`	integer	Codul unic de înregistrare
`denumire`	string	Denumirea oficială a firmei
`cod_inmat`	string	Numărul de înmatriculare la Registrul Comerțului
`data_inmat`	string	Data înmatriculării (format DD/MM/YYYY)
`forma_jur`	string	Forma juridică: SRL, SA, PFA, RA, etc.
`adresa`	object	Adresa completă: strada, localitate, județ, cod_postal, tara
`financiar.cel_mai_recent`	object	Bilanțul celui mai recent an disponibil
`financiar.cel_mai_recent.cifra_afaceri`	integer	Cifra de afaceri netă (RON)
`financiar.cel_mai_recent.profit_net`	integer	Profit sau pierdere netă (RON)
`financiar.cel_mai_recent.nr_angajati`	integer	Număr mediu de angajați
`financiar.istoric`	array	Bilanțuri pentru toți anii disponibili (2009–2023)

curl https:#475569">//api.plusfirme.ro/v1/firme/12345678 \
  -H "Authorization: Bearer YOUR_API_KEY"

GET/v1/firme/search

Căutare firme

Caută firme după denumire, cu filtre opționale de județ și formă juridică. Returnează maximum 20 de rezultate per request.

Parametru	Tip	Necesar	Implicit	Descriere
`q`	string	DA	-	Termen de căutare (minim 2 caractere)
`judet`	string	NU	-	Filtrare după județ. Ex: Ilfov, Cluj, Iași
`forma`	string	NU	-	Forma juridică: SRL, SA, PFA, RA, SNC
`limit`	integer	NU	10	Număr de rezultate returnate (max 20)

# Caută după denumire
curl var(--green)">"https:#475569">//api.plusfirme.ro/v1/firme/search?q=construct&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Filtrare după județ + formă juridică
curl var(--green)">"https:#475569">//api.plusfirme.ro/v1/firme/search?q=construct&judet=Cluj&forma=SRL" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET/v1/firme/{cui}/financiar

Istoric financiar complet

Returnează bilanțurile financiare pentru toți anii disponibili (2009–2023). Include cifra de afaceri, profit/pierdere, număr de angajați, active, datorii și capitaluri proprii.

curl https:#475569">//api.plusfirme.ro/v1/firme/12345678/financiar \
  -H "Authorization: Bearer YOUR_API_KEY"

Response JSON

{
  "cui": 12345678,
  "denumire": "Demo SRL",
  "ani_disponibili": 10,
  "bilanturi": [
    {
      "an": 2023,
      "cifra_afaceri": 4500000,
      "profit_net": 820000,
      "nr_angajati": 18,
      "active_circulante": 1250000,
      "datorii": 980000,
      "capitaluri": 1450000,
      "capital_subscris": 1000,
      "venituri_totale": 5200000,
      "cheltuieli_totale": 4380000
    },
    {
      "an": 2022,
      "cifra_afaceri": 3100000,
      "profit_net": 540000,
      "nr_angajati": 15,
      ...
    }
  ]
}

Raport PDF

GET/v1/firme/{cui}/pdf

Generează un raport PDF profesional cu date juridice complete și bilanțuri financiare pe 10 ani. Răspunsul este un fișier PDF direct pentru descărcare.

REQUEST

GET https://api.plusfirme.ro/v1/firme/6496311/pdf
X-Api-Key: YOUR_API_KEY

# Descarcă PDF-ul
curl -H "X-Api-Key: YOUR_KEY"   https://api.plusfirme.ro/v1/firme/6496311/pdf   -o raport_dedeman.pdf

Răspuns: Content-Type: application/pdf — fișier PDF pentru descărcare directă, generat cu ReportLab. Include date ONRC + bilanțuri financiare pe 10 ani.

Export CSV

GET/v1/export/csv

Exportă liste de firme filtrate după județ, CAEN, formă juridică și stare fiscală. Compatibil cu Excel (BOM UTF-8). Maxim 50.000 firme per export.

PARAMETRI

# Filtre disponibile:
?judet=Cluj          # Județ
?caen=4711           # Cod CAEN (prefix match)
?forma=SRL           # Formă juridică
?stare=ACTIV         # Stare fiscală (ACTIV/INACTIV)
?limit=1000          # Nr. firme (1-50000)

# Exemplu: SRL-uri active din Cluj, CAEN retail alimentar
curl -H "X-Api-Key: YOUR_KEY"   "https://api.plusfirme.ro/v1/export/csv?judet=Cluj&caen=4711&forma=SRL&stare=ACTIV&limit=500"   -o firme-retail-cluj.csv

Monitor Firme

Urmărește modificările ANAF ale firmelor partenere. La orice schimbare (stare fiscală, adresă, TVA), primești email automat. Verificare zilnică la 07:00.

POST/v1/monitor/{cui}Adaugă firmă la monitorizare

GET/v1/monitorLista firmelor monitorizate

DELETE/v1/monitor/{cui}Șterge firma din monitorizare

# Adaugă la monitorizare
curl -X POST -H "X-Api-Key: YOUR_KEY"   https://api.plusfirme.ro/v1/monitor/6496311

# Lista firmelor monitorizate
curl -H "X-Api-Key: YOUR_KEY"   https://api.plusfirme.ro/v1/monitor

# Șterge din monitorizare
curl -X DELETE -H "X-Api-Key: YOUR_KEY"   https://api.plusfirme.ro/v1/monitor/6496311

Use Cases

Cele mai comune moduri în care developerii integrează PlusFirme API.

Auto-completare la facturare

Clientul introduce CUI-ul în formularul de factură și datele firmei se completează automat: denumire, adresă, formă juridică. Elimini erorile și accelerezi procesul.

# Obții datele firmei după CUI
curl var(--green)">"https:#475569">//api.plusfirme.ro/v1/firme/12345678" \
  -H "Authorization: Bearer YOUR_API_KEY"

Onboarding clienți B2B

La înregistrarea unui cont de firmă, userul introduce doar CUI-ul iar tu preiei automat toate datele. Plus verifici dacă firma e activă și are bilanțuri sănătoase.

# Verificare firmă nouă la onboarding
curl var(--green)">"https:#475569">//api.plusfirme.ro/v1/firme/12345678" \
  -H "Authorization: Bearer YOUR_API_KEY"

Scoring risc financiar

Calculează un scor de risc bazat pe evoluția cifrei de afaceri, profit, datorii și număr de angajați din ultimii ani.

curl var(--green)">"https:#475569">//api.plusfirme.ro/v1/firme/12345678/financiar" \
  -H "Authorization: Bearer YOUR_API_KEY"

Erori

API-ul folosește coduri de status HTTP standard. Toate erorile returnează un JSON cu câmpul detail.

Cod	Nume	Cauze posibile	Soluție
`401`	Unauthorized	Cheie API lipsă sau incorectă	Verifică header-ul Authorization: Bearer <key>
`403`	Forbidden	Cont suspendat sau cheie dezactivată	Verifică statusul contului în dashboard
`404`	Not Found	CUI inexistent în baza de date	Verifică dacă CUI-ul este corect (fără RO prefix)
`422`	Unprocessable	Parametru invalid (ex: CUI non-numeric)	Trimite CUI ca număr întreg, fără spații
`429`	Too Many Requests	Rate limit depășit	Respectă limita planului tău; adaugă retry cu backoff
`500`	Server Error	Eroare internă temporară	Retry după 5-10 secunde; dacă persistă contactează suport

Format eroare

Response JSON

// 404 — CUI inexistent
{
  "detail": "Firma cu CUI 99999999 nu a fost gasita"
}

// 401 — Cheie lipsă
{
  "detail": "Not authenticated"
}

// 429 — Rate limit
{
  "detail": "Rate limit exceeded. Retry after 60 seconds."
}

Best practice: Implementează retry cu exponential backoff pentru erori 429 și 500. Exemplu: retry după 1s, 2s, 4s.

Rate Limits

Limitele sunt aplicate per cheie API, nu per IP. Header-urile de răspuns indică starea curentă.

Plan	Calls/lună	Rate req/s	Preț
Free	50	1 req/s	Gratuit
DeveloperPopular	500	10 req/s	19 lei/lună
Business	5.000	50 req/s	69 lei/lună
Enterprise	Personalizat	Personalizat	Custom

Response headers

Response JSON

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 487
X-RateLimit-Reset: 1710720000

Prețuri

Începe gratuit, scalezi când ai nevoie.

Free

0 lei/lună

50 calluri/lună

1 req/s

Înregistrare gratuită

Developer

19 lei/lună

500 calluri/lună

10 req/s

Alege Developer

Business

69 lei/lună

5.000 calluri/lună

50 req/s

Alege Business

Enterprise

Custom

Nelimitat

Custom

Contactează-ne

Ai nevoie de volum mare sau integrare custom?

SLA garantat, white-label, suport dedicat, contract.

Contactează-ne →

Integrare în5 minute

Autentificare

Date complete firmă

Parametri

Câmpuri response

Căutare firme

Istoric financiar complet

Raport PDF

Export CSV

Monitor Firme

Use Cases

Auto-completare la facturare

Onboarding clienți B2B

Scoring risc financiar

Erori

Format eroare

Rate Limits

Response headers

Prețuri

Ai nevoie de volum mare sau integrare custom?

Integrare în
5 minute