InsolvențăCredite premium · 1 credit

API Insolvență — Vânzări și licitații

Anunțurile de vânzare din dosarele de insolvență transformate în loturi filtrabile: ce se vinde (mobil, imobil, în bloc, creanțe), prețul de pornire cu moneda și TVA, data, ora și locul licitației, garanția, runda și datele de contact ale lichidatorului. Include și rezultatul: licitații fără oferte, amânate sau adjudecate, cu cumpărătorul și prețul obținut.

GET/api/v1/bpi/vanzari/{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
23 câmpuriexplicate mai jos
GET/api/v1/bpi/vanzari/24112036
X-API-KEY: CHEIA_TA_API
{
  "success": true,
  "cui": "24112036",
  "sursa": "Buletinul Procedurilor de Insolvență (ONRC), extragere automată FirmeAPI",
  "total": 3,
  "rezultate": [
    {
      "cui": "24112036",
      "numar_bpi": "22570/2026",
      "numar_dosar": "2158/100/2025",
      "data": "2026-09-16",
      "titlu_document": "Publicaţie de vânzare – imobil + teren, nr. 717, din data de 15-09-2026, Tribunalul Maramureş, Secţia a II-a Civilă, de Contencios Administrativ şi Fiscal",
      "fel_document": "publicatie",
      "tip_vanzare": "licitatie publica cu strigare",
      "data_licitatie": "2026-09-25",
      "ora": "12:00",
      "loc": "sediul administratorului judiciar",
      "garantie": "10% din valoarea de începere a licitației",
      "lichidator": {
        "nume": "Cabinet Individual de Insolvență Exemplu",
        "telefon": "07xx xxx xxx",
        "email": null,
        "unpir": "RFO I-2136"
      },
      "loturi": [
        {
          "nr": null,
          "descriere": "imobil comercial compus din teren în suprafață de 683 mp și construcție Showroom cu suprafața construită de 453 mp, înscris în CF nr. 105046 Baia Mare, nr. cad. 105046, 105036 – teren, respectiv 105046 – C1 – Centrala…",
          "pret": 459000,
          "moneda": "EUR",
          "tva_inclus": true,
          "fel": "in bloc"
        }
      ],
      "judet": "MARAMUREŞ",
      "localitate": "Sat Şurdeşti Com. Şişeşti",
      "debitor": "RIMINI CONSTRUCT SRL",
      "extracted_at": "2026-09-20T04:59:18Z"
    },
    {
      "cui": "24112036",
      "numar_bpi": "21701/2026",
      "numar_dosar": "2158/100/2025",
      "data": "2026-09-04",
      "titlu_document": "Proces verbal al şedinţei adunării creditorilor, nr. 705, din data de 04-09-2026, Tribunalul Maramureş, Secţia a II-a Civilă, de Contencios Administrativ şi Fiscal",
      "fel_document": "licitatie",
      "lichidator": {
        "nume": "Cabinet Individual de Insolvență Exemplu",
        "telefon": "07xx xxx xxx",
        "email": null,
        "unpir": "RFO I-2136"
      },
      "loturi": [
        {
          "nr": null,
          "descriere": "Teren + Showroom din averea debitoarei Rimini Construct SRL",
          "pret": null,
          "moneda": null,
          "tva_inclus": null,
          "fel": "imobil"
        }
      ],
      "judet": "MARAMUREŞ",
      "localitate": "Sat Şurdeşti Com. Şişeşti",
      "debitor": "RIMINI CONSTRUCT SRL",
      "extracted_at": "2026-09-20T05:24:26Z"
    },
    {
      "cui": "24112036",
      "numar_bpi": "20956/2026",
      "numar_dosar": "2158/100/2025",
      "data": "2026-08-25",
      "titlu_document": "Hotărâre, nr. 684, din data de 21-08-2026, Tribunalul Maramureş, Secţia a II-a Civilă, de Contencios Administrativ şi Fiscal",
      "fel_document": "licitatie",
      "tip_vanzare": "licitatie publica cu strigare",
      "garantie": "10% din pretul de pornire",
      "lichidator": {
        "nume": "Cabinet Individual de Insolvență Exemplu",
        "telefon": "07xx xxx xxx",
        "email": null,
        "unpir": "RFO I-2136"
      },
      "loturi": [
        {
          "nr": null,
          "descriere": "Imobil comercial compus din teren în suprafaţă totală de 683 mp (453 mp + 230 mp) şi construcţia C1 - Showroom şi birouri (fosta Centrală termică 35), regim P+Mez, situat în Baia Mare, B-dul Traian nr. 11A, județul Ma…",
          "pret": 459000,
          "moneda": "EUR",
          "tva_inclus": true,
          "fel": "imobil"
        }
      ],
      "judet": "MARAMUREŞ",
      "localitate": "Sat Şurdeşti Com. Şişeşti",
      "debitor": "RIMINI CONSTRUCT SRL",
      "extracted_at": "2026-09-20T05:32:23Z"
    }
  ]
}
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ță — Vânzări și licitații

Bunurile scoase la vânzare: loturi, preț de pornire, data licitației, lichidatorul și rezultatul.

Anunțurile de vânzare din dosarele de insolvență transformate în loturi filtrabile: ce se vinde (mobil, imobil, în bloc, creanțe), prețul de pornire cu moneda și TVA, data, ora și locul licitației, garanția, runda și datele de contact ale lichidatorului. Include și rezultatul: licitații fără oferte, amânate sau adjudecate, cu cumpărătorul și prețul obținut.

Sursa
Publicațiile de insolvență (ONRC), extragere automată FirmeAPI
Credite
Premium — necesită abonament plătit sau pachet premium
Acoperire
Peste 120.000 de documente legate de vânzări. Județul și localitatea sunt ale debitorului (din registrul firmelor), nu neapărat ale bunului.

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ă.
Doar anunțurile (publicatie, licitatie) fără rezultat sunt bunuri care încă se pot cumpăra. Un proces-verbal sau o adjudecare nu mai sunt oferte — folosește doar_active=true pentru vitrină.
Prețurile nu sunt convertite: 239.210 EUR + TVA rămâne pret=239210, moneda=EUR, tva_inclus=false.
Jumătate dintre anunțuri nu au loturi extrase (regulamente fără bunuri sau prețuri exprimate procentual, cu bunurile în anexe).
Rândurile fără data_licitatie au momentul licitației necunoscut.

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ță — Vânzări și licitații FirmeAPI.ro.

Citește întâi ghidul complet de implementare:
https://www.firmeapi.ro/info-api/bpi-vanzari.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

Vânzările unei firme în insolvență#

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

Toate documentele de vânzare ale debitorului: anunțuri, regulamente, procese-verbale și adjudecări, de la cel mai recent.

Parametri

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

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 debitorului ale cărui bunuri se vând.
rezultate[].debitorstring
Denumirea oficială a debitorului (din registrul firmelor).
rezultate[].numar_bpistring
Publicația de insolvență sursă.
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ță, când e menționat.
rezultate[].datadate
Data publicării documentului.
rezultate[].titlu_documentstring
Titlul documentului publicat.
rezultate[].fel_documentstring
Etapa: publicatie (anunțul), licitatie, regulament, proces_verbal (sesiunea a avut loc), adjudecare (bunul s-a vândut).
rezultate[].rezultatstring|null
fara_oferte, adjudecat, amanat, anulat. Null la anunțuri, care nu au încă rezultat.
rezultate[].tip_vanzarestring|null
Modalitatea, în cuvintele documentului (ex. licitatie publica cu strigare). Nu e normalizat.
rezultate[].data_licitatiedate|null
Data la care se ține licitația.
rezultate[].orastring|null
Ora licitației.
rezultate[].locstring|null
Locul licitației, cum e scris.
rezultate[].rundainteger|null
Runda licitației (1, 2, …).
rezultate[].garantiestring|null
Garanția de participare, cum e scrisă (ex. 10% din prețul de pornire).
rezultate[].pret_dosarstring|null
Costul caietului de sarcini.
rezultate[].lichidatorobject|null
Lichidatorul: nume, telefon, email, unpir (numărul din registrul practicienilor).
rezultate[].loturiarray
Loturile scoase la vânzare.
rezultate[].loturi[].descrierestring
Ce se vinde, cum e descris.
rezultate[].loturi[].felstring
mobil, imobil, in bloc, creante.
rezultate[].loturi[].pretnumber|null
Prețul de pornire, NECONVERTIT, în moneda lotului.
rezultate[].loturi[].monedastring|null
RON sau EUR.
rezultate[].loturi[].tva_inclusboolean|null
false când prețul e „+ TVA”.
rezultate[].loturi[].nrstring|null
Numărul lotului.
rezultate[].adjudecareobject|null
Doar când bunul s-a vândut: cumparator, pret, moneda, data, evaluare.
rezultate[].judetstring
Județul debitorului.
rezultate[].localitatestring
Localitatea debitorului.
rezultate[].extracted_atdatetime
Momentul extragerii.
curl -X GET "https://www.firmeapi.ro/api/v1/bpi/vanzari/24112036" \
  -H "X-API-KEY: CHEIA_TA_API" \
  -H "Accept: application/json"

200 OK · se taxează 1 credit fix premium

{
  "success": true,
  "cui": "24112036",
  "sursa": "Buletinul Procedurilor de Insolvență (ONRC), extragere automată FirmeAPI",
  "total": 3,
  "rezultate": [
    {
      "cui": "24112036",
      "numar_bpi": "22570/2026",
      "numar_dosar": "2158/100/2025",
      "data": "2026-09-16",
      "titlu_document": "Publicaţie de vânzare – imobil + teren, nr. 717, din data de 15-09-2026, Tribunalul Maramureş, Secţia a II-a Civilă, de Contencios Administrativ şi Fiscal",
      "fel_document": "publicatie",
      "tip_vanzare": "licitatie publica cu strigare",
      "data_licitatie": "2026-09-25",
      "ora": "12:00",
      "loc": "sediul administratorului judiciar",
      "garantie": "10% din valoarea de începere a licitației",
      "lichidator": {
        "nume": "Cabinet Individual de Insolvență Exemplu",
        "telefon": "07xx xxx xxx",
        "email": null,
        "unpir": "RFO I-2136"
      },
      "loturi": [
        {
          "nr": null,
          "descriere": "imobil comercial compus din teren în suprafață de 683 mp și construcție Showroom cu suprafața construită de 453 mp, înscris în CF nr. 105046 Baia Mare, nr. cad. 105046, 105036 – teren, respectiv 105046 – C1 – Centrala…",
          "pret": 459000,
          "moneda": "EUR",
          "tva_inclus": true,
          "fel": "in bloc"
        }
      ],
      "judet": "MARAMUREŞ",
      "localitate": "Sat Şurdeşti Com. Şişeşti",
      "debitor": "RIMINI CONSTRUCT SRL",
      "extracted_at": "2026-09-20T04:59:18Z"
    },
    {
      "cui": "24112036",
      "numar_bpi": "21701/2026",
      "numar_dosar": "2158/100/2025",
      "data": "2026-09-04",
      "titlu_document": "Proces verbal al şedinţei adunării creditorilor, nr. 705, din data de 04-09-2026, Tribunalul Maramureş, Secţia a II-a Civilă, de Contencios Administrativ şi Fiscal",
      "fel_document": "licitatie",
      "lichidator": {
        "nume": "Cabinet Individual de Insolvență Exemplu",
        "telefon": "07xx xxx xxx",
        "email": null,
        "unpir": "RFO I-2136"
      },
      "loturi": [
        {
          "nr": null,
          "descriere": "Teren + Showroom din averea debitoarei Rimini Construct SRL",
          "pret": null,
          "moneda": null,
          "tva_inclus": null,
          "fel": "imobil"
        }
      ],
      "judet": "MARAMUREŞ",
      "localitate": "Sat Şurdeşti Com. Şişeşti",
      "debitor": "RIMINI CONSTRUCT SRL",
      "extracted_at": "2026-09-20T05:24:26Z"
    },
    {
      "cui": "24112036",
      "numar_bpi": "20956/2026",
      "numar_dosar": "2158/100/2025",
      "data": "2026-08-25",
      "titlu_document": "Hotărâre, nr. 684, din data de 21-08-2026, Tribunalul Maramureş, Secţia a II-a Civilă, de Contencios Administrativ şi Fiscal",
      "fel_document": "licitatie",
      "tip_vanzare": "licitatie publica cu strigare",
      "garantie": "10% din pretul de pornire",
      "lichidator": {
        "nume": "Cabinet Individual de Insolvență Exemplu",
        "telefon": "07xx xxx xxx",
        "email": null,
        "unpir": "RFO I-2136"
      },
      "loturi": [
        {
          "nr": null,
          "descriere": "Imobil comercial compus din teren în suprafaţă totală de 683 mp (453 mp + 230 mp) şi construcţia C1 - Showroom şi birouri (fosta Centrală termică 35), regim P+Mez, situat în Baia Mare, B-dul Traian nr. 11A, județul Ma…",
          "pret": 459000,
          "moneda": "EUR",
          "tva_inclus": true,
          "fel": "imobil"
        }
      ],
      "judet": "MARAMUREŞ",
      "localitate": "Sat Şurdeşti Com. Şişeşti",
      "debitor": "RIMINI CONSTRUCT SRL",
      "extracted_at": "2026-09-20T05:32:23Z"
    }
  ]
}

Caută bunuri scoase la vânzare#

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

Vitrina licitațiilor: filtrează după ce se vinde, tipul lotului, preț, monedă, județ, data licitației sau lichidator. Cu doar_active=true primești doar anunțurile la care încă se poate licita. Loturile care se potrivesc sunt întoarse separat în loturi_potrivite.

Parametri

qstring· query
Ce se vinde (ex. „teren intravilan”, „excavator”, „hală”). ex.: teren intravilan
felstring· query
Tipul lotului. mobilimobilin bloccreante
monedastring· query
Moneda prețului. RONEUR
pret_minnumber· query
Preț de pornire minim (în moneda lotului).
pret_maxnumber· query
Preț de pornire maxim (în moneda lotului). ex.: 100000
judetstring· query
Județul debitorului (cu sau fără diacritice). ex.: Cluj
localitatestring· query
Localitatea debitorului.
fel_documentstring· query
Etapa vânzării. publicatielicitatieregulamentproces_verbaladjudecare
rezultatstring· query
Rezultatul sesiunii (doar pe procese-verbale și adjudecări). fara_oferteadjudecatamanatanulat
lichidatorstring· query
Numele lichidatorului.
cuistring· query
Doar vânzările unui debitor.
doar_activeboolean· query
true = doar anunțurile (publicatie/licitatie) fără rezultat, cu licitația azi sau în viitor. ex.: true
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
licitatie_dedate (AAAA-LL-ZZ)· query
De la această dată (data_licitatie ≥), format AAAA-LL-ZZ. ex.: 2026-01-01
licitatie_panadate (AAAA-LL-ZZ)· query
Până la această dată (data_licitatie ≤), 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). recentelicitatieex.: 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 debitorului ale cărui bunuri se vând.
rezultate[].debitorstring
Denumirea oficială a debitorului (din registrul firmelor).
rezultate[].numar_bpistring
Publicația de insolvență sursă.
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ță, când e menționat.
rezultate[].datadate
Data publicării documentului.
rezultate[].titlu_documentstring
Titlul documentului publicat.
rezultate[].fel_documentstring
Etapa: publicatie (anunțul), licitatie, regulament, proces_verbal (sesiunea a avut loc), adjudecare (bunul s-a vândut).
rezultate[].rezultatstring|null
fara_oferte, adjudecat, amanat, anulat. Null la anunțuri, care nu au încă rezultat.
rezultate[].tip_vanzarestring|null
Modalitatea, în cuvintele documentului (ex. licitatie publica cu strigare). Nu e normalizat.
rezultate[].data_licitatiedate|null
Data la care se ține licitația.
rezultate[].orastring|null
Ora licitației.
rezultate[].locstring|null
Locul licitației, cum e scris.
rezultate[].rundainteger|null
Runda licitației (1, 2, …).
rezultate[].garantiestring|null
Garanția de participare, cum e scrisă (ex. 10% din prețul de pornire).
rezultate[].pret_dosarstring|null
Costul caietului de sarcini.
rezultate[].lichidatorobject|null
Lichidatorul: nume, telefon, email, unpir (numărul din registrul practicienilor).
rezultate[].loturiarray
Loturile scoase la vânzare.
rezultate[].loturi[].descrierestring
Ce se vinde, cum e descris.
rezultate[].loturi[].felstring
mobil, imobil, in bloc, creante.
rezultate[].loturi[].pretnumber|null
Prețul de pornire, NECONVERTIT, în moneda lotului.
rezultate[].loturi[].monedastring|null
RON sau EUR.
rezultate[].loturi[].tva_inclusboolean|null
false când prețul e „+ TVA”.
rezultate[].loturi[].nrstring|null
Numărul lotului.
rezultate[].adjudecareobject|null
Doar când bunul s-a vândut: cumparator, pret, moneda, data, evaluare.
rezultate[].judetstring
Județul debitorului.
rezultate[].localitatestring
Localitatea debitorului.
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/vanzari/lista?fel=imobil&judet=Cluj&doar_active=true" \
  -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": 1,
  "total_pagini": 1,
  "rezultate": [
    {
      "cui": "199206",
      "numar_bpi": "20537/2026",
      "numar_dosar": "1158/1285/2022",
      "data": "2026-08-18",
      "titlu_document": "Document, nr. 105, din data de 18-08-2026, Tribunalul Specializat Cluj",
      "fel_document": "licitatie",
      "tip_vanzare": "licitatie pe baza de oferte",
      "data_licitatie": "2026-09-29",
      "loc": "ofertele se comunică prin poștă la adresa Târgoviște, str. Calea București, nr. 3A, ap. 2, Dâmbovița sau pe email",
      "pret_dosar": "900,00 lei fără TVA (caietul de sarcini); taxa de participare 500,00 lei (încălțăminte)",
      "lichidator": {
        "nume": "Cabinet Individual de Insolvență Exemplu",
        "telefon": "07xx xxx xxx",
        "email": "[email protected]",
        "unpir": null
      },
      "loturi": [
        {
          "nr": null,
          "descriere": "acțiunile deținute de societatea Clujana SA în Faliment la alți profesioniști",
          "pret": null,
          "moneda": null,
          "tva_inclus": null,
          "fel": null
        },
        {
          "nr": null,
          "descriere": "marca societății Clujana SA, marcă înregistrată",
          "pret": null,
          "moneda": null,
          "tva_inclus": null,
          "fel": null
        },
        {
          "nr": null,
          "descriere": "1.379 perechi de încălțăminte fabricate de Clujana SA",
          "pret": null,
          "moneda": null,
          "tva_inclus": null,
          "fel": "mobil"
        }
      ],
      "judet": "CLUJ",
      "localitate": "Mun. Cluj-Napoca",
      "debitor": "CLUJANA S.A.",
      "extracted_at": "2026-09-20T05:36:26Z",
      "loturi_potrivite": [
        {
          "nr": null,
          "descriere": "Teren intravilan înscris în CF 269868, str. Pâinii, nr. 20, Cluj Napoca, 3.667 mp",
          "pret": 698380.15,
          "moneda": "EUR",
          "tva_inclus": null,
          "fel": "imobil"
        },
        {
          "nr": null,
          "descriere": "Teren intravilan înscris în CF 260663, Cluj Napoca, str. Tăbăcarilor, nr. 9, 323 mp",
          "pret": 72012.85,
          "moneda": "EUR",
          "tva_inclus": null,
          "fel": "imobil"
        },
        {
          "nr": null,
          "descriere": "Teren intravilan înscris în CF 325747, Cluj Napoca, 650 mp",
          "pret": 56192.5,
          "moneda": "EUR",
          "tva_inclus": null,
          "fel": "imobil"
        }
      ]
    }
  ],
  "cost": {
    "credite_consumate": 1,
    "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

    Investitori și dealeri care cumpără active din insolvență

  • 02

    Alerte pentru imobile sub un anumit preț într-un județ

  • 03

    Analiza discountului: preț de pornire vs. evaluare vs. preț obținut

  • 04

    Contactarea lichidatorului

FAQ

Întrebări frecvente

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

Cât costă API-ul Insolvență — Vânzări și licitații?

/api/v1/bpi/vanzari/{cui}: 1 credit fix PREMIUM; /api/v1/bpi/vanzari/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 120.000 de documente legate de vânzări. Județul și localitatea sunt ale debitorului (din registrul firmelor), nu neapărat ale bunului.

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ă. Doar anunțurile (publicatie, licitatie) fără rezultat sunt bunuri care încă se pot cumpăra. Un proces-verbal sau o adjudecare nu mai sunt oferte — folosește doar_active=true pentru vitrină. Prețurile nu sunt convertite: 239.210 EUR + TVA rămâne pret=239210, moneda=EUR, tva_inclus=false. Jumătate dintre anunțuri nu au loturi extrase (regulamente fără bunuri sau prețuri exprimate procentual, cu bunurile în anexe). Rândurile fără data_licitatie au momentul licitației necunoscut.

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_vanzari, bpi_vanzari_cauta), cu același cost.

Integrează Insolvență — Vânzări și licitații

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