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 de mai jos.

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 · limită 60 cereri/minut per cheie · răspunsuri JSON UTF-8, envelope { data: … } sau { error, mesaj }.

Endpoint	Ce întoarce
`GET /api/v1/firma/{cui}`	Profilul firmei: identificare, status ANAF, TVA, adresă, CAEN, website
`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)

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ă · 404 negăsit · 429 limită depășită · 502 sursa temporar indisponibilă.

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`	asociați/administratori + firme conexe	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

Datele provin din surse publice oficiale și au caracter informativ. Nu revinde datele brute. Numele persoanelor fizice se livrează public ca inițiale (GDPR). Pentru volume mai mari de 60 req/min sau acces bulk: contactează-ne.