HowToRomanian company data API
Look up any Romanian company by CUI or VAT number and get status, address, VAT and e-Factura registration, filed financials, legal representatives and court cases as English JSON. Built for KYB, onboarding and AI agents, over REST or MCP.
curl example
curl -H "x-api-key: htr_demo" "https://api.howtoromania.io/v1/company/14399840"
curl -H "x-api-key: $HTR_KEY" "https://api.howtoromania.io/v1/company/14399840/risk-report"
Free key: curl -X POST https://api.howtoromania.io/v1/keys -H "content-type: application/json" -d '{"email":"you@example.com","accept_terms":true}'
MCP example
{ "mcpServers": { "howtoromania": { "url": "https://api.howtoromania.io/mcp", "headers": { "Authorization": "Bearer htr_demo" } } } }
Ask your agent: “Before we sign with supplier RO14399840, check it's active, VAT-registered, and summarize risk flags.”
Endpoints and prices
| Service | Endpoint | Credits | ≈ EUR |
|---|---|---|---|
| Company lookup ANAF registry data by CUI/VAT id: name, address, status, VAT, e-Factura, BNR EUR/RON | GET /v1/company/{cui}MCP lookup_company | 1 | €0.005 |
| Financial statements Up to 5 years of filed accounts + ratios (RON) | GET /v1/company/{cui}/financialsMCP get_company_financials | 5 | €0.025 |
| Legal representatives (ONRC) Trade-register status, CAEN codes, representatives (name, role) | GET /v1/company/{cui}/representativesMCP get_company_representatives | 2 | €0.010 |
| Risk report (KYB) Status + financials + court cases + registry, score 0-100 with explained flags | GET /v1/company/{cui}/risk-reportMCP get_company_risk_report | 8 | €0.040 |
| Company court cases Cases where the company is a party (portal.just.ro), summary + list | GET /v1/company/{cui}/court-casesMCP get_company_court_cases | 3 | €0.015 |
Prepaid packs (VAT included): €5 = 1,000 · €20 = 5,000 · €100 = 30,000 credits. 100 free credits per key, no subscription.
Why HowToRomania
- English JSON, ready for code and AI agents
- Companies, court cases, e-Factura and legislation in force in one API
- REST and a remote MCP server with the same key
- Pay per call (1 credit = €0.005), no subscription; errors are not billed
- 100 free credits on every key
FAQ
Which identifiers are accepted?
The CUI (fiscal code), with or without the RO prefix, e.g. 14399840 or RO14399840.
Where does the data come from?
ANAF public registry services, ONRC open data (trade register), filed financial statements, BNR exchange rates and portal.just.ro for court cases.
How much does it cost?
Pay per successful call in credits (1 credit = €0.005). Every key gets 100 free credits. Packs: €5 = 1,000 credits, €20 = 5,000 credits, €100 = 30,000 credits. Prepaid, no subscription; errors and not-found are not billed.
Can I try it without signing up?
Yes. The demo key htr_demo works on 1-credit endpoints with a small daily limit per IP. A free key with 100 credits is one POST to /v1/keys.
Is this an official ANAF or government service?
No. HowToRomania is an independent service that reads public sources (ANAF, ONRC open data, BNR, portal.just.ro, legislatie.just.ro) and returns them as English JSON. It is not affiliated with or endorsed by any public authority. Information only; not legal or credit advice.