API-Dokumentation

Inhalt

Die API-Dokumentation gibt es auf Rumänisch und auf Englisch.

The API is REST and answers in JSON. The full description, in OpenAPI 3.1 format, is at https://api.apifirme.dev/openapi.json?lang=en; this page is generated from it. Field names and values are those of the Romanian registries (denumire is the name, judet the county, stare the status).

Authentication

Every request, except the validation ones, needs an API key in the Authorization header:

curl https://api.apifirme.dev/rest/v1/companies/13548146 \
  -H "Authorization: Bearer af_live_..."

In place of af_live_... put your own key, as it was shown when you created it in your account. In the addresses below, {cui} is the company's CUI, for example 13548146, and {year} the year: the curl examples already carry real values and can be run as they are. A request with a {cui} or an af_live_... left in gets 400 with placeholder-left-in, which says what was to be replaced.

A key that is missing, wrong or revoked gets 401. The keys of a suspended account get 403 with account-suspended; such a request is not counted.

Limits

Every response says how much is left of the limits: x-ratelimit-limit, x-ratelimit-remaining and x-ratelimit-reset for the requests per minute, x-quota-limit and x-quota-remaining for those of the month. A request over the limit gets 429 with a Retry-After header and is not counted. Beyond the plan's monthly number of requests another 5 % are allowed, at no cost; only after those are requests refused.

The limits are the account's, not the key's: all keys of an account, connected AI assistants included, share the requests per minute, the companies looked up at ANAF on request, the searches and the month's requests. The headers above say what is left to the account.

Conditional requests

Every 200 response has an ETag header. A request that sends it back in If-None-Match gets 304 without a body if the response has not changed; it counts as a request too.

Errors

Errors follow RFC 7807: the content type is application/problem+json, and the body has type, title, status and detail. type identifies the kind of error, for example https://apifirme.dev/problems/invalid-cui.

For AI assistants

The same data is available as tools through the Model Context Protocol, at https://api.apifirme.dev/mcp (Streamable HTTP transport): lookup_company, check_invoice, get_financials, get_company_events, get_fx_rate, count_new_companies and list_new_companies. An assistant sends its user to sign in (OAuth 2.1); a program can send the same API key in the Authorization header. Only tool calls are counted, each as one request; connecting and listing the tools are not. The steps for each assistant are at https://apifirme.dev/en/ai.

Sources

Every company and every financial statement has a sources field: which registry the information comes from, which dataset, and when it was first and last retrieved.

Companies

A company's data, by its CUI (the Romanian unique registration code).

GET /rest/v1/companies/{cui}

A company's data. Returns the company with this CUI. If the company is not in the database yet, it is looked up at ANAF (the Romanian tax administration) right away: the answer comes in the same request or, if the source is slow, as 202 with a Retry-After header. Natural persons who carry on an economic activity (sole traders: PFA, individual and family enterprises; liberal professions) are answered the same way, with what the registers publish about them; persoana_fizica says which kind of entry it is. An entry that still lacks ANAF's details is completed right away, as one that is not in the database is; if it has no name yet and that cannot be done now, the answer is again the one for an entry not in the database (202, 429 or 503), not an entry without a name. One that has its name from the trade register is returned with what the register says.

ParameterWhereDescription
cuiin the path, requiredThe unique registration code (CUI), with or without the RO prefix, for example 13548146.
curl https://api.apifirme.dev/rest/v1/companies/13548146 \
  -H "Authorization: Bearer af_live_..."

Responses:

CodeWhat it means
200The company.
202The company is being looked up at ANAF and did not arrive in time. Repeat the request after the number of seconds in Retry-After. Does not count as a request.
400A parameter is missing or not valid; detail says which. A 13-digit number in place of a CUI is a personal identification number (invalid-cui, said as such); an example pasted with its {cui} or af_live_... gets placeholder-left-in, which says what was to be replaced.
401The API key is missing or not valid.
403The plan does not include this request (upgrade-required; upgrade_url leads to the plans), or the key's account is suspended (account-suspended; such a request is not counted).
404Does not exist: an unregistered CUI, no data for the day or year requested, or a CUI about which no data is served (withheld-on-request).
429The limit per minute or the month's number of requests has been exceeded. Does not count as a request.
503The company is not in the database and ANAF could not be asked right now. Does not count as a request.

The 200 response is a Company object:

FieldTypeDescription
cuiintegerThe unique registration code (CUI).
denumirestring or nullThe name, written for a reader; as the source writes it, in oficial.
nr_reg_comstring or nullThe registration number in the trade register.
adresa_completastring or nullThe company's address, in a single text, written for a reader: the fiscal domicile, as ANAF gives it, and for a company ANAF has not answered about, the registered office from the trade register. Where ANAF has the fiscal domicile elsewhere than the registered office, the county, locality and postal code are the domicile's too; the registered office is in sediu_social. As the source writes it, in oficial.
localitatestring or nullThe locality of the company's address, written for a reader; as the source writes it, in oficial.
judetstring or nullThe county code of the company's address: SB, B, ... The filters by county (new registrations, search, webhooks) go by the registered office's county (sediu_social.judet), which is the same for nearly every company.
cod_postalstring or nullThe postal code of the company's address, six digits. null where the source has none in use (codes from before 2003, incomplete values).
starestring or nullThe status, in one word: FUNCTIUNE (in operation), SUSPENDARE (suspended), REORGANIZARE JUDICIARA (judicial reorganisation), INSOLVENTA (insolvency), DIZOLVARE (dissolution), LICHIDARE (liquidation), FALIMENT (bankruptcy), RADIERE (struck off).
stare_detaliistring or nullThe state of the registration at ANAF, with its day, written for a reader in Romanian, with its diacritics: “Suspendare activitate din data 01.03.2025” (activity suspended), or, for a company absorbed in a merger, dissolution without liquidation (merger) with its day. It says more than stare (that the company was absorbed in a merger, for instance); as ANAF writes it, it is in oficial.stare_detalii. null where ANAF gives nothing.
persoana_fizicaboolean or nullfalse for a legal person, true for a natural person who carries on an economic activity (a sole trader: PFA, individual or family enterprise; a liberal profession), null while the sources do not tell.
forma_juridica_codstring or nullThe legal form from the trade register: SRL, SA, ...
forma_juridicastring or nullThe legal form as ANAF writes it.
caeninteger or nullThe CAEN code of the main activity (source: ANAF). CAEN is the Romanian classification of economic activities, aligned with NACE.
caen_denumirestring or nullThe name of the CAEN code, in the classification in force.
scp_tvabooleanWhether it is registered for VAT.
data_inceput_tvadate or nullSince when it has been registered for VAT.
data_sfarsit_tvadate or nullUntil when it was registered, if it no longer is.
tva_incasarebooleanWhether it applies VAT on collection.
split_tvabooleanWhether it applies split VAT payment.
e_facturabooleanWhether it is in the RO e-Factura register.
status_inactivbooleanWhether it is declared fiscally inactive.
data_inactivaredate or nullSince when it has been inactive.
data_inregistraredate or nullThe date of fiscal registration (source: ANAF).
data_inmatricularedate or nullThe date of entry in the trade register (source: ONRC).
telefonstring or nullThe telephone number declared to ANAF, as ANAF writes it. null also where ANAF has only a value without any digit other than 0 ("0", "0/0", "nedeclarat").
faxstring or nullThe fax number declared to ANAF, as ANAF writes it. null also where ANAF has only a value without any digit other than 0 ("0", "0/0", "nedeclarat").
webstring or nullThe web address declared to the trade register.
euidstring or nullThe European unique identifier (source: ONRC, the trade register).
sediu_secundarbooleanWhether it is the secondary seat of a company, registered at ANAF with a CUI of its own.
updated_ondate or nullThe day something in the company's data last changed.
changed_ondate or nullThe day a value already known about the company last changed; null if nothing has changed since we have it. Everything the sources give is followed: every field of ANAF's answer (the name, the addresses, the phone, the fax, the postal code, the state, the CAEN code, VAT, VAT on collection, split VAT, inactivity, e-Factura), the trade register's data and the fiscal obligations. A piece of information that was missing and has been filled in is not a change, nor is one only written differently (capitals, spacing, an s or t with a cedilla for one with a comma).
checked_ondate or nullThe day ANAF was last asked about the company; null if not yet.
sediu_socialobjectThe registered office, as ANAF and the trade register give it: judet, localitate, strada, numar, detalii and cod_postal, written for a reader (as the source writes them, in oficial.sediu_social). For nearly every company it is the same address as above; it differs where the fiscal domicile declared to ANAF is elsewhere.
obligatii_fiscaleFiscalObligations or nullThe fiscal obligations the taxpayer was registered for (its “vector fiscal”), from the list the Ministry of Finance publishes once a year: the state on the list's day (la_data), not today's. null when they are not known: the company is not in the list, or was taken in after the list was imported. It does not mean that it has no obligations.
stari_registruarrayAll statuses and remarks from the trade register, each with cod (code) and denumire (name).
caen_autorizatearray or nullThe activities the company is authorised for, from the trade register's open data: each with cod (code), versiune (the version of the CAEN classification it was declared in: 3 is the one of 2025, 2 the one of 2008, 1 the one of 2003, 0 the one of 1998) and denumire (name), the newest classification first. The register also keeps what was declared in the old classifications, so the same activity can appear with codes of several versions. null when they are not known (the company is not in the register's dataset), which does not mean that it has none.
sourcesarray of SourceWhich sources the company's data comes from, and since when.
oficialobjectThe name (denumire), the locality (localitate), the address (adresa_completa), the postal code (cod_postal), the state at ANAF (stare_detalii) and, of the registered office, the locality, street, details and postal code (sediu_social) as the source writes them, mostly in capitals (a postal code that is not six digits is given above as null, here as it is). The fields above are written for a reader: only upper and lower case, spacing, punctuation, ş and ţ (written with the comma below) and the form of a few abbreviations change (STR becomes Str., NR. becomes nr.); no word and no number is left out or moved. The legal form stays as it was registered (SRL or S.R.L.).

POST /rest/v1/companies/batch

Several companies in one request. Up to 100 CUIs in a single request, answered from what is already in the database, for every kind of entry, natural persons included. It costs as many requests as the entries it returns in data, and one at least. A CUI that is not in the database yet appears in not_stored, and one in the database that still lacks ANAF's details (such as the name, the address, the VAT registration) appears in incomplete. These cost nothing and can be asked for by themselves, with GET /rest/v1/companies/{cui}, which looks them up at ANAF right away. For the limit per minute, a request for several companies is one request.

The request body is a BatchRequest object:

FieldTypeDescription
cuisarrayBetween 1 and 100 CUIs, as text or as numbers, with or without the RO prefix.
curl -X POST https://api.apifirme.dev/rest/v1/companies/batch \
  -H "Authorization: Bearer af_live_..." \
  -H "Content-Type: application/json" \
  -d '{"cuis": ["13548146", "RO4221306"]}'

Responses:

CodeWhat it means
200The companies found, and what became of the other CUIs.
400A parameter is missing or not valid; detail says which. A 13-digit number in place of a CUI is a personal identification number (invalid-cui, said as such); an example pasted with its {cui} or af_live_... gets placeholder-left-in, which says what was to be replaced.
401The API key is missing or not valid.
403The plan does not include this request (upgrade-required; upgrade_url leads to the plans), or the key's account is suspended (account-suspended; such a request is not counted).
429The limit per minute or the month's number of requests has been exceeded. Does not count as a request.

The 200 response is a BatchResult object:

FieldTypeDescription
dataarray of CompanyThe companies found, in the order in which they were asked for.
not_storedarrayThe valid CUIs that are not in the database yet. They cost nothing; asked for by themselves, they are looked up at ANAF.
incompletearrayThe CUIs in the database that still lack ANAF's details (such as the name, the address, the VAT registration). They cost nothing; asked for by themselves, they are completed from ANAF right away.
invalidarrayWhat is not a valid CUI, as it was received.

Find a company without its CUI. Finds a company by its name or by its trade register number, for whoever does not know its CUI. Exactly one of denumire and nr_reg_com is given. By name, the companies called exactly that come first, with or without the legal form (“dedeman” finds “DEDEMAN SRL”), then those whose name begins with it, then those that contain all its words, in any order. Diacritics and capital letters do not matter, and companies in operation come before the others. The answer has at most 10 companies, each with a few fields, and no next page: more says that others match as well, and then the county or a more exact name helps. A company's full data is requested with its CUI. Natural persons who carry on an economic activity are found like companies; secondary seats are not among the results. A search costs one request and has a limit per minute of its own, by plan; beyond it the answer is 429 with searches-limited.

ParameterWhereDescription
denumirein the queryThe company's name or a part of it: at least one word of three letters or digits, beside the legal form.
nr_reg_comin the queryThe trade register number, in the old form (J32/508/2000) or the new one (J2000000508324), whichever way we store it. Natural persons' numbers, which begin with F, can be searched for too.
judetin the queryWith denumire only: one county's code, as on number plates (SB, B for Bucharest).
curl https://api.apifirme.dev/rest/v1/companies/search \
  -H "Authorization: Bearer af_live_..."

Responses:

CodeWhat it means
200The companies found.
400A parameter is missing or not valid; detail says which. A 13-digit number in place of a CUI is a personal identification number (invalid-cui, said as such); an example pasted with its {cui} or af_live_... gets placeholder-left-in, which says what was to be replaced.
401The API key is missing or not valid.
403The plan does not include this request (upgrade-required; upgrade_url leads to the plans), or the key's account is suspended (account-suspended; such a request is not counted).
429The limit per minute or the month's number of requests has been exceeded. Does not count as a request.

The 200 response is a SearchResult object:

FieldTypeDescription
dataarray of CompanyFoundThe companies found, the closest first: at most 10.
morebooleantrue if other companies match beside those returned.

GET /rest/v1/companies/{cui}/events

What changed at a company. The changes observed at the company since we have been following it, the most recent first (200 at most): registration for VAT or removal from it, VAT on collection, split VAT payment, being declared inactive and being reactivated, being struck off, a change of status, name, address or CAEN code, RO e-Factura. A change is noted when ANAF's answer about the company differs from the one before; what happened before our first answer from ANAF does not appear, and the list is empty if nothing has been observed. For natural persons and entries not classified yet, a change stays in the list for three years from the day it was observed. That a company is new is not an event here: that is what registrations is for.

ParameterWhereDescription
cuiin the path, requiredThe unique registration code (CUI), with or without the RO prefix, for example 13548146.
curl https://api.apifirme.dev/rest/v1/companies/13548146/events \
  -H "Authorization: Bearer af_live_..."

Responses:

CodeWhat it means
200The changes observed at the company.
400A parameter is missing or not valid; detail says which. A 13-digit number in place of a CUI is a personal identification number (invalid-cui, said as such); an example pasted with its {cui} or af_live_... gets placeholder-left-in, which says what was to be replaced.
401The API key is missing or not valid.
403The plan does not include this request (upgrade-required; upgrade_url leads to the plans), or the key's account is suspended (account-suspended; such a request is not counted).
404Does not exist: an unregistered CUI, no data for the day or year requested, or a CUI about which no data is served (withheld-on-request).
429The limit per minute or the month's number of requests has been exceeded. Does not count as a request.

The 200 response is a EventsList object:

FieldTypeDescription
cuiintegerThe company's CUI.
eventsarray of EventThe changes observed, the most recent first.

GET /rest/v1/invoice-check/{cui}

Check before invoicing. Answers, in a single request, what an invoicing program wants to know about a customer: whether it exists, is registered for VAT, applies VAT on collection, is fiscally inactive, is in the RO e-Factura register. If ANAF's last answer about the company is more than 24 hours old, the company is asked about again right away; checked_on says which day the data is from. A valid CUI that ANAF does not know gets 200 with exists: false. An entry without a name that still lacks ANAF's details is asked about right away; if that cannot be done now, the answer is the one for a CUI not in the database (202, 429 or 503).

ParameterWhereDescription
cuiin the path, requiredThe unique registration code (CUI), with or without the RO prefix, for example 13548146.
curl https://api.apifirme.dev/rest/v1/invoice-check/13548146 \
  -H "Authorization: Bearer af_live_..."

Responses:

CodeWhat it means
200The result of the check.
202The company is being looked up at ANAF and did not arrive in time. Repeat the request after the number of seconds in Retry-After. Does not count as a request.
400A parameter is missing or not valid; detail says which. A 13-digit number in place of a CUI is a personal identification number (invalid-cui, said as such); an example pasted with its {cui} or af_live_... gets placeholder-left-in, which says what was to be replaced.
401The API key is missing or not valid.
403The plan does not include this request (upgrade-required; upgrade_url leads to the plans), or the key's account is suspended (account-suspended; such a request is not counted).
404Does not exist: an unregistered CUI, no data for the day or year requested, or a CUI about which no data is served (withheld-on-request).
429The limit per minute or the month's number of requests has been exceeded. Does not count as a request.
503The company is not in the database and ANAF could not be asked right now. Does not count as a request.

The 200 response is a InvoiceCheck object:

FieldTypeDescription
cuiintegerThe unique registration code (CUI).
denumirestring or nullThe name, written for a reader; as the source writes it, in oficial.
existsbooleanWhether ANAF knows a taxpayer with this CUI.
valid_for_invoicingbooleanWhether the company exists, is not struck off and is not fiscally inactive.
vat_registeredbooleanWhether it is registered for VAT.
vat_numberstring or nullThe VAT number (RO followed by the CUI), if it is registered for VAT.
vat_on_collectionbooleanWhether it applies VAT on collection.
split_vatbooleanWhether it applies split VAT payment.
inactivebooleanWhether it is declared fiscally inactive.
struck_offbooleanWhether it is struck off.
efactura_registeredbooleanWhether it is in the RO e-Factura register.
starestring or nullThe status, in one word, as in the company's data.
checked_ondate or nullThe day ANAF last answered about the company.
oficialobject or nullThe name (denumire) as the source writes it, mostly in capitals; null when ANAF does not know the CUI.

Financial statements

The annual financial statements published by the Ministry of Finance and, for those missing from the ministry's data, those from ANAF's web service.

GET /rest/v1/companies/{cui}/financials

A company's financial statements. All annual financial statements of the company, the most recent year first. The list is empty if there are none.

ParameterWhereDescription
cuiin the path, requiredThe unique registration code (CUI), with or without the RO prefix, for example 13548146.
curl https://api.apifirme.dev/rest/v1/companies/13548146/financials \
  -H "Authorization: Bearer af_live_..."

Responses:

CodeWhat it means
200The company's financial statements.
400A parameter is missing or not valid; detail says which. A 13-digit number in place of a CUI is a personal identification number (invalid-cui, said as such); an example pasted with its {cui} or af_live_... gets placeholder-left-in, which says what was to be replaced.
401The API key is missing or not valid.
403The plan does not include this request (upgrade-required; upgrade_url leads to the plans), or the key's account is suspended (account-suspended; such a request is not counted).
404Does not exist: an unregistered CUI, no data for the day or year requested, or a CUI about which no data is served (withheld-on-request).
429The limit per minute or the month's number of requests has been exceeded. Does not count as a request.

The 200 response is a FinancialsList object:

FieldTypeDescription
cuiintegerThe company's CUI.
financialsarray of StatementThe financial statements, the most recent year first.

GET /rest/v1/companies/{cui}/financials/{year}

The financial statement of one year.

ParameterWhereDescription
cuiin the path, requiredThe unique registration code (CUI), with or without the RO prefix, for example 13548146.
yearin the path, requiredThe year of the financial statement, for example 2025.
curl https://api.apifirme.dev/rest/v1/companies/13548146/financials/2025 \
  -H "Authorization: Bearer af_live_..."

Responses:

CodeWhat it means
200The financial statement of that year.
400A parameter is missing or not valid; detail says which. A 13-digit number in place of a CUI is a personal identification number (invalid-cui, said as such); an example pasted with its {cui} or af_live_... gets placeholder-left-in, which says what was to be replaced.
401The API key is missing or not valid.
403The plan does not include this request (upgrade-required; upgrade_url leads to the plans), or the key's account is suspended (account-suspended; such a request is not counted).
404Does not exist: an unregistered CUI, no data for the day or year requested, or a CUI about which no data is served (withheld-on-request).
429The limit per minute or the month's number of requests has been exceeded. Does not count as a request.

The 200 response is a Statement object:

FieldTypeDescription
cuiintegerThe company's CUI.
anintegerThe year of the financial statement.
tip_raportarestringThe Ministry of Finance's reporting type: UU (abbreviated balance sheet), BL_BS_SL, IR (IFRS), ONG (non-profit organisations), ... ANAF's web service does not give the type: for a statement taken from there it is inferred from its indicators, and where several types have the same indicators it is the company's type of the year before.
tip_raportare_descrierestring or nullWhat kind of taxpayers file this type.
caeninteger or nullThe CAEN code from the financial statement.
caen_denumirestring or nullThe name of the code, in the classification in force in that year.
active_imobilizateinteger or nullFixed assets, total. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
active_circulanteinteger or nullCurrent assets, total. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
stocuriinteger or nullInventories. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
creanteinteger or nullReceivables. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
casa_bancainteger or nullCash and bank accounts. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
cheltuieli_avansinteger or nullPrepaid expenses. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
datoriiinteger or nullLiabilities. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
venituri_avansinteger or nullDeferred income. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
provizioaneinteger or nullProvisions. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
capitaluri_totalinteger or nullEquity, total. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
capital_socialinteger or nullSubscribed and paid-up share capital. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
patrimoniul_regieiinteger or nullPatrimony of the autonomous state enterprise (regie). In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
cifra_afaceriinteger or nullNet turnover. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
venituri_totaleinteger or nullTotal income. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
cheltuieli_totaleinteger or nullTotal expenses. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
profit_brutinteger or nullGross profit. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
pierdere_brutainteger or nullGross loss. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
profit_netinteger or nullNet profit. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
pierdere_netainteger or nullNet loss. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
nr_mediu_salariatiinteger or nullAverage number of employees. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
alti_indicatoriarrayThe indicators this reporting type has in addition, each with cod (code), denumire (name) and valoare (value).
updated_atdate-timeWhen the statement last changed in our database.
sourcesarray of SourceWhere the statement comes from (the ministry's dataset and when it published it, or ANAF's web service) and when we retrieved it.

New companies

Newly registered companies, for those who want to learn every day which companies have appeared.

GET /rest/v1/registrations

Newly registered companies. The companies registered in the requested period, and the natural persons who carry on an economic activity, in the order in which they were indexed, paginated by cursor. The period is limited by the plan; a longer period is refused with 400, not silently shortened. Every page has a next_cursor, the last one included: while more is true, the next page is asked for at once with cursor=<next_cursor>; when it is false, keep the last next_cursor and ask again with it the next day. That way no company is missed: a company registered on a Monday may be indexed on the Friday, and companies become visible strictly in the order in which they are indexed, so it comes after the cursor kept. Do not continue by the registration date, nor by the time of your own clock. A company can appear a second time: when its CAEN code, county or legal form becomes known after it was indexed (a quarter of the new companies have no CAEN code yet on their first day). That way those who filter by these receive it too; it is recognised by its cui. Secondary seats do not appear. With persoana_fizica only legal persons or only natural persons are asked for, by what is known when asked; an entry not classified yet when it was indexed does not appear a second time when it is classified, so only those who follow the list without this filter see it. Plans that do not include the list get 403.

ParameterWhereDescription
daysin the queryThe companies registered in the last so many days. Not together with registered_after.
registered_afterin the queryThe companies registered on or after this day.
caenin the queryOne or more four-digit CAEN codes, separated by commas.
caen_prefixin the queryThe first two digits (the division) or three (the group) of the CAEN code.
judetin the queryOne or more county codes (SB, B), separated by commas: the registered office's county.
forma_juridicain the queryOne or more legal forms, by the trade register's codes (SRL, SA), separated by commas.
persoana_fizicain the querytrue for the natural persons who carry on an economic activity only (sole traders: PFA, individual and family enterprises; liberal professions), false for the legal persons only. Without it, all of them, the entries not classified yet included.
limitin the queryHow many companies per page, between 1 and 500. 100 by default.
cursorin the queryThe next_cursor value from the previous answer.
curl https://api.apifirme.dev/rest/v1/registrations?days=7&judet=SB \
  -H "Authorization: Bearer af_live_..."

Responses:

CodeWhat it means
200A page of new companies.
400A parameter is missing or not valid; detail says which. A 13-digit number in place of a CUI is a personal identification number (invalid-cui, said as such); an example pasted with its {cui} or af_live_... gets placeholder-left-in, which says what was to be replaced.
401The API key is missing or not valid.
403The plan does not include this request (upgrade-required; upgrade_url leads to the plans), or the key's account is suspended (account-suspended; such a request is not counted).
429The limit per minute or the month's number of requests has been exceeded. Does not count as a request.

The 200 response is a RegistrationsPage object:

FieldTypeDescription
dataarray of RegistrationThe companies, in the order in which they were indexed.
next_cursorstringTo be sent as cursor for the next page. It is on the last page too: kept and sent the next day, it brings the companies indexed in the meantime.
morebooleanWhether there are more companies after this page.
filterobjectThe filter applied, with the resulting period.

GET /rest/v1/registrations/count

The number of newly registered companies. How many companies match the filter. Included in every plan, over at most the longest period any plan offers. Without days or registered_after the last 30 days are counted.

ParameterWhereDescription
daysin the queryThe companies registered in the last so many days. Not together with registered_after.
registered_afterin the queryThe companies registered on or after this day.
caenin the queryOne or more four-digit CAEN codes, separated by commas.
caen_prefixin the queryThe first two digits (the division) or three (the group) of the CAEN code.
judetin the queryOne or more county codes (SB, B), separated by commas: the registered office's county.
forma_juridicain the queryOne or more legal forms, by the trade register's codes (SRL, SA), separated by commas.
persoana_fizicain the querytrue for the natural persons who carry on an economic activity only (sole traders: PFA, individual and family enterprises; liberal professions), false for the legal persons only. Without it, all of them, the entries not classified yet included.
curl https://api.apifirme.dev/rest/v1/registrations/count?days=30&caen_prefix=62 \
  -H "Authorization: Bearer af_live_..."

Responses:

CodeWhat it means
200The number of companies.
400A parameter is missing or not valid; detail says which. A 13-digit number in place of a CUI is a personal identification number (invalid-cui, said as such); an example pasted with its {cui} or af_live_... gets placeholder-left-in, which says what was to be replaced.
401The API key is missing or not valid.
403The plan does not include this request (upgrade-required; upgrade_url leads to the plans), or the key's account is suspended (account-suspended; such a request is not counted).
429The limit per minute or the month's number of requests has been exceeded. Does not count as a request.

The 200 response is a RegistrationsCount object:

FieldTypeDescription
countintegerThe number of companies that match the filter.
filterobjectThe filter applied, with the resulting period.
upgrade_required_for_recordsbooleanWhether the list of these companies needs a higher plan than the key's.

BNR exchange rates

The reference exchange rate of the National Bank of Romania (BNR), since 2005.

GET /rest/v1/fx/latest

The latest published rate.

curl https://api.apifirme.dev/rest/v1/fx/latest \
  -H "Authorization: Bearer af_live_..."

Responses:

CodeWhat it means
200The rates of the last banking day.
401The API key is missing or not valid.
403The plan does not include this request (upgrade-required; upgrade_url leads to the plans), or the key's account is suspended (account-suspended; such a request is not counted).
404Does not exist: an unregistered CUI, no data for the day or year requested, or a CUI about which no data is served (withheld-on-request).
429The limit per minute or the month's number of requests has been exceeded. Does not count as a request.

The 200 response is a FxDay object:

FieldTypeDescription
datedateThe requested day.
effective_datedateThe banking day for which the rate was published.
basestringThe currency the rates are expressed in: RON.
ratesobjectFor each currency: rate, in lei for multiplier units of the currency.
sourceobjectThe source of the rate and when it was retrieved.

GET /rest/v1/fx/{date}

The rate of one day. For a day on which BNR does not publish (a weekend, a public holiday) the rate of the last banking day before it is returned; effective_date says which day that is.

ParameterWhereDescription
datein the path, requiredThe day, for example 2026-10-02.
curl https://api.apifirme.dev/rest/v1/fx/2026-10-02 \
  -H "Authorization: Bearer af_live_..."

Responses:

CodeWhat it means
200The rates valid on that day.
400A parameter is missing or not valid; detail says which. A 13-digit number in place of a CUI is a personal identification number (invalid-cui, said as such); an example pasted with its {cui} or af_live_... gets placeholder-left-in, which says what was to be replaced.
401The API key is missing or not valid.
403The plan does not include this request (upgrade-required; upgrade_url leads to the plans), or the key's account is suspended (account-suspended; such a request is not counted).
404Does not exist: an unregistered CUI, no data for the day or year requested, or a CUI about which no data is served (withheld-on-request).
429The limit per minute or the month's number of requests has been exceeded. Does not count as a request.

The 200 response is a FxDay object:

FieldTypeDescription
datedateThe requested day.
effective_datedateThe banking day for which the rate was published.
basestringThe currency the rates are expressed in: RON.
ratesobjectFor each currency: rate, in lei for multiplier units of the currency.
sourceobjectThe source of the rate and when it was retrieved.

GET /rest/v1/fx/series

A currency's rate over a period.

ParameterWhereDescription
currencyin the query, requiredThe currency code, for example EUR.
fromin the query, requiredThe first day.
toin the query, requiredThe last day.
curl https://api.apifirme.dev/rest/v1/fx/series?currency=EUR&from=2026-09-01&to=2026-09-30 \
  -H "Authorization: Bearer af_live_..."

Responses:

CodeWhat it means
200The rate of every banking day of the period.
400A parameter is missing or not valid; detail says which. A 13-digit number in place of a CUI is a personal identification number (invalid-cui, said as such); an example pasted with its {cui} or af_live_... gets placeholder-left-in, which says what was to be replaced.
401The API key is missing or not valid.
403The plan does not include this request (upgrade-required; upgrade_url leads to the plans), or the key's account is suspended (account-suspended; such a request is not counted).
429The limit per minute or the month's number of requests has been exceeded. Does not count as a request.

The 200 response is a FxSeries object:

FieldTypeDescription
currencystringThe currency.
basestringRON.
fromdateThe first day of the period.
todateThe last day of the period.
seriesarrayFor each banking day: date, rate and multiplier.

GET /rest/v1/fx/convert

Conversion between two currencies.

ParameterWhereDescription
fromin the query, requiredThe currency of the amount, for example EUR.
toin the query, requiredThe currency of the result, for example RON.
amountin the query, requiredThe amount.
datein the queryThe day of the rate. Today by default.
curl https://api.apifirme.dev/rest/v1/fx/convert?from=EUR&to=RON&amount=100 \
  -H "Authorization: Bearer af_live_..."

Responses:

CodeWhat it means
200The amount converted at BNR's rate.
400A parameter is missing or not valid; detail says which. A 13-digit number in place of a CUI is a personal identification number (invalid-cui, said as such); an example pasted with its {cui} or af_live_... gets placeholder-left-in, which says what was to be replaced.
401The API key is missing or not valid.
403The plan does not include this request (upgrade-required; upgrade_url leads to the plans), or the key's account is suspended (account-suspended; such a request is not counted).
404Does not exist: an unregistered CUI, no data for the day or year requested, or a CUI about which no data is served (withheld-on-request).
429The limit per minute or the month's number of requests has been exceeded. Does not count as a request.

The 200 response is a FxConversion object:

FieldTypeDescription
fromstringThe currency of the amount.
tostringThe currency of the result.
amountnumberThe amount.
resultnumberThe converted amount.
ratenumberThe rate used, from from to to.
datedateThe requested day.
effective_datedateThe banking day of the rate used.

Validation

Checks that need no key.

GET /rest/v1/validate/cui/{cui}

Check a CUI. Checks the form and the check digit. Does not say whether a company with this CUI exists. No key, free of charge.

Needs no key.

ParameterWhereDescription
cuiin the path, requiredThe unique registration code (CUI), with or without the RO prefix, for example 13548146.
curl https://api.apifirme.dev/rest/v1/validate/cui/13548146

Responses:

CodeWhat it means
200The result of the check.

The 200 response is a CuiValidation object:

FieldTypeDescription
cuiinteger or stringThe CUI as a number, if it is valid; otherwise the text received.
validbooleanWhether the form and the check digit are correct.

Webhooks

Plans that include the list of new companies can receive every new company at an address of their own, without asking. The address (https only) and the filters (CAEN codes, counties, legal or natural persons) are registered in the account; the secret the messages are signed with is shown there, once. The account also shows the latest deliveries, with how each one ended.

POST company.registered

Sent to the address registered in the account, a few minutes after a new company that matches the webhook's filters has entered our database. Like the list of new companies, a webhook also receives the natural persons who carry on an economic activity and the entries not classified yet (persoana_fizica is true or null respectively), unless the filter "legal or natural persons" in the account leaves them out. An entry not classified yet when it was indexed does not come back to the list merely because it is classified, so a webhook with "legal persons only" may never receive it. The X-Apifirme-Signature header has the form t=<Unix time>,v1=<signature>; the signature is HMAC-SHA256, in hexadecimal, over <t>.<request body>, with the webhook's secret as the key. Any 2xx answer coming within ten seconds confirms receipt; otherwise the delivery is retried up to eight times, with ever longer pauses, for almost a day. An address that did not answer in time is not called for a few minutes; the deliveries that fall in that time wait without losing a try, but no longer than their eight tries would have taken. Every company always has the same id, so a repeated delivery can be recognised; each webhook receives a company only once — the first time it matches its filters. After five deliveries in a row have been given up on, the webhook is switched off; it can be switched on again in the account, and the companies it missed are then delivered once more, as long as they are still among the new companies of its plan. A test message (test: true) can be sent from the account at any time.

The body is a RegistrationEvent object. Verifying the signature, for example in a shell:

printf '%s.%s' "$t" "$body" | openssl dgst -sha256 -hmac "$secret"

The result must be equal to v1 from the header; a t older than a few minutes can be rejected.

Structures

The objects the responses above refer to.

Company

FieldTypeDescription
cuiintegerThe unique registration code (CUI).
denumirestring or nullThe name, written for a reader; as the source writes it, in oficial.
nr_reg_comstring or nullThe registration number in the trade register.
adresa_completastring or nullThe company's address, in a single text, written for a reader: the fiscal domicile, as ANAF gives it, and for a company ANAF has not answered about, the registered office from the trade register. Where ANAF has the fiscal domicile elsewhere than the registered office, the county, locality and postal code are the domicile's too; the registered office is in sediu_social. As the source writes it, in oficial.
localitatestring or nullThe locality of the company's address, written for a reader; as the source writes it, in oficial.
judetstring or nullThe county code of the company's address: SB, B, ... The filters by county (new registrations, search, webhooks) go by the registered office's county (sediu_social.judet), which is the same for nearly every company.
cod_postalstring or nullThe postal code of the company's address, six digits. null where the source has none in use (codes from before 2003, incomplete values).
starestring or nullThe status, in one word: FUNCTIUNE (in operation), SUSPENDARE (suspended), REORGANIZARE JUDICIARA (judicial reorganisation), INSOLVENTA (insolvency), DIZOLVARE (dissolution), LICHIDARE (liquidation), FALIMENT (bankruptcy), RADIERE (struck off).
stare_detaliistring or nullThe state of the registration at ANAF, with its day, written for a reader in Romanian, with its diacritics: “Suspendare activitate din data 01.03.2025” (activity suspended), or, for a company absorbed in a merger, dissolution without liquidation (merger) with its day. It says more than stare (that the company was absorbed in a merger, for instance); as ANAF writes it, it is in oficial.stare_detalii. null where ANAF gives nothing.
persoana_fizicaboolean or nullfalse for a legal person, true for a natural person who carries on an economic activity (a sole trader: PFA, individual or family enterprise; a liberal profession), null while the sources do not tell.
forma_juridica_codstring or nullThe legal form from the trade register: SRL, SA, ...
forma_juridicastring or nullThe legal form as ANAF writes it.
caeninteger or nullThe CAEN code of the main activity (source: ANAF). CAEN is the Romanian classification of economic activities, aligned with NACE.
caen_denumirestring or nullThe name of the CAEN code, in the classification in force.
scp_tvabooleanWhether it is registered for VAT.
data_inceput_tvadate or nullSince when it has been registered for VAT.
data_sfarsit_tvadate or nullUntil when it was registered, if it no longer is.
tva_incasarebooleanWhether it applies VAT on collection.
split_tvabooleanWhether it applies split VAT payment.
e_facturabooleanWhether it is in the RO e-Factura register.
status_inactivbooleanWhether it is declared fiscally inactive.
data_inactivaredate or nullSince when it has been inactive.
data_inregistraredate or nullThe date of fiscal registration (source: ANAF).
data_inmatricularedate or nullThe date of entry in the trade register (source: ONRC).
telefonstring or nullThe telephone number declared to ANAF, as ANAF writes it. null also where ANAF has only a value without any digit other than 0 ("0", "0/0", "nedeclarat").
faxstring or nullThe fax number declared to ANAF, as ANAF writes it. null also where ANAF has only a value without any digit other than 0 ("0", "0/0", "nedeclarat").
webstring or nullThe web address declared to the trade register.
euidstring or nullThe European unique identifier (source: ONRC, the trade register).
sediu_secundarbooleanWhether it is the secondary seat of a company, registered at ANAF with a CUI of its own.
updated_ondate or nullThe day something in the company's data last changed.
changed_ondate or nullThe day a value already known about the company last changed; null if nothing has changed since we have it. Everything the sources give is followed: every field of ANAF's answer (the name, the addresses, the phone, the fax, the postal code, the state, the CAEN code, VAT, VAT on collection, split VAT, inactivity, e-Factura), the trade register's data and the fiscal obligations. A piece of information that was missing and has been filled in is not a change, nor is one only written differently (capitals, spacing, an s or t with a cedilla for one with a comma).
checked_ondate or nullThe day ANAF was last asked about the company; null if not yet.
sediu_socialobjectThe registered office, as ANAF and the trade register give it: judet, localitate, strada, numar, detalii and cod_postal, written for a reader (as the source writes them, in oficial.sediu_social). For nearly every company it is the same address as above; it differs where the fiscal domicile declared to ANAF is elsewhere.
obligatii_fiscaleFiscalObligations or nullThe fiscal obligations the taxpayer was registered for (its “vector fiscal”), from the list the Ministry of Finance publishes once a year: the state on the list's day (la_data), not today's. null when they are not known: the company is not in the list, or was taken in after the list was imported. It does not mean that it has no obligations.
stari_registruarrayAll statuses and remarks from the trade register, each with cod (code) and denumire (name).
caen_autorizatearray or nullThe activities the company is authorised for, from the trade register's open data: each with cod (code), versiune (the version of the CAEN classification it was declared in: 3 is the one of 2025, 2 the one of 2008, 1 the one of 2003, 0 the one of 1998) and denumire (name), the newest classification first. The register also keeps what was declared in the old classifications, so the same activity can appear with codes of several versions. null when they are not known (the company is not in the register's dataset), which does not mean that it has none.
sourcesarray of SourceWhich sources the company's data comes from, and since when.
oficialobjectThe name (denumire), the locality (localitate), the address (adresa_completa), the postal code (cod_postal), the state at ANAF (stare_detalii) and, of the registered office, the locality, street, details and postal code (sediu_social) as the source writes them, mostly in capitals (a postal code that is not six digits is given above as null, here as it is). The fields above are written for a reader: only upper and lower case, spacing, punctuation, ş and ţ (written with the comma below) and the form of a few abbreviations change (STR becomes Str., NR. becomes nr.); no word and no number is left out or moved. The legal form stays as it was registered (SRL or S.R.L.).

FiscalObligations

FieldTypeDescription
la_datadateThe list's day: the day up to which the ministry had processed the declarations it contains. The list is published once a year, and everything here is the state on that day.
regim_impozitarestring or nullHow the income was taxed, by the obligations in the list: profit (profit tax, code 100), micro (micro-enterprise income tax, 120) or specific (specific tax, 130); null when the list has none of them, or more than one.
obligatiiarrayThe obligations it was registered for, each with cod (the ministry's code: 100 profit tax, 120 micro-enterprise income tax, 200 excise duties, 602 tax on salaries, 480 work insurance contribution, ...) and denumire, the obligation's Romanian name. An empty list means that the ministry had the taxpayer in its list, without any obligation.
ultima_declaratiedate or nullThe day the taxpayer's last declaration was registered, as the list gives it (“data inregistrarii ultimei declaratii”, in the ministry's words). It is not the date of fiscal registration, nor that of the last tax return (companies with employees file every month, and for most of them this date is more than a year old): by every sign it is the last declaration about the fiscal registration, such as a change of the obligations.
ultima_prelucraredate or nullThe day the ministry last processed the taxpayer's data, as the list gives it (“data ultimei prelucrari”, in the ministry's words).

Source

FieldTypeDescription
sourcestringThe source's key: anaf_ws, onrc_bulk, mf_financials, anaf_bilant, mf_vector_fiscal.
namestringThe source's name.
publisherstringThe institution that publishes the data.
licencestring or nullThe licence under which the data is published, where one is stated.
datasetstring or nullThe dataset the information was last taken from, for the sources that publish files.
dataset_urlstring or nullThe dataset's page (for financial statements).
published_atdate-time or nullWhen the institution published the file (for financial statements); null for those taken from ANAF's web service, which does not say when it published them.
first_retrieved_ondate or nullThe day the source first supplied the information.
last_retrieved_ondate or nullThe day it last supplied it.
import_run_idinteger or nullThe import run that brought the information.

Event

FieldTypeDescription
typestringThe kind of change: vat_registered, vat_deregistered, vat_on_collection_started, vat_on_collection_ended, split_vat_started, split_vat_ended, inactivated, reactivated, efactura_registered, efactura_deregistered, struck_off, status_changed, name_changed, address_changed, caen_changed.
oldobject or nullThe value before, under the name of the field that changed (denumire, adresa_completa, stare, caen); null when the event is a beginning or an end. A name or an address is written for a reader, as in a company's data.
newobject or nullThe value after, likewise.
occurred_ondate or nullThe day the source gives for the change, where it gives one (for example the beginning of the VAT period).
detected_ondateThe day we observed the change.
sourcestringThe key of the source in whose answer the change appeared: anaf_ws.
oficialobject or nullFor a change of name or address, the value before (old) and the one after (new) as the source writes them; null for the others.

Statement

FieldTypeDescription
cuiintegerThe company's CUI.
anintegerThe year of the financial statement.
tip_raportarestringThe Ministry of Finance's reporting type: UU (abbreviated balance sheet), BL_BS_SL, IR (IFRS), ONG (non-profit organisations), ... ANAF's web service does not give the type: for a statement taken from there it is inferred from its indicators, and where several types have the same indicators it is the company's type of the year before.
tip_raportare_descrierestring or nullWhat kind of taxpayers file this type.
caeninteger or nullThe CAEN code from the financial statement.
caen_denumirestring or nullThe name of the code, in the classification in force in that year.
active_imobilizateinteger or nullFixed assets, total. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
active_circulanteinteger or nullCurrent assets, total. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
stocuriinteger or nullInventories. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
creanteinteger or nullReceivables. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
casa_bancainteger or nullCash and bank accounts. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
cheltuieli_avansinteger or nullPrepaid expenses. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
datoriiinteger or nullLiabilities. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
venituri_avansinteger or nullDeferred income. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
provizioaneinteger or nullProvisions. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
capitaluri_totalinteger or nullEquity, total. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
capital_socialinteger or nullSubscribed and paid-up share capital. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
patrimoniul_regieiinteger or nullPatrimony of the autonomous state enterprise (regie). In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
cifra_afaceriinteger or nullNet turnover. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
venituri_totaleinteger or nullTotal income. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
cheltuieli_totaleinteger or nullTotal expenses. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
profit_brutinteger or nullGross profit. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
pierdere_brutainteger or nullGross loss. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
profit_netinteger or nullNet profit. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
pierdere_netainteger or nullNet loss. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
nr_mediu_salariatiinteger or nullAverage number of employees. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service).
alti_indicatoriarrayThe indicators this reporting type has in addition, each with cod (code), denumire (name) and valoare (value).
updated_atdate-timeWhen the statement last changed in our database.
sourcesarray of SourceWhere the statement comes from (the ministry's dataset and when it published it, or ANAF's web service) and when we retrieved it.

Registration

FieldTypeDescription
cuiintegerThe unique registration code (CUI).
denumirestring or nullThe name, written for a reader; as the source writes it, in oficial.
nr_reg_comstring or nullThe registration number in the trade register.
adresa_completastring or nullThe company's address, in a single text, written for a reader: the fiscal domicile, as ANAF gives it, and for a company ANAF has not answered about, the registered office from the trade register. Where ANAF has the fiscal domicile elsewhere than the registered office, the county, locality and postal code are the domicile's too; the registered office is in sediu_social. As the source writes it, in oficial.
localitatestring or nullThe locality of the company's address, written for a reader; as the source writes it, in oficial.
judetstring or nullThe county code of the company's address: SB, B, ... The filters by county (new registrations, search, webhooks) go by the registered office's county (sediu_social.judet), which is the same for nearly every company.
cod_postalstring or nullThe postal code of the company's address, six digits. null where the source has none in use (codes from before 2003, incomplete values).
starestring or nullThe status, in one word: FUNCTIUNE (in operation), SUSPENDARE (suspended), REORGANIZARE JUDICIARA (judicial reorganisation), INSOLVENTA (insolvency), DIZOLVARE (dissolution), LICHIDARE (liquidation), FALIMENT (bankruptcy), RADIERE (struck off).
stare_detaliistring or nullThe state of the registration at ANAF, with its day, written for a reader in Romanian, with its diacritics: “Suspendare activitate din data 01.03.2025” (activity suspended), or, for a company absorbed in a merger, dissolution without liquidation (merger) with its day. It says more than stare (that the company was absorbed in a merger, for instance); as ANAF writes it, it is in oficial.stare_detalii. null where ANAF gives nothing.
persoana_fizicaboolean or nullfalse for a legal person, true for a natural person who carries on an economic activity (a sole trader: PFA, individual or family enterprise; a liberal profession), null while the sources do not tell.
forma_juridica_codstring or nullThe legal form from the trade register: SRL, SA, ...
forma_juridicastring or nullThe legal form as ANAF writes it.
caeninteger or nullThe CAEN code of the main activity (source: ANAF). CAEN is the Romanian classification of economic activities, aligned with NACE.
caen_denumirestring or nullThe name of the CAEN code, in the classification in force.
scp_tvabooleanWhether it is registered for VAT.
data_inceput_tvadate or nullSince when it has been registered for VAT.
data_sfarsit_tvadate or nullUntil when it was registered, if it no longer is.
tva_incasarebooleanWhether it applies VAT on collection.
split_tvabooleanWhether it applies split VAT payment.
e_facturabooleanWhether it is in the RO e-Factura register.
status_inactivbooleanWhether it is declared fiscally inactive.
data_inactivaredate or nullSince when it has been inactive.
data_inregistraredate or nullThe date of fiscal registration (source: ANAF).
data_inmatricularedate or nullThe date of entry in the trade register (source: ONRC).
registered_ondate or nullThe registration date: the entry in the trade register where it is known, otherwise the fiscal registration at ANAF.
telefonstring or nullThe telephone number declared to ANAF, as ANAF writes it. null also where ANAF has only a value without any digit other than 0 ("0", "0/0", "nedeclarat").
faxstring or nullThe fax number declared to ANAF, as ANAF writes it. null also where ANAF has only a value without any digit other than 0 ("0", "0/0", "nedeclarat").
webstring or nullThe web address declared to the trade register.
euidstring or nullThe European unique identifier (source: ONRC, the trade register).
sediu_secundarbooleanWhether it is the secondary seat of a company, registered at ANAF with a CUI of its own.
updated_ondate or nullThe day something in the company's data last changed.
changed_ondate or nullThe day a value already known about the company last changed; null if nothing has changed since we have it. Everything the sources give is followed: every field of ANAF's answer (the name, the addresses, the phone, the fax, the postal code, the state, the CAEN code, VAT, VAT on collection, split VAT, inactivity, e-Factura), the trade register's data and the fiscal obligations. A piece of information that was missing and has been filled in is not a change, nor is one only written differently (capitals, spacing, an s or t with a cedilla for one with a comma).
checked_ondate or nullThe day ANAF was last asked about the company; null if not yet.
sediu_socialobjectThe registered office, as ANAF and the trade register give it: judet, localitate, strada, numar, detalii and cod_postal, written for a reader (as the source writes them, in oficial.sediu_social). For nearly every company it is the same address as above; it differs where the fiscal domicile declared to ANAF is elsewhere.
obligatii_fiscaleFiscalObligations or nullThe fiscal obligations the taxpayer was registered for (its “vector fiscal”), from the list the Ministry of Finance publishes once a year: the state on the list's day (la_data), not today's. null when they are not known: the company is not in the list, or was taken in after the list was imported. It does not mean that it has no obligations.
stari_registruarrayAll statuses and remarks from the trade register, each with cod (code) and denumire (name).
caen_autorizatearray or nullThe activities the company is authorised for, from the trade register's open data: each with cod (code), versiune (the version of the CAEN classification it was declared in: 3 is the one of 2025, 2 the one of 2008, 1 the one of 2003, 0 the one of 1998) and denumire (name), the newest classification first. The register also keeps what was declared in the old classifications, so the same activity can appear with codes of several versions. null when they are not known (the company is not in the register's dataset), which does not mean that it has none.
sourcesarray of SourceWhich sources the company's data comes from, and since when.
oficialobjectThe name (denumire), the locality (localitate), the address (adresa_completa), the postal code (cod_postal), the state at ANAF (stare_detalii) and, of the registered office, the locality, street, details and postal code (sediu_social) as the source writes them, mostly in capitals (a postal code that is not six digits is given above as null, here as it is). The fields above are written for a reader: only upper and lower case, spacing, punctuation, ş and ţ (written with the comma below) and the form of a few abbreviations change (STR becomes Str., NR. becomes nr.); no word and no number is left out or moved. The legal form stays as it was registered (SRL or S.R.L.).

RegistrationEvent

FieldTypeDescription
idstringIdentifies the event: company.registered: followed by the CUI. The same on every retry.
typestringThe kind of event: company.registered.
testbooleantrue for a test message requested from the account: it has the form of a real one, with some company, and an id that starts with test:.
created_atdate-timeWhen the event was created.
dataRegistrationThe company, exactly as GET /rest/v1/registrations returns it.

Problem

FieldTypeDescription
typestringThe address that identifies the kind of error.
titlestringThe error, in short.
statusintegerThe HTTP status code.
detailstringWhat exactly went wrong.