API docs

English JSON from Romanian public registries, over REST and MCP. The contract for every response field is openapi.json. Curl samples and Claude, Cursor and Cline configs are also published at api.howtoromania.io/docs. Prices: /pricing.

Quickstart

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 per IP), on company lookup, court case by number, e-Factura validate and 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}'

Send x-api-key or Authorization: Bearer. The demo key and a paid key return the same JSON fields.

Endpoints

AreaServiceEndpointReturnsCredits
CompaniesCompany lookupGET /v1/company/{cui}
MCP lookup_company
ANAF registry data by CUI/VAT id: name, address, status, VAT, e-Factura, BNR EUR/RON1
CompaniesFinancial statementsGET /v1/company/{cui}/financials
MCP get_company_financials
Up to 5 years of filed accounts + ratios (RON)3
CompaniesLegal representatives (ONRC)GET /v1/company/{cui}/representatives
MCP get_company_representatives
Trade-register status, CAEN codes, representatives (name, role)5
CompaniesRisk report (KYB)GET /v1/company/{cui}/risk-report
MCP get_company_risk_report
Status + financials + court cases + registry, score 0-100 with explained flags30
CourtsCompany court casesGET /v1/company/{cui}/court-cases
MCP get_company_court_cases
Cases where the company is a party (portal.just.ro), summary + list15
CourtsCourt case by numberGET /v1/court-cases/{caseNumber}
MCP get_court_case
Parties, hearings, outcomes, appeals1
ValidationCheck extracted company dataPOST /v1/validate
MCP validate_extracted_company_data
Checks CUI, name, registration number, VAT status, company status, address, IBAN and (optional) legal representative an AI extracted from an invoice or contract against ANAF and ONRC; verdict per field and a confidence score (pass / review / reject). +5 credits with legalRepresentative, +1 with an invoice block2
e-FacturaValidate invoice XMLPOST /v1/efactura/validate
MCP validate_efactura
validated with ANAF's public validation service (CIUS-RO) + local checks, rule codes1
e-FacturaGenerate invoice XMLPOST /v1/efactura/generate
MCP generate_efactura
CIUS-RO UBL from simple JSON; parties auto-filled from CUI; validated with ANAF's public validation service2
e-FacturaParse invoice XMLPOST /v1/efactura/parse
MCP parse_efactura
UBL Invoice/CreditNote -> English JSON1
e-FacturaInvoice PDFPOST /v1/efactura/pdf
MCP efactura_to_pdf
rendered with ANAF's public PDF service1
LegislationSearch actsGET /v1/legislation/search
MCP search_legislation
By citation ('Legea 31/1990') or title words1
LegislationAct (in force)GET /v1/legislation/act/{id}
MCP get_legal_act
Current consolidated text, split by article1
LegislationArticle (in force)GET /v1/legislation/act/{id}/article/{n}
MCP get_legal_article
One article + dated amendment notes1
LegislationAmendment historyGET /v1/legislation/act/{id}/history
MCP get_legal_act_history
Consolidation dates, dated amendments per article2
LegislationNew actsGET /v1/legislation/new
MCP get_new_legal_acts
Acts in force since a date (max 35 days)1
BNR rates (free)BNR exchange rateGET /v1/rates/fx
MCP get_bnr_exchange_rate
RON reference rate on a date (latest fixing on/before it), one or all currencies, from 2005-01-030
BNR rates (free)BNR exchange rate historyGET /v1/rates/fx/history
MCP get_bnr_exchange_rate
Daily series for one currency, max 366 days per request0
BNR rates (free)ROBOR / ROBIDGET /v1/rates/robor
MCP get_robor
Interbank fixing on a date, all tenors or one, from 1995-08-010
BNR rates (free)ROBOR / ROBID historyGET /v1/rates/robor/history
MCP get_robor
Daily series for one tenor, max 366 days per request0
BNR rates (free)IRCCGET /v1/rates/ircc
MCP get_ircc
Quarterly IRCC applicable on a date, next quarter's if published, latest daily IRCC0
BNR rates (free)IRCC historyGET /v1/rates/ircc/history
MCP get_ircc
Daily values from 2018-10-01 (max 366 days per request) or all quarterly values from 2018-Q40
ValidationIdentifier format checkPOST /v1/validate/format
MCP check_identifier_format
Free, no key. Local checks only; does not check that the company exists. Rate-limited per IP0

Free, no API key, no credits, over REST and MCP; keyless calls are rate-limited per IP. Source: Banca Națională a României (bnr.ro); informational, values unchanged from BNR source.

MCP

Remote, streamable HTTP: https://api.howtoromania.io/mcp. initialize and tools/list need no key.

{ "mcpServers": { "howtoromania": { "url": "https://api.howtoromania.io/mcp", "headers": { "Authorization": "Bearer htr_demo" } } } }

Claude Desktop, Cursor, Cline and ChatGPT configs: api.howtoromania.io/docs#mcp.

Company, VAT, status and e-Factura fields

GET /v1/company/{cui} reads ANAF PlatitorTvaRest v9 for queriedForDate (Europe/Bucharest). source.fetchedAt is when that body was read; a repeat lookup can be served from cache for up to 6 hours. eFactura.status is always registered, not_registered, or unknown. eFactura.registered is true or false only when ANAF sends a boolean or the strings "true" / "false", and is omitted when the flag is missing or unreadable (status unknown). Omitted is not a negative finding. False means the CUI is not in Registrul RO e-Factura on that date. It does not mean the company is exempt from sending domestic B2B invoices through RO e-Factura. The risk-report ANAF section and the MCP tools that return those payloads use the same object. POST /v1/validate compares extracted VAT and status with the same ANAF record, and the legal representative with the ONRC open-data snapshot. It does not return the registry flag. POST /v1/efactura/validate, /generate, /parse and /pdf work on CIUS-RO XML. They do not return the registry flag. Every property, including the XML fields, is described in openapi.json.

FieldMeaning
data.cuiString of digits, no RO prefix. Romanian fiscal code (CUI/CIF). Example: "14399840". Source: ANAF date_generale.cui.
data.vatIdString or null. "RO" plus the CUI when vat.registered is true; null when the company is not VAT-registered on queriedForDate. Derived from ANAF inregistrare_scop_Tva.scpTVA. Example: "RO14399840".
data.nameString. Legal name from ANAF date_generale.denumire. Empty string when ANAF sends no name. Example: "DANTE INTERNATIONAL SA".
data.registrationNumberString or null. Trade-register number (ONRC) as stored by ANAF in date_generale.nrRegCom. Old form J40/3724/2002 or new form J2002000372404. Null when ANAF sends a blank. Example: "J2002000372404". GET /v1/company/{cui}/representatives can carry the same number from the ONRC open-data snapshot.
data.registrationDateString or null, YYYY-MM-DD. ANAF date_generale.data_inregistrare (the fiscal registration date ANAF holds). Null when blank. Example: "2002-01-23". The representatives endpoint has its own registrationDate from the ONRC snapshot, which can be a later filing.
data.caenCodeString or null. Main CAEN Rev. 2 code from ANAF date_generale.cod_CAEN, digits only, no text. Null when blank. Example: "4754". Extra authorized codes, when the snapshot has them, are on the representatives endpoint (ONRC), not here.
data.legalFormString or null. ANAF date_generale.forma_juridica. Example: "SOCIETATE COMERCIALĂ PE ACŢIUNI". Null when blank.
data.organizationTypeString or null. ANAF date_generale.forma_organizare. Example: "PERSOANA JURIDICA". Null when blank.
data.ownershipString or null. ANAF date_generale.forma_de_proprietate. Example: "PROPR.PRIVATA-CAPITAL PRIVAT AUTOHTON SI STRAIN". Null when blank.
data.taxOfficeString or null. Competent tax office, ANAF date_generale.organFiscalCompetent. Example: "Direcţia Generală de Administrare a Marilor Contribuabili". Null when blank.
data.fiscalStatusString or null. Free text from ANAF date_generale.stare_inregistrare. Example: "INREGISTRAT din data 29.08.2006". Null when blank. Structured flags are status.active, status.inactive and status.deregisteredOn.
data.addressObject with fiscal and registeredOffice, same shape. fiscal is ANAF adresa_domiciliu_fiscal; if its formatted line is empty, date_generale.adresa is used. registeredOffice is ANAF adresa_sediu_social. The two addresses often differ (CUI 14399840: fiscal in Sector 2, registered office in Sector 6).
data.address.fiscal.county / registeredOffice.countyString or null. County name (denumire_Judet). Example: "MUNICIPIUL BUCUREŞTI". Null when omitted.
data.address.*.localityString or null. City, town or Bucharest sector (denumire_Localitate). Example: "Sector 2 Mun. Bucureşti". Null when omitted.
data.address.*.streetString or null. Street name (denumire_Strada). Example: "Str. Gara Herăstrău". Null when omitted.
data.address.*.numberString or null. Street number (numar_Strada). Example: "6". Null when omitted.
data.address.*.detailsString or null. Extra line such as building, entrance or apartment (detalii_Adresa). Example: "Cladirea Globalworth Square". Null when omitted.
data.address.*.postalCodeString or null. Postal code (cod_Postal). Example: "60787" on the registered office of CUI 14399840. Null when omitted.
data.address.*.countyCodeString or null. Romanian county code (cod_JudetAuto). Examples: "B", "CJ". Null when omitted.
data.address.*.countryString. Country (tara). "RO" when ANAF sends a blank. Example: "RO".
data.address.*.formattedString or null. One line joined from street, number, details, locality, county and postal code. On the fiscal address, a blank line falls back to ANAF date_generale.adresa. Null when nothing is available. Example: a fiscal line for CUI 14399840 containing "Herăstrău".
data.vat.registeredBoolean. True when ANAF inregistrare_scop_Tva.scpTVA is true on queriedForDate: the company is in the VAT register (Fiscal Code art. 316) on that date. False when that flag is not true. Example: true for CUI 14399840. False is a definite ANAF answer for that date. If ANAF cannot be reached the call fails and is not billed.
data.vat.sinceString or null, YYYY-MM-DD. Start of the open VAT period: the perioade_TVA row with an empty data_sfarsit_ScpTVA, otherwise the first row's data_inceput_ScpTVA. Null when vat.registered is false or ANAF sends no date. Example: "2002-02-01".
data.vat.cashAccountingBoolean. True when ANAF inregistrare_RTVAI.statusTvaIncasare is true on queriedForDate (TVA la încasare, cash-accounting VAT). False otherwise. Example: false for CUI 14399840.
data.vat.splitVatBoolean. True when ANAF inregistrare_SplitTVA.statusSplitTVA is true on queriedForDate (split-payment VAT). False otherwise. Example: false for CUI 14399840.
data.status.activeBoolean, derived. True when status.inactive is false and status.deregisteredOn is null. False when ANAF lists the company as fiscally inactive or deregistered. A company can be active and not VAT-registered. Example: true for CUI 14399840. ONRC dissolution, insolvency or suspension is a different source (representatives and the risk report).
data.status.inactiveBoolean. True when ANAF stare_inactiv.statusInactivi is true on queriedForDate (fiscally inactive taxpayers). False otherwise. Example: false for CUI 14399840.
data.status.inactiveSinceString or null. ANAF stare_inactiv.dataInactivare. Null when the company is not inactive or ANAF sends no date. Example: null.
data.status.reactivatedOnString or null. ANAF stare_inactiv.dataReactivare. Null when ANAF sends no date. Example: null.
data.status.deregisteredOnString or null, YYYY-MM-DD. ANAF stare_inactiv.dataRadiere when set. If that is blank and stare_inregistrare contains RADIERE plus a dd.MM.yyyy date, that date is converted to YYYY-MM-DD and used. Null when the company is not deregistered. When set, status.active is false. Example: null for CUI 14399840.
data.eFactura.statusString enum, always present: "registered", "not_registered", or "unknown". Derived from ANAF date_generale.statusRO_e_Factura as of queriedForDate. "registered": the flag is true (JSON boolean or the string "true") and the CUI is in Registrul RO e-Factura. "not_registered": ANAF sent false (JSON boolean or the string "false"), so the CUI is not in that registry on that date. "unknown": the flag was missing, blank, or neither a boolean nor those strings. Unknown is not a negative finding, and registered is omitted in that case. Examples: "not_registered" for CUI 14399840 (Dante International SA); "registered" for CUI 16054368. "not_registered" does not mean the company is exempt from sending domestic B2B invoices through RO e-Factura. A failed ANAF call does not come back as not_registered; the request errors and is not billed.
data.eFactura.registeredBoolean, optional, never null. Present only when status is "registered" (true: the CUI is in Registrul RO e-Factura) or "not_registered" (false: ANAF sent false, so the CUI is not in that registry on queriedForDate). Omitted entirely when status is "unknown" (the flag was missing, blank, or unreadable). Never returned as null. ANAF date_generale.statusRO_e_Factura as of queriedForDate. JSON booleans and the strings "true" and "false" are definite answers. A bare Boolean() cast is not used: Boolean("false") is true. Examples: false for CUI 14399840 (Dante International SA); true for CUI 16054368. False does not mean the company is exempt from sending domestic B2B invoices through RO e-Factura. A failed ANAF call does not come back as false; the request errors and is not billed.
data.eFactura.sinceString or null, YYYY-MM-DD. ANAF date_generale.data_inreg_Reg_RO_e_Factura. Null when ANAF sends a blank (typical when status is not_registered). Example: null for CUI 14399840; "2022-09-01" for CUI 16054368. The registry query service can report a different dataInscriere for the same CUI; this field follows PlatitorTvaRest, the same payload as status and registered.
data.queriedForDateString, YYYY-MM-DD. The date sent to ANAF. VAT, inactive, deregistration and e-Factura flags are as of this date (Europe/Bucharest today, unless a caller passes another date). Example: "2026-11-17". Not the same as source.fetchedAt.
data.source.nameString. Always "ANAF PlatitorTvaRest v9" on a company lookup.
data.source.urlString. The ANAF endpoint that was called. Example: "https://webservicesp.anaf.ro/api/PlatitorTvaRest/v9/tva".
data.source.fetchedAtString, ISO-8601 timestamp of the ANAF read that produced this object. Example: "2026-11-17T07:40:00.000Z". A repeat lookup can be served from cache for up to 6 hours, so fetchedAt can lag the HTTP request. It is not a registry publication time.
fxBNR EUR/RON rate attached to a company lookup. Null when the query fx=false or BNR did not return a rate. Source: Banca Națională a României (bnr.ro). Informational; the number is unchanged from the BNR source.
fx.currencyString. ISO 4217 code. Always "EUR" on this lookup.
fx.ronPerUnitNumber. RON per 1 EUR on fx.date. Example: 5.09.
fx.dateString, YYYY-MM-DD. BNR publication date of this fixing. Example: "2026-11-16".
fx.sourceString. Publisher. Always "BNR" on this lookup.
POST /v1/validate data.overall.verdictString enum: "pass", "review", or "reject". Combined verdict. pass when confidence is at least 0.90, review from 0.60 to 0.89, reject below 0.60. A deregistered company, an unknown CUI, or another hard stop forces reject. Fiscally inactive, an ONRC insolvency/suspension/dissolution status, or an invalid IBAN forces at most review.
POST /v1/validate data.overall.confidenceNumber from 0 to 1. Weights (renormalized over the fields that were checked): CUI 0.30, name 0.15, VAT 0.15, status 0.10, IBAN 0.10, registration number 0.08, address 0.07, legal representative 0.05. Per field: valid 1.0, corrected 0.9 times name similarity (only if similarity is at least 0.85), partial 0.5, invalid or not_found 0, unverifiable excluded. Example: 1.
POST /v1/validate data.fieldsObject keyed by the checks that ran. Keys: cui (always), status (always), name, registrationNumber, vatRegistered, address, iban, legalRepresentative (only when you sent them). vatRegistered.value is the ANAF boolean vat.registered; vatRegistered.input is the boolean you claimed (an RO prefix with no explicit claim is treated as a claim of true). status.value is "active", "fiscally_inactive", or "deregistered". status.since is the inactivity or deregistration date when status is not active. legalRepresentative comes from the ONRC open-data snapshot (match or no match only; the name is not stored). Address is compared to the fiscal address, or the registered office when the fiscal line is empty.
POST /v1/validate data.fields.*.verdictString enum: "valid", "corrected", "partial", "invalid", "not_found", "unverifiable". corrected is a close name match (similarity at least 0.85). partial is an address that matches county and city but not the street. unverifiable means the source needed for that field could not be read (ONRC snapshot missing, or ANAF has no parsable registration number).
POST /v1/validate data.fields.*.valueRegistry or normalized value when there is one. String for name, address, registration number, status ("active", "fiscally_inactive", "deregistered") and the normalized IBAN. Boolean for vatRegistered (ANAF vat.registered). Null when a string field has no registry value (for example ANAF has no registration number). Omitted on some not_found and unverifiable results.
POST /v1/validate data.asOfString, YYYY-MM-DD. Date the document claims, or today in Europe/Bucharest when asOfDate was omitted. ANAF is queried for this date. Example: "2026-11-17".
POST /v1/validate data.sourcesString. "ANAF PlatitorTvaRest v9", and when the ONRC snapshot was read, a second entry naming the ONRC open data. String, YYYY-MM-DD. The date asked of ANAF. Present on the ANAF source entry. Example: "2026-11-17". String, ISO-8601. When that ANAF body was read. The company record can be cached for up to 6 hours.
POST /v1/efactura/validate data.validBoolean. True only when local CIUS-RO errors are zero and, if ANAF's validator was reached, ANAF also accepted the XML (stare "ok"). When ANAF is not reached, true means local checks passed and validatedBy is "local".
POST /v1/efactura/validate data.validatedByString enum: "anaf" when the public validator answered, "local" when it was skipped (query anaf=false) or unreachable. Example: "anaf".
POST /v1/efactura/validate data.anaf.checkedBoolean. True when ANAF's public validator returned a verdict. False when it was not called or the call failed. False is not itself an invoice rejection; read valid and validatedBy. The call is not billed when the validator is unreachable.
POST /v1/efactura/validate data.anaf.validBoolean, present when checked is true. ANAF's stare: true for "ok", false otherwise. Omitted when checked is false.

FAQ

What does eFactura.registered false mean?

ANAF PlatitorTvaRest v9 sent statusRO_e_Factura false: eFactura.status is not_registered and eFactura.registered is false. The CUI is not in Registrul RO e-Factura on queriedForDate. It does not mean the company is exempt from sending domestic B2B invoices through RO e-Factura. When ANAF does not send a readable boolean, registered is omitted and status is unknown. Unknown is not a negative finding.

Where is the OpenAPI spec?

GET https://api.howtoromania.io/openapi.json (OpenAPI 3.1). Every response property of the company, verification and e-Factura endpoints has a description there. The longer curl and MCP configs are at https://api.howtoromania.io/docs.