API

Documentație API

API-ul registrul.md oferă date despre companii din Republica Moldova. Accesul necesită o cheie API și un abonament Business sau Agency activ.

Cine are acces

Doar conturile cu abonament Business sau Agency activ pot crea chei și apela endpoint-urile /api/v1/*. Planurile Free și Starter nu includ API.

Business — limită medie (60/min)
Agency — limită ridicată (300/min)

Vezi planurile și prețurile

Crearea cheii API

La activarea abonamentului Business/Agency se creează automat o cheie (dacă nu ai deja una). Ai maxim o cheie activă — pentru rotație, revocă sau folosește Regenerează. Cheia completă (prefix reg_) se afișează o singură dată.

Gestionează cheia API

Autentificare

Trimite cheia prin unul din header-ele următoare (oricare este suficient):

Authorization: Bearer reg_…
X-Api-Key: reg_…

Cheile încep întotdeauna cu reg_. Fără cheie validă, cererea este respinsă cu 401.

Endpoint

URL de bază: https://registrul.md

GET /api/v1/company/{idno}

Înlocuiește {idno} cu IDNO-ul companiei (doar cifre, minim 10). Răspunsul include date de bază, fondatori, administratori și coduri CAEM.

Exemple curl

curl -s \
  -H "Authorization: Bearer reg_YOUR_API_KEY" \
  "https://registrul.md/api/v1/company/1025600022949"

curl -s \
  -H "X-Api-Key: reg_YOUR_API_KEY" \
  "https://registrul.md/api/v1/company/1025600022949"

Exemplu răspuns JSON

Forma reală a răspunsului (câmpurile founders / admins / caem variază pe companie):

{
  "idno": "1025600022949",
  "name": "Societatea cu Răspundere Limitată \"FIX MOTORS GO\"",
  "legal_form": "S.R.L.",
  "status": "activa",
  "reg_date": "2025-07-04",
  "address": "MD-2002, CHIȘINĂU BOTANICA, mun. Chișinău, Plaiului, 128, ap.(of.) 2",
  "region": "110",
  "capital": "…",
  "vat_payer": false,
  "caem_main": "5320",
  "url": "https://registrul.md/companie/…",
  "founders": [
    { "name": "…", "share": "100,00%", "type": "persoana_fizica" }
  ],
  "admins": ["…"],
  "caem": [
    { "code": "5320", "label": "…", "main": true }
  ]
}

Limite de rată

Limitele se aplică per cheie API, pe o fereastră rulantă de 60 de secunde. Tier-ul efectiv urmează planul activ (nu valoarea stocată pe cheie).

Plan	Tier	Limită
Business	medium	60 cereri / minut
Agency	high	300 cereri / minut

La succes, răspunsul include X-RateLimit-Limit și X-RateLimit-Tier. La 429: Retry-After: 60.

Coduri de eroare

HTTP	error	Semnificație
401	missing_or_invalid_api_key	Cheie lipsă, invalidă sau revocată
403	no_active_api_plan	Cont fără plan API activ (Business/Agency)
400	invalid_idno	IDNO invalid (prea scurt sau fără cifre suficiente)
404	not_found	Compania nu a fost găsită
429	rate_limited	Limită de rată depășită — așteaptă și reîncearcă

Securitate

Cheia completă se arată o singură dată la creare — copiaz-o imediat.
Revocă sau regenerează imediat cheia compromisă din /cont/api.
Nu commit-ui chei în git, nu le pune în frontend public și nu le partaja în chat-uri.
Widget-ul public (/api/widget/…) este separat și nu folosește chei API — nu-l confunda cu /api/v1/.