InsolvențăCredite premium · 1 credit

API Insolvență — Tabelele creditorilor

Tabelele de creanțe publicate de administratorul judiciar: fiecare creditor cu suma declarată, suma admisă, categoria (garantată, salarială, bugetară, chirografară, subordonată), procentul din masa credală și observațiile. Pentru fiecare dosar indicăm tabelul curent — cel mai recent și cel mai consolidat — ca să nu aduni aceleași datorii de mai multe ori.

GET/api/v1/bpi/creditori/{cui}
1 credit fix· credite premium
după cheie + căutare cu filtre
2 endpoint-uridupă cheie + căutare cu filtre
la căutarea după cheie
1 credit fix premiumla căutarea după cheie
explicate mai jos
10 câmpuriexplicate mai jos
GET/api/v1/bpi/creditori/14231153
X-API-KEY: CHEIA_TA_API
{
  "success": true,
  "cui": "14231153",
  "sursa": "Buletinul Procedurilor de Insolvență (ONRC), extragere automată FirmeAPI",
  "total": 7,
  "rezultate": [
    {
      "cui": "14231153",
      "numar_bpi": "15095/2026",
      "numar_dosar": "5244/118/2022",
      "data": "2026-06-08",
      "titlu_document": "Tabel definitiv",
      "tip_tabel": "definitiv consolidat rectificat",
      "extracted_at": "2026-08-14T15:31:53Z",
      "creditori": [
        {
          "nume": "Creditor exemplu 1 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 2",
          "categorie": "salariala",
          "garantii": null,
          "suma_declarata": 8152,
          "suma_admisa": 8152,
          "procent": null,
          "observatii": null
        },
        {
          "nume": "Creditor exemplu 3 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 4",
          "categorie": "bugetara",
          "garantii": null,
          "suma_declarata": 2681856,
          "suma_admisa": 2681856,
          "procent": null,
          "observatii": null
        },
        {
          "nume": "Creditor exemplu 5 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 6",
          "categorie": "bugetara",
          "garantii": null,
          "suma_declarata": 640000,
          "suma_admisa": 640000,
          "procent": null,
          "observatii": "Observațiile administratorului judiciar."
        }
      ]
    },
    {
      "cui": "14231153",
      "numar_bpi": "14416/2026",
      "numar_dosar": "5244/118/2022",
      "data": "2026-06-02",
      "titlu_document": "Tabel definitiv",
      "tip_tabel": "definitiv consolidat rectificat",
      "extracted_at": "2026-08-14T05:33:05Z",
      "creditori": [
        {
          "nume": "Creditor exemplu 7 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 8",
          "categorie": "salariala",
          "garantii": null,
          "suma_declarata": 8152,
          "suma_admisa": 8152,
          "procent": null,
          "observatii": null
        },
        {
          "nume": "Creditor exemplu 9 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 10",
          "categorie": "bugetara",
          "garantii": null,
          "suma_declarata": 2681856,
          "suma_admisa": 2681856,
          "procent": null,
          "observatii": null
        },
        {
          "nume": "Creditor exemplu 11 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 12",
          "categorie": "bugetara",
          "garantii": null,
          "suma_declarata": 8428,
          "suma_admisa": 8428,
          "procent": null,
          "observatii": null
        }
      ]
    },
    {
      "cui": "14231153",
      "numar_bpi": "10721/2026",
      "numar_dosar": "5244/118/2022",
      "data": "2026-04-24",
      "titlu_document": "Tabel definitiv",
      "tip_tabel": "suplimentar",
      "extracted_at": "2026-08-13T20:06:10Z",
      "creditori": [
        {
          "nume": "Creditor exemplu 13 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 14",
          "categorie": "bugetara",
          "garantii": null,
          "suma_declarata": 1968507,
          "suma_admisa": 1968507,
          "procent": null,
          "observatii": null
        },
        {
          "nume": "Creditor exemplu 15 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 16",
          "categorie": "bugetara",
          "garantii": null,
          "suma_declarata": 8428,
          "suma_admisa": 8428,
          "procent": null,
          "observatii": null
        },
        {
          "nume": "Creditor exemplu 17 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 18",
          "categorie": "chirografara",
          "garantii": null,
          "suma_declarata": 5634.24,
          "suma_admisa": 5634.24,
          "procent": null,
          "observatii": null
        }
      ]
    }
  ]
}
200 OKSursă: Publicațiile de insolvență (ONRC), extragere automată FirmeAPI
Toate câmpurile →

Exemplu cu date fictive · bază URL https://www.firmeapi.ro/api/v1

Despre date

Insolvență — Tabelele creditorilor

Cine are de primit bani de la o firmă în insolvență: sume declarate, admise, rang și procent.

Tabelele de creanțe publicate de administratorul judiciar: fiecare creditor cu suma declarată, suma admisă, categoria (garantată, salarială, bugetară, chirografară, subordonată), procentul din masa credală și observațiile. Pentru fiecare dosar indicăm tabelul curent — cel mai recent și cel mai consolidat — ca să nu aduni aceleași datorii de mai multe ori.

Sursa
Publicațiile de insolvență (ONRC), extragere automată FirmeAPI
Credite
Premium — necesită abonament plătit sau pachet premium
Acoperire
Peste 200.000 de tabele de creanțe, majoritatea din 2024–2026.

Important când interpretezi datele

PDF-ul original al publicației se ia separat, cu GET /api/v1/bpi/{cui}/{numar_bpi}/sursa: 3 credite premium per fișier livrat, fiecare descărcare se taxează. Sursele sunt disponibile pentru publicațiile din 2026; pentru restul, câmpul are_pdf e false și documentele se procesează.
NU aduna tabelele între ele: un dosar își republică tabelul (preliminar, definitiv, consolidat, rectificat) și fiecare repetă aceleași datorii. Ia un singur tabel per dosar: cel mai recent, iar la aceeași dată cel mai consolidat (definitiv consolidat > definitiv > preliminar).
Creditorii nu au cod fiscal în tabele, deci potrivirea se face după nume. Două direcții fiscale locale pot avea chei apropiate.
Sumele sunt în lei, cum apar în tabel.

Integrare cu agenți AI

Agentul tău îl integrează din prima

Un ghid complet, scris pentru agenții de programare: endpoint-uri, câmpuri, erori, cod de referință și teste de acceptanță. Agentul face integrarea cap-coadă, fără să te întrebe nimic. Sau îl conectezi prin MCP și interoghează direct datele.

Ghidul pentru agenți
.md →
Specificația OpenAPI
openapi.json →
Rezumat pentru LLM-uri
llms.txt →
Ghid MCP pe fiecare client
Configurare MCP →

Prompt pentru agentul de programare

Agentul deschide ghidul de la adresa din prompt. Dacă nu poate accesa internetul, copiază-i .

Implementează în aplicația mea integrarea cu API-ul Insolvență — Tabelele creditorilor FirmeAPI.ro.

Citește întâi ghidul complet de implementare:
https://www.firmeapi.ro/info-api/bpi-creditori.md

Urmează-l pas cu pas: configurarea cheii FIRMEAPI_KEY, clientul API cu
tratarea erorilor și reîncercările, cache-ul, regulile de domeniu
interfața și testele de acceptanță.

Respectă convențiile proiectului. La final rulează testele și spune-mi ce
fișiere ai creat sau modificat.

Documentație

Referința API

Parametrii, fiecare câmp al răspunsului și răspunsurile pe coduri de stare, cu exemple de cod în patru limbaje.

Bază URL
https://www.firmeapi.ro/api/v1
Autentificare
X-API-KEY: cheia ta
Format
JSON, UTF-8, date YYYY-MM-DD
Erori
nu consumă credite

Tabelele de creanțe ale unei firme#

GET/api/v1/bpi/creditori/{cui}
1 credit fix· premium

Toate tabelele publicate pentru firmă, cu lista completă de creditori, de la cel mai recent. Pentru sume folosește, din fiecare dosar, doar tabelul cel mai recent și cel mai consolidat.

Parametri

cuistring· în URLobligatoriu
Codul fiscal (CUI) al firmei, fără RO. ex.: 14231153

Câmpurile răspunsului

successboolean
true când cererea a reușit.
cuistring
Valoarea cerută, normalizată.
sursastring
Sursa datelor.
totalinteger
Câte rezultate există pentru cheie.
afisateinteger
Doar când total e mai mare decât limita: câte sunt întoarse.
notastring
Doar când rezultatele sunt trunchiate: cum obții restul.
rezultatearray
Rezultatele, de la cel mai recent.
rezultate[].cuistring
CUI-ul firmei debitoare.
rezultate[].numar_bpistring
Publicația de insolvență în care a apărut tabelul.
rezultate[].are_pdfbool
Dacă avem PDF-ul original al publicației. Sursele sunt disponibile pentru publicațiile din 2026; restul se procesează.
rezultate[].sursa_pdfstring|null
Adresa de la care se ia PDF-ul original: GET /api/v1/bpi/{cui}/{numar_bpi}/sursa. Costă 3 credite premium per fișier livrat; verificarea de aici nu costă nimic.
rezultate[].numar_dosarstring|null
Dosarul de insolvență.
rezultate[].datadate
Data publicării tabelului.
rezultate[].tip_tabelstring
Tipul tabelului, în formularea sursei: preliminar, definitiv, definitiv consolidat, rectificat, suplimentar etc.
rezultate[].titlu_documentstring
Titlul documentului publicat.
rezultate[].creditoriarray
Rândurile tabelului, câte unul pe creditor.
rezultate[].creditori[].numestring
Numele creditorului, cum apare în tabel.
rezultate[].creditori[].nume_keystring
Cheie de potrivire (cuvintele sortate, fără diacritice). Nu e un identificator: creditorii nu au CUI în tabel.
rezultate[].creditori[].categoriestring|null
garantata, salariala, bugetara, chirografara, subordonata, curenta.
rezultate[].creditori[].suma_declaratanumber|null
Suma cerută de creditor (lei).
rezultate[].creditori[].suma_admisanumber|null
Suma admisă de administrator (lei). Diferența față de suma declarată e respinsă.
rezultate[].creditori[].procentnumber|null
Procentul din totalul masei credale.
rezultate[].creditori[].garantiistring|null
Garanțiile menționate.
rezultate[].creditori[].observatiistring|null
Observațiile administratorului (creanță sub condiție, tardivă etc.).
rezultate[].extracted_atdatetime
Momentul extragerii.
curl -X GET "https://www.firmeapi.ro/api/v1/bpi/creditori/14231153" \
  -H "X-API-KEY: CHEIA_TA_API" \
  -H "Accept: application/json"

200 OK · se taxează 1 credit fix premium

{
  "success": true,
  "cui": "14231153",
  "sursa": "Buletinul Procedurilor de Insolvență (ONRC), extragere automată FirmeAPI",
  "total": 7,
  "rezultate": [
    {
      "cui": "14231153",
      "numar_bpi": "15095/2026",
      "numar_dosar": "5244/118/2022",
      "data": "2026-06-08",
      "titlu_document": "Tabel definitiv",
      "tip_tabel": "definitiv consolidat rectificat",
      "extracted_at": "2026-08-14T15:31:53Z",
      "creditori": [
        {
          "nume": "Creditor exemplu 1 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 2",
          "categorie": "salariala",
          "garantii": null,
          "suma_declarata": 8152,
          "suma_admisa": 8152,
          "procent": null,
          "observatii": null
        },
        {
          "nume": "Creditor exemplu 3 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 4",
          "categorie": "bugetara",
          "garantii": null,
          "suma_declarata": 2681856,
          "suma_admisa": 2681856,
          "procent": null,
          "observatii": null
        },
        {
          "nume": "Creditor exemplu 5 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 6",
          "categorie": "bugetara",
          "garantii": null,
          "suma_declarata": 640000,
          "suma_admisa": 640000,
          "procent": null,
          "observatii": "Observațiile administratorului judiciar."
        }
      ]
    },
    {
      "cui": "14231153",
      "numar_bpi": "14416/2026",
      "numar_dosar": "5244/118/2022",
      "data": "2026-06-02",
      "titlu_document": "Tabel definitiv",
      "tip_tabel": "definitiv consolidat rectificat",
      "extracted_at": "2026-08-14T05:33:05Z",
      "creditori": [
        {
          "nume": "Creditor exemplu 7 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 8",
          "categorie": "salariala",
          "garantii": null,
          "suma_declarata": 8152,
          "suma_admisa": 8152,
          "procent": null,
          "observatii": null
        },
        {
          "nume": "Creditor exemplu 9 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 10",
          "categorie": "bugetara",
          "garantii": null,
          "suma_declarata": 2681856,
          "suma_admisa": 2681856,
          "procent": null,
          "observatii": null
        },
        {
          "nume": "Creditor exemplu 11 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 12",
          "categorie": "bugetara",
          "garantii": null,
          "suma_declarata": 8428,
          "suma_admisa": 8428,
          "procent": null,
          "observatii": null
        }
      ]
    },
    {
      "cui": "14231153",
      "numar_bpi": "10721/2026",
      "numar_dosar": "5244/118/2022",
      "data": "2026-04-24",
      "titlu_document": "Tabel definitiv",
      "tip_tabel": "suplimentar",
      "extracted_at": "2026-08-13T20:06:10Z",
      "creditori": [
        {
          "nume": "Creditor exemplu 13 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 14",
          "categorie": "bugetara",
          "garantii": null,
          "suma_declarata": 1968507,
          "suma_admisa": 1968507,
          "procent": null,
          "observatii": null
        },
        {
          "nume": "Creditor exemplu 15 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 16",
          "categorie": "bugetara",
          "garantii": null,
          "suma_declarata": 8428,
          "suma_admisa": 8428,
          "procent": null,
          "observatii": null
        },
        {
          "nume": "Creditor exemplu 17 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 18",
          "categorie": "chirografara",
          "garantii": null,
          "suma_declarata": 5634.24,
          "suma_admisa": 5634.24,
          "procent": null,
          "observatii": null
        }
      ]
    }
  ]
}

Tabelele de creanțe, cu filtre#

GET/api/v1/bpi/creditori/lista
1 credit / rezultat· premium

Fără filtre, cele mai recent publicate tabele de creanțe. Cu filtrul creditor: la ce firme în insolvență apare un creditor (bancă, furnizor, instituție) — tabelele în care apare și, pentru fiecare, rândurile care se potrivesc (creditori_potriviti).

Parametri

creditorstring· query
Numele creditorului căutat (potrivire pe cuvinte). ex.: Banca Transilvania
categoriestring· query
Categoria creanței. garantatasalarialabugetarachirografarasubordonatacurenta
suma_minnumber· query
Suma admisă minimă pe rândul creditorului (lei). ex.: 100000
cuistring· query
Doar tabelele unei firme debitoare.
numar_dosarstring· query
Dosarul de insolvență.
tip_tabelstring· query
Tipul tabelului, ca în sursă (ex. preliminar, definitiv, definitiv consolidat).
data_dedate (AAAA-LL-ZZ)· query
De la această dată (data ≥), format AAAA-LL-ZZ. ex.: 2026-01-01
data_panadate (AAAA-LL-ZZ)· query
Până la această dată (data ≤), format AAAA-LL-ZZ. ex.: 2026-12-31
paginainteger· query
Numărul paginii, de la 1. ex.: 1
per_paginainteger· query
Rezultate pe pagină, maxim 20. ex.: 20
ordinestring· query
Ordinea rezultatelor (vezi valorile permise pe endpoint). recentevechiex.: recente

Câmpurile răspunsului

successboolean
true când cererea a reușit.
sursastring
Sursa datelor.
pagina · per_paginainteger
Pagina curentă și rezultatele pe pagină.
total · total_paginiinteger
Totalul rezultatelor care se potrivesc filtrelor și numărul de pagini pe care le poți parcurge.
rezultatearray
Rezultatele paginii.
rezultate[].cuistring
CUI-ul firmei debitoare.
rezultate[].numar_bpistring
Publicația de insolvență în care a apărut tabelul.
rezultate[].are_pdfbool
Dacă avem PDF-ul original al publicației. Sursele sunt disponibile pentru publicațiile din 2026; restul se procesează.
rezultate[].sursa_pdfstring|null
Adresa de la care se ia PDF-ul original: GET /api/v1/bpi/{cui}/{numar_bpi}/sursa. Costă 3 credite premium per fișier livrat; verificarea de aici nu costă nimic.
rezultate[].numar_dosarstring|null
Dosarul de insolvență.
rezultate[].datadate
Data publicării tabelului.
rezultate[].tip_tabelstring
Tipul tabelului, în formularea sursei: preliminar, definitiv, definitiv consolidat, rectificat, suplimentar etc.
rezultate[].titlu_documentstring
Titlul documentului publicat.
rezultate[].creditoriarray
Rândurile tabelului, câte unul pe creditor.
rezultate[].creditori[].numestring
Numele creditorului, cum apare în tabel.
rezultate[].creditori[].nume_keystring
Cheie de potrivire (cuvintele sortate, fără diacritice). Nu e un identificator: creditorii nu au CUI în tabel.
rezultate[].creditori[].categoriestring|null
garantata, salariala, bugetara, chirografara, subordonata, curenta.
rezultate[].creditori[].suma_declaratanumber|null
Suma cerută de creditor (lei).
rezultate[].creditori[].suma_admisanumber|null
Suma admisă de administrator (lei). Diferența față de suma declarată e respinsă.
rezultate[].creditori[].procentnumber|null
Procentul din totalul masei credale.
rezultate[].creditori[].garantiistring|null
Garanțiile menționate.
rezultate[].creditori[].observatiistring|null
Observațiile administratorului (creanță sub condiție, tardivă etc.).
rezultate[].extracted_atdatetime
Momentul extragerii.
cost.credite_consumate · mod · tipinteger · string
Creditele consumate de cerere, modul de taxare (fix sau per_rezultat) și tipul creditelor (general sau premium).

Reguli pentru integrare

  1. 1Maximum 20 rezultate pe pagină. Paginile acoperă toate rezultatele care se potrivesc filtrelor; dacă o căutare e prea largă pentru a fi paginată până la capăt, răspunsul spune până unde poți merge.
  2. 2Costul se calculează pe numărul de rezultate întoarse; o căutare fără rezultate nu costă nimic.
curl -X GET "https://www.firmeapi.ro/api/v1/bpi/creditori/lista?creditor=Banca%20Transilvania&suma_min=100000" \
  -H "X-API-KEY: CHEIA_TA_API" \
  -H "Accept: application/json"

200 OK · se taxează 1 credit / rezultat premium

{
  "success": true,
  "sursa": "Buletinul Procedurilor de Insolvență (ONRC), extragere automată FirmeAPI",
  "pagina": 1,
  "per_pagina": 2,
  "total": 8213,
  "total_pagini": 4107,
  "rezultate": [
    {
      "cui": "44879816",
      "numar_bpi": "23287/2026",
      "numar_dosar": "18/1285/2025",
      "data": "2026-09-24",
      "titlu_document": "Tabel definitiv rectificat / completat / actualizat al creanţelor, nr. 4, din data de 23-09-2026, Tribunalul Specializat Cluj",
      "tip_tabel": "definitiv actualizat",
      "extracted_at": "2026-09-24T08:15:25Z",
      "creditori": [
        {
          "nume": "Creditor exemplu 1 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 2",
          "categorie": "garantata",
          "garantii": null,
          "suma_declarata": 190958.04,
          "suma_admisa": 190958.04,
          "procent": 50.07,
          "observatii": "Observațiile administratorului judiciar."
        },
        {
          "nume": "Creditor exemplu 3 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 4",
          "categorie": "bugetara",
          "garantii": null,
          "suma_declarata": 80027,
          "suma_admisa": 80027,
          "procent": 20.98,
          "observatii": null
        },
        {
          "nume": "Creditor exemplu 5 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 6",
          "categorie": "chirografara",
          "garantii": null,
          "suma_declarata": 1820.93,
          "suma_admisa": 1820.93,
          "procent": 0.48,
          "observatii": null
        }
      ],
      "creditori_potriviti": [
        {
          "nume": "Creditor exemplu 7 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 8",
          "categorie": "garantata",
          "garantii": null,
          "suma_declarata": 190958.04,
          "suma_admisa": 190958.04,
          "procent": 50.07,
          "observatii": "Observațiile administratorului judiciar."
        }
      ]
    },
    {
      "cui": "33781242",
      "numar_bpi": "23207/2026",
      "numar_dosar": "",
      "data": "2026-09-23",
      "titlu_document": "Tabel definitiv rectificat / completat / actualizat al creanţelor, nr. 1463, din data de 21-09-2026, Tribunalul Mehedinţi, Secţia a II-a Civilă, de Contencios Administrativ şi Fiscal",
      "tip_tabel": "definitiv rectificativ",
      "extracted_at": "2026-09-23T12:30:25Z",
      "creditori": [
        {
          "nume": "Creditor exemplu 9 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 10",
          "categorie": "garantata",
          "garantii": "Art. 159 alin. (1) pct. 3 Legea 85/2014",
          "suma_declarata": null,
          "suma_admisa": 118853.79,
          "procent": null,
          "observatii": "Observațiile administratorului judiciar."
        },
        {
          "nume": "Creditor exemplu 11 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 12",
          "categorie": "garantata",
          "garantii": "Art. 159 alin. (1) pct. 3 Legea 85/2014",
          "suma_declarata": null,
          "suma_admisa": 243000,
          "procent": null,
          "observatii": null
        },
        {
          "nume": "Creditor exemplu 13 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 14",
          "categorie": "garantata",
          "garantii": "Art. 159 alin. (1) pct. 3 Legea 85/2014",
          "suma_declarata": null,
          "suma_admisa": 86062,
          "procent": null,
          "observatii": null
        }
      ],
      "creditori_potriviti": [
        {
          "nume": "Creditor exemplu 15 SRL",
          "nume_key": "CREDITOR EXEMPLU SRL 16",
          "categorie": "chirografara",
          "garantii": null,
          "suma_declarata": null,
          "suma_admisa": 176233.88,
          "procent": null,
          "observatii": "Observațiile administratorului judiciar."
        }
      ]
    }
  ],
  "cost": {
    "credite_consumate": 2,
    "mod": "per_rezultat",
    "tip": "premium"
  }
}

Erori și limite

Ce face integrarea la fiecare eroare

Fiecare cod are o reacție clară: unele se reîncearcă automat, restul înseamnă configurare, credite sau date lipsă. Erorile nu consumă credite.

401AUTH_MISSING_KEY · AUTH_INVALID_KEY · AUTH_KEY_EXPIRED

Cheia lipsește, e greșită sau a expirat.

Eroare de configurare: loghează și verifică FIRMEAPI_KEY.

Reîncearcă: nu

403PREMIUM_INSUFFICIENT_CREDITS

Rezultatele paginii costă mai mult decât creditele disponibile.

Răspunsul spune costul cererii și soldul: cere mai puține rezultate (per_pagina mai mic) sau cumpără credite.

Reîncearcă: nu

403PREMIUM_REQUIRES_PAID_SUBSCRIPTION

Contul nu are abonament plătit.

Mesaj către utilizator cu linkul din upgrade_url.

Reîncearcă: nu

403ACCESS_DENIED_IP · ACCESS_DENIED_SCOPE

Cheia e limitată la alte IP-uri sau endpoint-uri.

Eroare de configurare a cheii, din contul FirmeAPI.

Reîncearcă: nu

403MONTHLY_LIMIT_REACHED

Planul gratuit și-a atins limita lunară de cereri.

Mesaj către utilizator cu linkul din upgrade_url.

Reîncearcă: nu

404—

Nu există date pentru cheia cerută.

Afișează „fără date”. Păstrează în cache scurt (de exemplu o oră).

Reîncearcă: nu

422VALIDATION_FAILED

Un filtru invalid sau lipsește un parametru obligatoriu.

Arată eroarea din errors, pe câmp. Validează înainte de cerere.

Reîncearcă: nu

429LIMIT_EXCEEDED_SECOND

Prea multe cereri într-o secundă.

Așteaptă retry_after secunde și reia cererea.

Reîncearcă: da

429LIMIT_EXCEEDED_DAILY · LIMIT_EXCEEDED_MONTHLY

Limita zilnică sau lunară a planului.

Oprește cererile până la retry_after și anunță utilizatorul.

Reîncearcă: nu

500—

Eroare neașteptată pe server.

Reîncearcă de cel mult 3 ori, la 1, 2 și 4 secunde.

Reîncearcă: da

Corpul erorii: {"success": false, "error": "…", "code": "…", "message": "…"}. Decide după statusul HTTP și code, nu după text. Nicio eroare nu consumă credite.

Header-e de răspuns

X-Credit-Cost
Creditele consumate de cerere.
X-Credit-Type
Tipul creditelor folosite de endpoint.
X-Credit-Balance-General
Soldul de credite generale.
X-Credit-Balance-{TIP}
Soldul pentru tipul cererii, când nu e general (de exemplu X-Credit-Balance-ACTIONARI).
X-RateLimit-Limit-Second · -Day · -Month
Limitele planului.
X-RateLimit-Remaining-Second · -Day · -Month
Cât a mai rămas din fiecare limită.

Utilizare

Unde îl folosesc clienții

  • 01

    Recuperarea creanțelor: vezi rangul și suma admisă

  • 02

    Expunerea unei bănci sau a unui furnizor la firme în insolvență

  • 03

    Due diligence pentru achiziția de creanțe

  • 04

    Analiza structurii datoriilor

FAQ

Întrebări frecvente

Nu găsești răspunsul? Scrie-ne.

Cât costă API-ul Insolvență — Tabelele creditorilor?

/api/v1/bpi/creditori/{cui}: 1 credit fix PREMIUM; /api/v1/bpi/creditori/lista: 1 credit / rezultat PREMIUM. Căutările cu filtre se taxează pe rezultat: creditele consumate = rezultatele întoarse × prețul endpoint-ului, deci o pagină de 20 costă de zece ori mai puțin decât una de 200. Erorile și răspunsurile fără date (404 sau zero rezultate) nu consumă credite și nu scad din plafonul zilnic. Creditele premium sunt incluse în abonamentele plătite și se pot cumpăra separat.

De unde provin datele?

Publicațiile de insolvență (ONRC), extragere automată FirmeAPI. Peste 200.000 de tabele de creanțe, majoritatea din 2024–2026.

Ce înseamnă un câmp null?

Că sursa nu precizează informația pentru acel rând. Nu completăm golurile cu valori deduse.

La ce trebuie să fiu atent când folosesc datele?

PDF-ul original al publicației se ia separat, cu GET /api/v1/bpi/{cui}/{numar_bpi}/sursa: 3 credite premium per fișier livrat, fiecare descărcare se taxează. Sursele sunt disponibile pentru publicațiile din 2026; pentru restul, câmpul are_pdf e false și documentele se procesează. NU aduna tabelele între ele: un dosar își republică tabelul (preliminar, definitiv, consolidat, rectificat) și fiecare repetă aceleași datorii. Ia un singur tabel per dosar: cel mai recent, iar la aceeași dată cel mai consolidat (definitiv consolidat > definitiv > preliminar). Creditorii nu au cod fiscal în tabele, deci potrivirea se face după nume. Două direcții fiscale locale pot avea chei apropiate. Sumele sunt în lei, cum apar în tabel.

Pot limita o cheie API doar la aceste endpoint-uri?

Da. La Chei API → Acces alegi „Doar ce aleg eu” și bifezi endpoint-urile dorite; restul primesc 403 ACCESS_DENIED_SCOPE pentru acea cheie.

Funcționează și prin MCP (Claude, ChatGPT, Cursor)?

Da. Fiecare endpoint e disponibil ca tool MCP (bpi_creditori, bpi_creditori_cauta), cu același cost.

Integrează Insolvență — Tabelele creditorilor

Cont gratuit, cheia API imediat. Plătești doar cererile reușite; 404 și erorile nu consumă credite.