API documentation
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.
| Parameter | Where | Description |
|---|---|---|
cui | in the path, required | The 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:
| Code | What it means |
|---|---|
200 | The company. |
202 | The 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. |
400 | A 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. |
401 | The API key is missing or not valid. |
403 | The 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). |
404 | Does 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). |
429 | The limit per minute or the month's number of requests has been exceeded. Does not count as a request. |
503 | The 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:
| Field | Type | Description |
|---|---|---|
cui | integer | The unique registration code (CUI). |
denumire | string or null | The name, written for a reader; as the source writes it, in oficial. |
nr_reg_com | string or null | The registration number in the trade register. |
adresa_completa | string or null | The 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. |
localitate | string or null | The locality of the company's address, written for a reader; as the source writes it, in oficial. |
judet | string or null | The 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_postal | string or null | The postal code of the company's address, six digits. null where the source has none in use (codes from before 2003, incomplete values). |
stare | string or null | The 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_detalii | string or null | The 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_fizica | boolean or null | false 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_cod | string or null | The legal form from the trade register: SRL, SA, ... |
forma_juridica | string or null | The legal form as ANAF writes it. |
caen | integer or null | The CAEN code of the main activity (source: ANAF). CAEN is the Romanian classification of economic activities, aligned with NACE. |
caen_denumire | string or null | The name of the CAEN code, in the classification in force. |
scp_tva | boolean | Whether it is registered for VAT. |
data_inceput_tva | date or null | Since when it has been registered for VAT. |
data_sfarsit_tva | date or null | Until when it was registered, if it no longer is. |
tva_incasare | boolean | Whether it applies VAT on collection. |
split_tva | boolean | Whether it applies split VAT payment. |
e_factura | boolean | Whether it is in the RO e-Factura register. |
status_inactiv | boolean | Whether it is declared fiscally inactive. |
data_inactivare | date or null | Since when it has been inactive. |
data_inregistrare | date or null | The date of fiscal registration (source: ANAF). |
data_inmatriculare | date or null | The date of entry in the trade register (source: ONRC). |
telefon | string or null | The 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"). |
fax | string or null | The 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"). |
web | string or null | The web address declared to the trade register. |
euid | string or null | The European unique identifier (source: ONRC, the trade register). |
sediu_secundar | boolean | Whether it is the secondary seat of a company, registered at ANAF with a CUI of its own. |
updated_on | date or null | The day something in the company's data last changed. |
changed_on | date or null | The 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_on | date or null | The day ANAF was last asked about the company; null if not yet. |
sediu_social | object | The 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_fiscale | FiscalObligations or null | The 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_registru | array | All statuses and remarks from the trade register, each with cod (code) and denumire (name). |
caen_autorizate | array or null | The 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. |
sources | array of Source | Which sources the company's data comes from, and since when. |
oficial | object | The 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:
| Field | Type | Description |
|---|---|---|
cuis | array | Between 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:
| Code | What it means |
|---|---|
200 | The companies found, and what became of the other CUIs. |
400 | A 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. |
401 | The API key is missing or not valid. |
403 | The 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). |
429 | The 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:
| Field | Type | Description |
|---|---|---|
data | array of Company | The companies found, in the order in which they were asked for. |
not_stored | array | The valid CUIs that are not in the database yet. They cost nothing; asked for by themselves, they are looked up at ANAF. |
incomplete | array | The 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. |
invalid | array | What is not a valid CUI, as it was received. |
GET /rest/v1/companies/search
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.
| Parameter | Where | Description |
|---|---|---|
denumire | in the query | The company's name or a part of it: at least one word of three letters or digits, beside the legal form. |
nr_reg_com | in the query | The 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. |
judet | in the query | With 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:
| Code | What it means |
|---|---|
200 | The companies found. |
400 | A 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. |
401 | The API key is missing or not valid. |
403 | The 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). |
429 | The 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:
| Field | Type | Description |
|---|---|---|
data | array of CompanyFound | The companies found, the closest first: at most 10. |
more | boolean | true 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.
| Parameter | Where | Description |
|---|---|---|
cui | in the path, required | The 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:
| Code | What it means |
|---|---|
200 | The changes observed at the company. |
400 | A 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. |
401 | The API key is missing or not valid. |
403 | The 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). |
404 | Does 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). |
429 | The 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:
| Field | Type | Description |
|---|---|---|
cui | integer | The company's CUI. |
events | array of Event | The 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).
| Parameter | Where | Description |
|---|---|---|
cui | in the path, required | The 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:
| Code | What it means |
|---|---|
200 | The result of the check. |
202 | The 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. |
400 | A 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. |
401 | The API key is missing or not valid. |
403 | The 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). |
404 | Does 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). |
429 | The limit per minute or the month's number of requests has been exceeded. Does not count as a request. |
503 | The 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:
| Field | Type | Description |
|---|---|---|
cui | integer | The unique registration code (CUI). |
denumire | string or null | The name, written for a reader; as the source writes it, in oficial. |
exists | boolean | Whether ANAF knows a taxpayer with this CUI. |
valid_for_invoicing | boolean | Whether the company exists, is not struck off and is not fiscally inactive. |
vat_registered | boolean | Whether it is registered for VAT. |
vat_number | string or null | The VAT number (RO followed by the CUI), if it is registered for VAT. |
vat_on_collection | boolean | Whether it applies VAT on collection. |
split_vat | boolean | Whether it applies split VAT payment. |
inactive | boolean | Whether it is declared fiscally inactive. |
struck_off | boolean | Whether it is struck off. |
efactura_registered | boolean | Whether it is in the RO e-Factura register. |
stare | string or null | The status, in one word, as in the company's data. |
checked_on | date or null | The day ANAF last answered about the company. |
oficial | object or null | The 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.
| Parameter | Where | Description |
|---|---|---|
cui | in the path, required | The 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:
| Code | What it means |
|---|---|
200 | The company's financial statements. |
400 | A 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. |
401 | The API key is missing or not valid. |
403 | The 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). |
404 | Does 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). |
429 | The 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:
| Field | Type | Description |
|---|---|---|
cui | integer | The company's CUI. |
financials | array of Statement | The financial statements, the most recent year first. |
GET /rest/v1/companies/{cui}/financials/{year}
The financial statement of one year.
| Parameter | Where | Description |
|---|---|---|
cui | in the path, required | The unique registration code (CUI), with or without the RO prefix, for example 13548146. |
year | in the path, required | The 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:
| Code | What it means |
|---|---|
200 | The financial statement of that year. |
400 | A 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. |
401 | The API key is missing or not valid. |
403 | The 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). |
404 | Does 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). |
429 | The 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:
| Field | Type | Description |
|---|---|---|
cui | integer | The company's CUI. |
an | integer | The year of the financial statement. |
tip_raportare | string | The 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_descriere | string or null | What kind of taxpayers file this type. |
caen | integer or null | The CAEN code from the financial statement. |
caen_denumire | string or null | The name of the code, in the classification in force in that year. |
active_imobilizate | integer or null | Fixed assets, total. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
active_circulante | integer or null | Current assets, total. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
stocuri | integer or null | Inventories. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
creante | integer or null | Receivables. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
casa_banca | integer or null | Cash 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_avans | integer or null | Prepaid expenses. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
datorii | integer or null | Liabilities. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
venituri_avans | integer or null | Deferred income. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
provizioane | integer or null | Provisions. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
capitaluri_total | integer or null | Equity, total. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
capital_social | integer or null | Subscribed 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_regiei | integer or null | Patrimony 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_afaceri | integer or null | Net turnover. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
venituri_totale | integer or null | Total income. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
cheltuieli_totale | integer or null | Total expenses. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
profit_brut | integer or null | Gross profit. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
pierdere_bruta | integer or null | Gross loss. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
profit_net | integer or null | Net profit. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
pierdere_neta | integer or null | Net loss. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
nr_mediu_salariati | integer or null | Average 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_indicatori | array | The indicators this reporting type has in addition, each with cod (code), denumire (name) and valoare (value). |
updated_at | date-time | When the statement last changed in our database. |
sources | array of Source | Where 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.
| Parameter | Where | Description |
|---|---|---|
days | in the query | The companies registered in the last so many days. Not together with registered_after. |
registered_after | in the query | The companies registered on or after this day. |
caen | in the query | One or more four-digit CAEN codes, separated by commas. |
caen_prefix | in the query | The first two digits (the division) or three (the group) of the CAEN code. |
judet | in the query | One or more county codes (SB, B), separated by commas: the registered office's county. |
forma_juridica | in the query | One or more legal forms, by the trade register's codes (SRL, SA), separated by commas. |
persoana_fizica | in the query | true 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. |
limit | in the query | How many companies per page, between 1 and 500. 100 by default. |
cursor | in the query | The 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:
| Code | What it means |
|---|---|
200 | A page of new companies. |
400 | A 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. |
401 | The API key is missing or not valid. |
403 | The 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). |
429 | The 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:
| Field | Type | Description |
|---|---|---|
data | array of Registration | The companies, in the order in which they were indexed. |
next_cursor | string | To 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. |
more | boolean | Whether there are more companies after this page. |
filter | object | The 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.
| Parameter | Where | Description |
|---|---|---|
days | in the query | The companies registered in the last so many days. Not together with registered_after. |
registered_after | in the query | The companies registered on or after this day. |
caen | in the query | One or more four-digit CAEN codes, separated by commas. |
caen_prefix | in the query | The first two digits (the division) or three (the group) of the CAEN code. |
judet | in the query | One or more county codes (SB, B), separated by commas: the registered office's county. |
forma_juridica | in the query | One or more legal forms, by the trade register's codes (SRL, SA), separated by commas. |
persoana_fizica | in the query | true 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:
| Code | What it means |
|---|---|
200 | The number of companies. |
400 | A 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. |
401 | The API key is missing or not valid. |
403 | The 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). |
429 | The 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:
| Field | Type | Description |
|---|---|---|
count | integer | The number of companies that match the filter. |
filter | object | The filter applied, with the resulting period. |
upgrade_required_for_records | boolean | Whether 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:
| Code | What it means |
|---|---|
200 | The rates of the last banking day. |
401 | The API key is missing or not valid. |
403 | The 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). |
404 | Does 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). |
429 | The 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:
| Field | Type | Description |
|---|---|---|
date | date | The requested day. |
effective_date | date | The banking day for which the rate was published. |
base | string | The currency the rates are expressed in: RON. |
rates | object | For each currency: rate, in lei for multiplier units of the currency. |
source | object | The 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.
| Parameter | Where | Description |
|---|---|---|
date | in the path, required | The day, for example 2026-10-02. |
curl https://api.apifirme.dev/rest/v1/fx/2026-10-02 \
-H "Authorization: Bearer af_live_..."
Responses:
| Code | What it means |
|---|---|
200 | The rates valid on that day. |
400 | A 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. |
401 | The API key is missing or not valid. |
403 | The 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). |
404 | Does 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). |
429 | The 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:
| Field | Type | Description |
|---|---|---|
date | date | The requested day. |
effective_date | date | The banking day for which the rate was published. |
base | string | The currency the rates are expressed in: RON. |
rates | object | For each currency: rate, in lei for multiplier units of the currency. |
source | object | The source of the rate and when it was retrieved. |
GET /rest/v1/fx/series
A currency's rate over a period.
| Parameter | Where | Description |
|---|---|---|
currency | in the query, required | The currency code, for example EUR. |
from | in the query, required | The first day. |
to | in the query, required | The 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:
| Code | What it means |
|---|---|
200 | The rate of every banking day of the period. |
400 | A 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. |
401 | The API key is missing or not valid. |
403 | The 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). |
429 | The 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:
| Field | Type | Description |
|---|---|---|
currency | string | The currency. |
base | string | RON. |
from | date | The first day of the period. |
to | date | The last day of the period. |
series | array | For each banking day: date, rate and multiplier. |
GET /rest/v1/fx/convert
Conversion between two currencies.
| Parameter | Where | Description |
|---|---|---|
from | in the query, required | The currency of the amount, for example EUR. |
to | in the query, required | The currency of the result, for example RON. |
amount | in the query, required | The amount. |
date | in the query | The 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:
| Code | What it means |
|---|---|
200 | The amount converted at BNR's rate. |
400 | A 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. |
401 | The API key is missing or not valid. |
403 | The 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). |
404 | Does 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). |
429 | The 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:
| Field | Type | Description |
|---|---|---|
from | string | The currency of the amount. |
to | string | The currency of the result. |
amount | number | The amount. |
result | number | The converted amount. |
rate | number | The rate used, from from to to. |
date | date | The requested day. |
effective_date | date | The 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.
| Parameter | Where | Description |
|---|---|---|
cui | in the path, required | The unique registration code (CUI), with or without the RO prefix, for example 13548146. |
curl https://api.apifirme.dev/rest/v1/validate/cui/13548146
Responses:
| Code | What it means |
|---|---|
200 | The result of the check. |
The 200 response is a CuiValidation object:
| Field | Type | Description |
|---|---|---|
cui | integer or string | The CUI as a number, if it is valid; otherwise the text received. |
valid | boolean | Whether 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
| Field | Type | Description |
|---|---|---|
cui | integer | The unique registration code (CUI). |
denumire | string or null | The name, written for a reader; as the source writes it, in oficial. |
nr_reg_com | string or null | The registration number in the trade register. |
adresa_completa | string or null | The 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. |
localitate | string or null | The locality of the company's address, written for a reader; as the source writes it, in oficial. |
judet | string or null | The 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_postal | string or null | The postal code of the company's address, six digits. null where the source has none in use (codes from before 2003, incomplete values). |
stare | string or null | The 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_detalii | string or null | The 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_fizica | boolean or null | false 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_cod | string or null | The legal form from the trade register: SRL, SA, ... |
forma_juridica | string or null | The legal form as ANAF writes it. |
caen | integer or null | The CAEN code of the main activity (source: ANAF). CAEN is the Romanian classification of economic activities, aligned with NACE. |
caen_denumire | string or null | The name of the CAEN code, in the classification in force. |
scp_tva | boolean | Whether it is registered for VAT. |
data_inceput_tva | date or null | Since when it has been registered for VAT. |
data_sfarsit_tva | date or null | Until when it was registered, if it no longer is. |
tva_incasare | boolean | Whether it applies VAT on collection. |
split_tva | boolean | Whether it applies split VAT payment. |
e_factura | boolean | Whether it is in the RO e-Factura register. |
status_inactiv | boolean | Whether it is declared fiscally inactive. |
data_inactivare | date or null | Since when it has been inactive. |
data_inregistrare | date or null | The date of fiscal registration (source: ANAF). |
data_inmatriculare | date or null | The date of entry in the trade register (source: ONRC). |
telefon | string or null | The 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"). |
fax | string or null | The 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"). |
web | string or null | The web address declared to the trade register. |
euid | string or null | The European unique identifier (source: ONRC, the trade register). |
sediu_secundar | boolean | Whether it is the secondary seat of a company, registered at ANAF with a CUI of its own. |
updated_on | date or null | The day something in the company's data last changed. |
changed_on | date or null | The 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_on | date or null | The day ANAF was last asked about the company; null if not yet. |
sediu_social | object | The 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_fiscale | FiscalObligations or null | The 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_registru | array | All statuses and remarks from the trade register, each with cod (code) and denumire (name). |
caen_autorizate | array or null | The 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. |
sources | array of Source | Which sources the company's data comes from, and since when. |
oficial | object | The 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
| Field | Type | Description |
|---|---|---|
la_data | date | The 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_impozitare | string or null | How 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. |
obligatii | array | The 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_declaratie | date or null | The 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_prelucrare | date or null | The day the ministry last processed the taxpayer's data, as the list gives it (“data ultimei prelucrari”, in the ministry's words). |
Source
| Field | Type | Description |
|---|---|---|
source | string | The source's key: anaf_ws, onrc_bulk, mf_financials, anaf_bilant, mf_vector_fiscal. |
name | string | The source's name. |
publisher | string | The institution that publishes the data. |
licence | string or null | The licence under which the data is published, where one is stated. |
dataset | string or null | The dataset the information was last taken from, for the sources that publish files. |
dataset_url | string or null | The dataset's page (for financial statements). |
published_at | date-time or null | When 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_on | date or null | The day the source first supplied the information. |
last_retrieved_on | date or null | The day it last supplied it. |
import_run_id | integer or null | The import run that brought the information. |
Event
| Field | Type | Description |
|---|---|---|
type | string | The 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. |
old | object or null | The 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. |
new | object or null | The value after, likewise. |
occurred_on | date or null | The day the source gives for the change, where it gives one (for example the beginning of the VAT period). |
detected_on | date | The day we observed the change. |
source | string | The key of the source in whose answer the change appeared: anaf_ws. |
oficial | object or null | For 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
| Field | Type | Description |
|---|---|---|
cui | integer | The company's CUI. |
an | integer | The year of the financial statement. |
tip_raportare | string | The 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_descriere | string or null | What kind of taxpayers file this type. |
caen | integer or null | The CAEN code from the financial statement. |
caen_denumire | string or null | The name of the code, in the classification in force in that year. |
active_imobilizate | integer or null | Fixed assets, total. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
active_circulante | integer or null | Current assets, total. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
stocuri | integer or null | Inventories. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
creante | integer or null | Receivables. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
casa_banca | integer or null | Cash 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_avans | integer or null | Prepaid expenses. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
datorii | integer or null | Liabilities. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
venituri_avans | integer or null | Deferred income. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
provizioane | integer or null | Provisions. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
capitaluri_total | integer or null | Equity, total. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
capital_social | integer or null | Subscribed 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_regiei | integer or null | Patrimony 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_afaceri | integer or null | Net turnover. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
venituri_totale | integer or null | Total income. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
cheltuieli_totale | integer or null | Total expenses. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
profit_brut | integer or null | Gross profit. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
pierdere_bruta | integer or null | Gross loss. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
profit_net | integer or null | Net profit. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
pierdere_neta | integer or null | Net loss. In whole lei; null if the ministry does not publish the value (zero in statements taken from ANAF's web service). |
nr_mediu_salariati | integer or null | Average 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_indicatori | array | The indicators this reporting type has in addition, each with cod (code), denumire (name) and valoare (value). |
updated_at | date-time | When the statement last changed in our database. |
sources | array of Source | Where the statement comes from (the ministry's dataset and when it published it, or ANAF's web service) and when we retrieved it. |
Registration
| Field | Type | Description |
|---|---|---|
cui | integer | The unique registration code (CUI). |
denumire | string or null | The name, written for a reader; as the source writes it, in oficial. |
nr_reg_com | string or null | The registration number in the trade register. |
adresa_completa | string or null | The 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. |
localitate | string or null | The locality of the company's address, written for a reader; as the source writes it, in oficial. |
judet | string or null | The 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_postal | string or null | The postal code of the company's address, six digits. null where the source has none in use (codes from before 2003, incomplete values). |
stare | string or null | The 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_detalii | string or null | The 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_fizica | boolean or null | false 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_cod | string or null | The legal form from the trade register: SRL, SA, ... |
forma_juridica | string or null | The legal form as ANAF writes it. |
caen | integer or null | The CAEN code of the main activity (source: ANAF). CAEN is the Romanian classification of economic activities, aligned with NACE. |
caen_denumire | string or null | The name of the CAEN code, in the classification in force. |
scp_tva | boolean | Whether it is registered for VAT. |
data_inceput_tva | date or null | Since when it has been registered for VAT. |
data_sfarsit_tva | date or null | Until when it was registered, if it no longer is. |
tva_incasare | boolean | Whether it applies VAT on collection. |
split_tva | boolean | Whether it applies split VAT payment. |
e_factura | boolean | Whether it is in the RO e-Factura register. |
status_inactiv | boolean | Whether it is declared fiscally inactive. |
data_inactivare | date or null | Since when it has been inactive. |
data_inregistrare | date or null | The date of fiscal registration (source: ANAF). |
data_inmatriculare | date or null | The date of entry in the trade register (source: ONRC). |
registered_on | date or null | The registration date: the entry in the trade register where it is known, otherwise the fiscal registration at ANAF. |
telefon | string or null | The 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"). |
fax | string or null | The 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"). |
web | string or null | The web address declared to the trade register. |
euid | string or null | The European unique identifier (source: ONRC, the trade register). |
sediu_secundar | boolean | Whether it is the secondary seat of a company, registered at ANAF with a CUI of its own. |
updated_on | date or null | The day something in the company's data last changed. |
changed_on | date or null | The 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_on | date or null | The day ANAF was last asked about the company; null if not yet. |
sediu_social | object | The 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_fiscale | FiscalObligations or null | The 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_registru | array | All statuses and remarks from the trade register, each with cod (code) and denumire (name). |
caen_autorizate | array or null | The 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. |
sources | array of Source | Which sources the company's data comes from, and since when. |
oficial | object | The 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
| Field | Type | Description |
|---|---|---|
id | string | Identifies the event: company.registered: followed by the CUI. The same on every retry. |
type | string | The kind of event: company.registered. |
test | boolean | true 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_at | date-time | When the event was created. |
data | Registration | The company, exactly as GET /rest/v1/registrations returns it. |
Problem
| Field | Type | Description |
|---|---|---|
type | string | The address that identifies the kind of error. |
title | string | The error, in short. |
status | integer | The HTTP status code. |
detail | string | What exactly went wrong. |