Documentație

API Monitorul Oficial

Integrează datele din Monitorul Oficial, Partea a IV-a direct în aplicațiile tale: caută firme după CUI sau denumire, listează publicările unei firme și citește conținutul documentelor, programatic, cu o cheie API.

Generează o cheie API Vezi abonamentele

Pornire rapidă

Alege un abonament care include Acces API din pagina Abonamente.
Generează o cheie din Acces API (tokenul e afișat o singură dată, păstrează-l în siguranță).
Trimite cheia în antetul fiecărei cereri: Authorization: Bearer dmof_… (sau X-API-Key).

URL de bază: https://www.datemof.ro/api/public/v1

Kituri SDK & colecții

Descarcă o colecție Postman gata de folosit sau specificația OpenAPI, din care poți genera un SDK în orice limbaj (de ex. cu openapi-generator).

Colecție PostmanImportă în Postman și începe să testezi în câteva secunde.Specificație OpenAPI 3Generează SDK-uri pentru orice limbaj din contractul API.

Exemple de cod

# Caută firme după CUI sau denumire
curl "https://www.datemof.ro/api/public/v1/companies?q=46180740" \
  -H "Authorization: Bearer $DATEMOF_API_KEY"

# Listează documentele firmei
curl "https://www.datemof.ro/api/public/v1/companies/46180740/documents?page=1" \
  -H "Authorization: Bearer $DATEMOF_API_KEY"

# Citește conținutul unui document (numarul vine din raspunsul de listare)
curl "https://www.datemof.ro/api/public/v1/companies/46180740/documents/1816849894" \
  -H "Authorization: Bearer $DATEMOF_API_KEY"

Endpointuri

GET/companies?q={cui_sau_denumire}

Caută firme

Caută firme după denumire sau CUI (un șir doar din cifre este tratat ca CUI). Parametru opțional „limit" (1–50).

GET/companies/{cui}/documents

Listează documentele unei firme

Publicările firmei din Monitorul Oficial, paginat (25/pagină). Parametri opționali „page" și „q" (caută în titlu/conținut).

GET/companies/{cui}/documents/{numar}

Citește conținutul unui document

Conținutul documentului (date personale mascate GDPR), validând că aparține firmei cu acel CUI. „numar" este valoarea din câmpul „numar" returnat de endpointul de listare (un număr mare, nu un id mic).

Exemplu de răspuns (căutare firme):

{
  "data": [
    {
      "cui": "46180740",
      "slug": "cloudzero-srl",
      "denumire": "CLOUDZERO S.R.L.",
      "nr_reg_com": "J12/2983/2022",
      "tip": "SRL",
      "status": "FUNCTIONAL",
      "address": { "judet": "Cluj", "localitate": "Florești", "strada": "Șesul de Sus", "numar": "184A", "cod_postal": null }
    }
  ]
}

Limite & erori

Fiecare apel consumă din cota lunară a abonamentului (vizibilă în Acces API). Se aplică și o limită de 120 de cereri pe minut. Răspunsurile de eroare au forma { "message": "..." }.

Cod	Semnificație
401	Cheie API lipsă, invalidă sau revocată.
403	Abonamentul nu include accesul la API.
404	Firmă sau document inexistent.
422	Parametri invalizi (ex. „q" prea scurt).
429	Cotă lunară de cereri atinsă sau prea multe cereri pe minut.

Gata să integrezi?

Generează o cheie și fă primul apel în câteva minute.

Generează o cheie API