🚀 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