# Datero

> API REST + server MCP pentru date publice românești: profiluri de firme (2,7M companii, ANAF/ONRC), nomenclatorul CAEN Rev.3, județe și localități, curs valutar BNR. Cele două canale au comportament identic (același cost, aceleași limite). Datele de referință sunt gratuite și accesibile fără autentificare; datele de firme cer o cheie API (plan Free disponibil).

Base URL: https://api.datero.ro · MCP: https://api.datero.ro/mcp

## Documentație

- [Introducere](https://datero.ro/docs/index.md): Datero expune date publice românești printr-un API REST și un server MCP cu comportament identic. Primul apel în 60 de secunde.
- [Autentificare](https://datero.ro/docs/autentificare.md): Chei API în format dat_live_…, header Authorization: Bearer, acces anonim pentru datele de referință și OAuth pentru MCP.
- [Credite și limite](https://datero.ro/docs/credite-si-limite.md): Cum funcționează creditele per organizație, planurile disponibile, rate limiting-ul și headerele de metering.
- [Erori](https://datero.ro/docs/erori.md): Toate erorile sunt RFC 7807 Problem Details: catalogul de statusuri și exemple reale.
- [Server MCP](https://datero.ro/docs/mcp.md): Conectează Claude, Cursor sau orice client MCP la datele Datero: setup pe client, autentificare și lista tool-urilor.

## Endpoint-uri

- [Get a company by CUI](https://datero.ro/docs/api/companies/get.md): GET /v1/companies/:cui · 1 credit/apel
- [Search companies](https://datero.ro/docs/api/companies/search.md): GET /v1/companies · 1 credit/apel
- [Search the CAEN Rev.3 classification](https://datero.ro/docs/api/caen/search.md): GET /v1/caen-codes · gratuit
- [Get a CAEN code with hierarchy and Rev.2 mapping](https://datero.ro/docs/api/caen/get.md): GET /v1/caen-codes/:code · gratuit
- [List / search Romanian counties (județe)](https://datero.ro/docs/api/locations/counties.md): GET /v1/counties · gratuit
- [Search Romanian localities (localități)](https://datero.ro/docs/api/locations/cities.md): GET /v1/cities · gratuit
- [BNR exchange rates for one day](https://datero.ro/docs/api/fx/rates.md): GET /v1/fx-rates · gratuit
- [BNR exchange-rate history for one currency](https://datero.ro/docs/api/fx/history.md): GET /v1/fx-rates/history · gratuit
- [Convert an amount between currencies at the BNR rate](https://datero.ro/docs/api/fx/convert.md): GET /v1/fx-rates/convert · gratuit

## Mașini

- [OpenAPI 3.1](https://api.datero.ro/openapi.json): specificația completă, cu x-credits-cost și x-mcp-tool pe fiecare operație
- [llms-full.txt](https://datero.ro/llms-full.txt): toată documentația într-un singur fișier