API v1

DateBPI API

Acceseaza datele din Buletinul Procedurilor de Insolventa prin API-ul nostru REST. Integreaza alertele BPI direct in aplicatia ta.

Creeaza cont gratuit Documentatie

Rapid si fiabil

Timp mediu de raspuns sub 200ms. Date actualizate zilnic din surse oficiale BPI.

Autentificare securizata

Chei API unice cu rate limiting. Suport pentru medii de test si productie.

Usor de integrat

API REST standard cu raspunsuri JSON. Exemple in cURL, JavaScript, Python si PHP.

Incepe rapid

Creeaza un cont

Inregistreaza-te gratuit si alege un plan care include acces API.

Genereaza o cheie API

Din dashboard, genereaza o cheie API pentru mediul de test sau productie.

Trimite prima cerere

Foloseste cheia API in header-ul X-API-Key pentru a accesa datele BPI.

Prima ta cerere API

bash

curl -X GET "https://datebpi.ro/api/v1/bpi/documents?cui=12345678" \
  -H "X-API-Key: bpi_live_cheia_ta_api" \
  -H "Accept: application/json"

Autentificare

Toate cererile API trebuie autentificate folosind o cheie API. Cheia se transmite prin header-ul X-API-Key sau ca parametru query api_key.

Autentificare prin Header (recomandat)

bash

curl -X GET "https://datebpi.ro/api/v1/bpi/documents?cui=12345678" \
  -H "X-API-Key: bpi_live_cheia_ta_api" \
  -H "Accept: application/json"

Autentificare prin Query Parameter

bash

curl -X GET "https://datebpi.ro/api/v1/bpi/documents?cui=12345678&api_key=bpi_live_cheia_ta_api" \
  -H "Accept: application/json"

Rate Limiting

Fiecare plan are limite de utilizare. Header-ele de raspuns contin informatii despre limita curenta:

Header	Descriere
`X-RateLimit-Limit-Hour`	Numarul maxim de cereri pe ora
`X-RateLimit-Limit-Day`	Numarul maxim de cereri pe zi
`X-RateLimit-Remaining-Hour`	Cereri ramase in ora curenta
`X-RateLimit-Remaining-Day`	Cereri ramase in ziua curenta
`Retry-After`	Secunde pana la resetarea limitei (doar la 429)

Endpoints

URL de baza: https://datebpi.ro/api/v1

GET/bpi/documents GET/bpi/document/{cui}/{dosar}GET/bpi/search

GET/api/v1/bpi/documents

Returneaza lista documentelor BPI publicate pentru un CUI (Cod Unic de Identificare). Rezultatele sunt paginate si sortate descrescator dupa data publicarii.

Parametri

Parametru	Tip	Obligatoriu	Descriere
`cui`	string	Da	Codul Unic de Identificare al firmei (ex: 12345678)
`page`	integer	Nu	Numarul paginii (implicit: 1)
`per_page`	integer	Nu	Rezultate per pagina, maxim 100 (implicit: 20)

Exemple

cURL

bash

curl -X GET "https://datebpi.ro/api/v1/bpi/documents?cui=12345678&page=1&per_page=10" \
  -H "X-API-Key: bpi_live_cheia_ta_api" \
  -H "Accept: application/json"

JavaScript (fetch)

javascript

const response = await fetch(
  "https://datebpi.ro/api/v1/bpi/documents?cui=12345678&per_page=10",
  {
    headers: {
      "X-API-Key": "bpi_live_cheia_ta_api",
      "Accept": "application/json",
    },
  }
);

const data = await response.json();
console.log(data.documents);     // Lista documentelor BPI
console.log(data.company);       // Informatii firma
console.log(data.pagination);    // { total, page, per_page, last_page }

Python (requests)

python

import requests

response = requests.get(
    "https://datebpi.ro/api/v1/bpi/documents",
    params={"cui": "12345678", "per_page": 10},
    headers={"X-API-Key": "bpi_live_cheia_ta_api"}
)

data = response.json()
for doc in data["documents"]:
    print(f"{doc['numar_bpi']} - {doc['titlu_document']}")

PHP (cURL)

php

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://datebpi.ro/api/v1/bpi/documents?cui=12345678&per_page=10",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "X-API-Key: bpi_live_cheia_ta_api",
        "Accept: application/json",
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
foreach ($data['documents'] as $doc) {
    echo $doc['numar_bpi'] . ' - ' . $doc['titlu_document'] . PHP_EOL;
}

Raspuns (200 OK)

Exemplu raspuns

json

{
  "success": true,
  "company": {
    "cui": "12345678",
    "denumire": "SC EXEMPLU SRL",
    "forma_juridica": "SRL",
    "judet": "Bucuresti"
  },
  "documents": [
    {
      "id": "abc123",
      "numar_bpi": "12345/2026",
      "data": "2026-04-10",
      "numar_dosar": "1234/3/2026",
      "titlu_document": "Notificare deschidere procedura insolventa"
    }
  ],
  "pagination": {
    "total": 5,
    "page": 1,
    "per_page": 10,
    "last_page": 1
  }
}

GET/api/v1/bpi/document/{cui}/{dosar}

Returneaza detaliile complete ale unui document BPI, inclusiv continutul HTML al documentului, informatii despre firma si datele dosarului de instanta asociat.

Parametri

Parametru	Tip	Obligatoriu	Descriere
`cui`	string	Da	CUI-ul firmei (parametru in URL)
`dosar`	string	Da	Numarul dosarului (parametru in URL, ex: 1234/3/2026)

Exemple

cURL

bash

curl -X GET "https://datebpi.ro/api/v1/bpi/document/12345678/1234%2F3%2F2026" \
  -H "X-API-Key: bpi_live_cheia_ta_api" \
  -H "Accept: application/json"

# Nota: caracterul / din numarul dosarului trebuie encodat ca %2F

JavaScript (fetch)

javascript

const cui = "12345678";
const dosar = "1234/3/2026";

const response = await fetch(
  `https://datebpi.ro/api/v1/bpi/document/${cui}/${encodeURIComponent(dosar)}`,
  {
    headers: {
      "X-API-Key": "bpi_live_cheia_ta_api",
      "Accept": "application/json",
    },
  }
);

const data = await response.json();
console.log(data.document.content_html);     // Continut HTML complet
console.log(data.dosar_instanta);            // Date dosar instanta

Python (requests)

python

import requests
from urllib.parse import quote

cui = "12345678"
dosar = "1234/3/2026"

response = requests.get(
    f"https://datebpi.ro/api/v1/bpi/document/{cui}/{quote(dosar, safe='')}",
    headers={"X-API-Key": "bpi_live_cheia_ta_api"}
)

data = response.json()
print(data["document"]["titlu_document"])
print(data["dosar_instanta"]["stadiu"])  # Stadiul dosarului in instanta

Raspuns (200 OK)

Exemplu raspuns

json

{
  "success": true,
  "company": {
    "cui": "12345678",
    "denumire": "SC EXEMPLU SRL",
    "forma_juridica": "SRL",
    "adresa": "Str. Exemplu nr. 1, Bucuresti",
    "judet": "Bucuresti",
    "localitate": "Bucuresti",
    "cod_postal": "010101",
    "nr_reg_com": "J40/1234/2020"
  },
  "document": {
    "id": "abc123",
    "cui": "12345678",
    "numar_bpi": "12345/2026",
    "data": "2026-04-10",
    "numar_dosar": "1234/3/2026",
    "titlu_document": "Notificare deschidere procedura insolventa",
    "content_html": "<div>Continutul complet al documentului...</div>",
    "locatie_pdf": "/path/to/document.pdf"
  },
  "dosar_instanta": {
    "numar": "1234/3/2026",
    "data": "2026-03-15",
    "institutie": "Tribunalul Bucuresti",
    "departament": "Sectia a VII-a civila",
    "categorie": "Insolventa",
    "stadiu": "In curs de judecata",
    "obiect": "Deschidere procedura insolventa",
    "is_finished": false
  }
}

GET/api/v1/bpi/search

Cauta documente BPI dupa un cuvant cheie (denumire firma). Optional, filtreaza rezultatele incepand de la o anumita data.

Parametri

Parametru	Tip	Obligatoriu	Descriere
`query`	string	Da	Termenul de cautare (minim 3 caractere, ex: numele firmei)
`date`	date	Nu	Filtru data (format: YYYY-MM-DD). Returneaza doar documentele de dupa aceasta data
`page`	integer	Nu	Numarul paginii (implicit: 1)
`per_page`	integer	Nu	Rezultate per pagina, maxim 100 (implicit: 20)

Exemple

cURL

bash

# Cauta documente BPI pentru firme care contin "exemplu construct"
curl -X GET "https://datebpi.ro/api/v1/bpi/search?query=exemplu+construct&date=2026-01-01" \
  -H "X-API-Key: bpi_live_cheia_ta_api" \
  -H "Accept: application/json"

JavaScript (fetch)

javascript

const params = new URLSearchParams({
  query: "exemplu construct",
  date: "2026-01-01",
  per_page: "20",
});

const response = await fetch(
  `https://datebpi.ro/api/v1/bpi/search?${params}`,
  {
    headers: {
      "X-API-Key": "bpi_live_cheia_ta_api",
      "Accept": "application/json",
    },
  }
);

const data = await response.json();
data.results.forEach((doc) => {
  console.log(`CUI: ${doc.cui} | BPI: ${doc.numar_bpi} | ${doc.titlu_document}`);
});

Python (requests)

python

import requests

response = requests.get(
    "https://datebpi.ro/api/v1/bpi/search",
    params={
        "query": "exemplu construct",
        "date": "2026-01-01",
        "per_page": 20,
    },
    headers={"X-API-Key": "bpi_live_cheia_ta_api"}
)

data = response.json()
for doc in data["results"]:
    print(f"CUI: {doc['cui']} | BPI: {doc['numar_bpi']} | {doc['titlu_document']}")

Raspuns (200 OK)

Exemplu raspuns

json

{
  "success": true,
  "query": "exemplu construct",
  "date_filter": "2026-01-01",
  "results": [
    {
      "cui": "12345678",
      "numar_dosar": "1234/3/2026",
      "numar_bpi": "12345/2026",
      "data": "2026-04-10",
      "titlu_document": "Hotarare deschidere procedura insolventa"
    },
    {
      "cui": "87654321",
      "numar_dosar": "5678/2/2026",
      "numar_bpi": "12346/2026",
      "data": "2026-04-08",
      "titlu_document": "Notificare creditori"
    }
  ],
  "pagination": {
    "total": 2,
    "page": 1,
    "per_page": 20
  }
}

Coduri de eroare

Cod HTTP	Descriere	Solutie
`200`	Cerere reusita	-
`401`	Cheie API invalida sau lipsa	Verifica header-ul X-API-Key
`403`	Acces interzis (cheie revocata sau cont blocat)	Contacteaza suportul sau genereaza o cheie noua
`404`	Resursa nu a fost gasita	Verifica CUI-ul sau numarul dosarului
`422`	Eroare de validare (parametri invalizi)	Verifica parametrii cererii
`429`	Limita de cereri depasita	Asteapta conform header-ului Retry-After

Exemplu raspuns eroare

json

{
  "success": false,
  "error": "Document not found"
}

Pregatit sa integrezi datele BPI?

Creeaza un cont gratuit si genereaza prima ta cheie API in mai putin de 2 minute.

Creeaza cont gratuit