Documentație API

Acces programatic la datele dashiro pe două căi: API REST v1 (JSON, pentru scripturi și integrări) și server MCP (pentru asistenți AI — Claude, ChatGPT). Ambele sunt gratuite în limitele planului Gratuit; limite mai mari și acționariatul cu nume complete vin cu planurile Pro și Business.

Autentificare

Generează o cheie API din contul tău (gratuit, login cu Google) și trimite-o pe fiecare cerere:

Authorization: Bearer dsk_live_…

Cheia se afișează o singură dată la creare. Maxim 5 chei active; le poți revoca oricând din cont.

API REST v1

Bază: https://dashiro.ro/api/v1 · limite per cont (nu per cheie): 60 cereri/minut și 1.000/lună pe Gratuit, 120/min și 10.000/lună pe Pro, 300/min și 100.000/lună pe Business · răspunsuri JSON UTF-8, envelope { data: … } sau { error, mesaj }. Fiecare răspuns poartă X-Plan, X-RateLimit-Limit/Remaining/Reset (fereastra de un minut) și X-Quota-Limit/Remaining (luna curentă).

Endpoint	Ce întoarce
`GET /api/v1/firma/{cui}`	Profilul firmei: identificare, status ANAF, TVA, adresă, CAEN, website, logo
`GET /api/v1/firma/{cui}/bilant`	Bilanțurile multi-an: cifră de afaceri, rezultat net, angajați, active, datorii, capitaluri
`GET /api/v1/firma/{cui}/scoring`	Scoringul dashiro: scor 0–100, clasă A–E, risc, limită de credit recomandată
`GET /api/v1/cauta?q={text}`	Căutare după denumire sau CUI (max 10 rezultate)
`GET /api/v1/firma/{cui}/actionari`	PRO / BUSINESS — acționari și administratori cu NUME COMPLETE și cotă de participare, beneficiari reali estimați, participații și firme conexe

Exemplu

curl -H "Authorization: Bearer dsk_live_CHEIA_TA" \
  "https://dashiro.ro/api/v1/firma/336206"

{"data":{"denumire":"ZENTIVA SA","cui":"336206","status_anaf":"activa",
 "platitoare_tva":true,"judet":"București","caen":"2120", … }}

Coduri de răspuns: 200 OK · 400 parametru invalid · 401 cheie lipsă/invalidă · 403 plan insuficient (plan_required) · 404 negăsit · 429 rate_limited (pe minut, cu Retry-After) sau quota_exceeded (pe lună) · 502 sursa temporar indisponibilă. Erorile 403/429 includ câmpul upgrade cu linkul spre planuri.

Planuri

Ce primești	Gratuit	Pro · 49 lei/lună	Business · 199 lei/lună
Profil, bilanț, scoring, căutare	da	da	da
Limită REST (cereri/minut · cereri/lună)	60 · 1.000	120 · 10.000	300 · 100.000
Limită MCP	120 req/min	120 req/min	120 req/min
Nume complete: asociați, administratori, părți din dosare	da (cont)	da	da
Beneficiari reali (estimare ≥25%)	doar inițiale	nume complete	nume complete
Endpoint /actionari (acționariat + beneficiari, structurat)	—	da	da
Firme monitorizate · export CSV	10 · —	200 · da	1.000 · da
Licență de utilizare	uz intern	uz intern	produse derivate

Planurile se activează instant din /preturi (plată cu cardul, TVA inclus; cheile existente moștenesc planul, nu trebuie regenerate). Peste 100.000 cereri/lună, acces bulk sau redistribuire: Enterprise.

Beneficiari reali — ce înseamnă exact

Sunt persoanele fizice cu cel puțin 25% participație directă, derivate de dashiro din acționariatul înregistrat. Este o estimare — nu declarația de beneficiar real depusă la ONRC conform Legii 129/2019 — și nu acoperă deținerile indirecte, prin alte firme. Fiecare rând poartă estimare: true exact ca să nu poată fi prezentat ca document oficial.

Server MCP (asistenți AI)

Endpoint: https://dashiro.ro/mcp (Streamable HTTP). Fără autentificare primești 6 tools (30 cereri/min); cu cheia API primești 10 tools (120 cereri/min) și nume complete la dosare.

`cauta_firme`	căutare după denumire/CUI	public
`profil_firma`	identificare + status ANAF	public
`bilant_firma`	indicatori financiari multi-an	public
`scoring_firma`	scor de risc + limită credit	public
`dosare_firma`	dosare în instanță (inițiale; nume complete cu cheie)	public
`top_firme`	clasamente pe criterii financiare, opțional pe județ	public
`grup_firma`	acționariat cu cotă % + administratori + firme conexe + beneficiari reali (inițiale pe Gratuit, nume complete pe Pro/Business)	cu cheie
`urmareste_firma / anuleaza_urmarire / firme_urmarite`	monitorizare cu alerte pe email	cu cheie

Conectare din Claude

Claude (web/desktop): Settings → Connectors → Add custom connector → https://dashiro.ro/mcp. În Claude Code:

claude mcp add --transport http dashiro https://dashiro.ro/mcp \
  --header "Authorization: Bearer dsk_live_CHEIA_TA"   # opțional, pt tools extinse

Apoi întreabă natural: „verifică firma Dedeman", „ce dosare are AROBS Transilvania?".

Reguli de utilizare (licența)

Datele provin din surse publice oficiale și au caracter informativ. Numele persoanelor fizice se livrează public ca inițiale (GDPR); accesul la nume complete este legat de un cont identificat și, pentru beneficiarii reali, de un plan plătit.

Orice plan — uz intern: verificări, due-diligence, îmbogățirea propriului CRM/ERP, analize pentru uz propriu.
Business — produse derivate: datele pot fi un input, prelucrat sau combinat cu alte surse, în rapoarte, analize, scoring sau dashboard-uri livrate clienților tăi. Condiții: menționezi sursa („date: dashiro.ro”) și data extragerii, păstrezi eticheta estimare la beneficiarii reali și răspunzi, ca operator, de prelucrarea ulterioară a numelor persoanelor fizice.
Niciodată fără acord scris: redistribuirea datelor brute (livrarea profilurilor sau a seturilor de date ca atare, un API-oglindă, republicarea pe alt site), construirea unei baze concurente, partajarea cheii între organizații. Pentru aceste cazuri: Enterprise.