Romanian public registry data API for AI agents
Companies (ANAF, ONRC), courts, e-Factura and legislation in force, as English JSON over REST and MCP. 16 paid services, plus free BNR exchange rates, ROBOR, IRCC and identifier format checks. 1 credit = €0.005 (smallest pack). 100 free credits per key. Errors, not-found and source outages (e.g. ANAF unreachable) are not billed; a risk report with some sections unavailable is billed in full.
Services and prices (credits per successful call)
| Area | Service | MCP tool | Credits | ≈ EUR |
|---|---|---|---|---|
| Companies | Company lookup ANAF registry data by CUI/VAT id: name, address, status, VAT, e-Factura, BNR EUR/RON | lookup_company | 1 | €0.005 |
| Companies | Financial statements Up to 5 years of filed accounts + ratios (RON) | get_company_financials | 3 | €0.015 |
| Companies | Legal representatives (ONRC) Trade-register status, CAEN codes, representatives (name, role) | get_company_representatives | 5 | €0.025 |
| Companies | Risk report (KYB) Status + financials + court cases + registry, score 0-100 with explained flags | get_company_risk_report | 30 | €0.150 |
| Courts | Company court cases Cases where the company is a party (portal.just.ro), summary + list | get_company_court_cases | 15 | €0.075 |
| Courts | Court case by number Parties, hearings, outcomes, appeals | get_court_case | 1 | €0.005 |
| Validation | Check extracted company data CUI, name, Reg. Com., VAT and company status, address, IBAN and optional legal representative, checked against ANAF and ONRC; verdict per field + confidence (pass / review / reject). +5 with legal representative, +1 with invoice block | validate_extracted_company_data | 2 | €0.010 |
| Validation | Identifier format check Free, no key. Local checks only (CUI and IBAN checksums, Reg. Com. format, name normalization, invoice arithmetic); does not check that the company exists. Rate-limited per IP | check_identifier_format | 0 | free |
| e-Factura | Validate invoice XML validated with ANAF's public validation service (CIUS-RO) + local checks, rule codes | validate_efactura | 1 | €0.005 |
| e-Factura | Generate invoice XML CIUS-RO UBL from simple JSON; parties auto-filled from CUI; validated with ANAF's public validation service | generate_efactura | 2 | €0.010 |
| e-Factura | Parse invoice XML UBL Invoice/CreditNote -> English JSON | parse_efactura | 1 | €0.005 |
| e-Factura | Invoice PDF rendered with ANAF's public PDF service | efactura_to_pdf | 1 | €0.005 |
| Legislation | Search acts By citation ('Legea 31/1990') or title words | search_legislation | 1 | €0.005 |
| Legislation | Act (in force) Current consolidated text, split by article | get_legal_act | 1 | €0.005 |
| Legislation | Article (in force) One article + dated amendment notes | get_legal_article | 1 | €0.005 |
| Legislation | Amendment history Consolidation dates, dated amendments per article | get_legal_act_history | 2 | €0.010 |
| Legislation | New acts Acts in force since a date (max 35 days) | get_new_legal_acts | 1 | €0.005 |
Validation (POST /v1/validate): send what your agent extracted from an invoice or contract, e.g. {"party":{"cui":"RO12345674","name":"FIRMA S.R.L.","iban":"RO49AAAA1B31007593840000"}}, and get a verdict per field, the registered value where it differs, and a confidence score. Checked against public sources (ANAF, ONRC). 2 credits; +5 with legalRepresentative (match / no match only, names are not stored); +1 with an invoice block. Not billed on errors or when ANAF is unreachable; if ONRC data is unavailable the representative is marked unverifiable and the +5 is not charged. A CUI with a bad checksum is rejected (400) without charge; a valid CUI that ANAF does not know is billed 2. Not a KYC/AML check; a valid IBAN does not prove the account belongs to the company. Free format check (POST /v1/validate/format) needs no key; for new-format Reg. Com. numbers (e.g. J2020001234400) the last digit is not verified.
Start
Free without a key, over REST and MCP: BNR exchange rates, ROBOR, IRCC and identifier format checks (rate-limited per IP).
No signup: demo key htr_demo (limited daily calls; get a free key for more), on company lookup, court case by number, e-Factura validate/parse, legislation search, article and new acts.
curl -H "x-api-key: htr_demo" https://api.howtoromania.io/v1/company/14399840
Free key, 100 credits, all services:
curl -X POST https://api.howtoromania.io/v1/keys -H "content-type: application/json" -d '{"email":"you@example.com","accept_terms":true}'
MCP
Remote, streamable HTTP: https://api.howtoromania.io/mcp, header Authorization: Bearer <key>. Listed in the MCP Registry as io.howtoromania/api. Configs for Claude Desktop, Cursor, Cline and ChatGPT: docs.
{ "mcpServers": { "howtoromania": { "url": "https://api.howtoromania.io/mcp", "headers": { "Authorization": "Bearer htr_demo" } } } }
Typical agent tasks
- KYB on a Romanian supplier: Before we sign with supplier RO14399840, check it's active, VAT-registered, and summarize risk flags.
- Verify a VAT id on an invoice: Is RO14399840 a valid, active Romanian VAT payer? Return legal name and registered address.
- Who can sign for the company: List the legal representatives of CUI 14399840 and their roles.
- Financial health check: Show turnover, net profit and employees for CUI 14399840 for the last 3 years, with YoY growth.
- Litigation screen: Is CUI 14399840 a defendant in any insolvency or pending civil cases since 2024?
- Invoice a Romanian client (cross-border): Create an e-Factura invoice from our German company DE123456789 to RO14399840: 10 hours consulting at €120, reverse charge.
- Fix a rejected e-Factura: ANAF rejected this XML. Validate it and tell me exactly which rules fail and how to fix them.
- Read an incoming Romanian invoice: Parse this e-Factura XML and give me supplier, totals, VAT and IBAN in JSON for our ERP.
- Current Romanian VAT rate: What VAT rates apply in Romania today per Codul fiscal art. 291, and when did they last change?
- Monitor new Romanian law: List Romanian acts that entered into force this week that affect taxes or companies.
Use cases
Pricing
Packs and per-endpoint credits, same numbers as /pricing and GET https://api.howtoromania.io/v1/pricing.
Per key, on signup.
€0.005 / credit
€0.004 / credit
€0.0033 / credit
Buy a pack with your key: GET https://api.howtoromania.io/v1/billing/checkout?pack=starter|pro|scale returns a checkout link (or follow the link in any 402 response). Prices include VAT; Stripe (Link) is the merchant of record. Every key starts with 100 free credits. Prepaid, no contract; errors, not-found and source outages (e.g. ANAF unreachable) are not billed; a risk report with some sections unavailable is billed in full.
Volume subscriptions available on request: hello@howtoromania.io.
Pe românește
Date publice românești pentru agenți AI: firme (ANAF, ONRC), dosare, e-Factura, legislație în vigoare. REST + MCP. 1 credit = 0,005 € (pachetul minim), 100 credite gratuite.
Customers
Contact
hello@howtoromania.io · Sources: ANAF, BNR, ONRC open data, portal.just.ro, legislatie.just.ro. Contains filtered, decoded, translated ONRC data (CC BY 4.0). Informational; not legal or credit advice.
