Where the data comes from and how it is kept current
Everything the API returns comes from official public registries: we do not fill in, estimate or mix in data from unofficial sources. Every response has a sources field that says, for each source, when it first and last supplied the information and from which dataset.
The sources
| Source | What we take | How often |
|---|---|---|
| National Trade Register Office (ONRC), open data on data.gov.ro (licence CC BY 4.0) | The companies in the trade register: name, CUI, registration number, EUID, legal form, registered office, the register's statuses, the authorised activities | With every published dataset, about monthly |
| National Agency for Fiscal Administration (ANAF), the public web service for VAT | Fiscal status, VAT registration, VAT on collection, split VAT payment, inactivity, e-Factura, CAEN code | Daily for new companies, weekly for active VAT-registered ones, every two months for the rest |
| Ministry of Finance, open data on data.gov.ro | The annual financial statements, since 2008 | With every publication, usually once a year, with updates |
| Ministry of Finance, open data on data.gov.ro (licence CC BY 4.0) | Each taxpayer's fiscal obligations (the "vector fiscal"), as of the list's day | With every list published, once a year |
| National Bank of Romania | The reference exchange rate, since 2005 | Every banking day |
New companies
A newly registered company usually appears here on the day after its registration.
Whoever follows the new companies needs two things, which must not be confused:
registered_onis the registration date: the entry in the trade register where we know it; otherwise, the fiscal registration at ANAF, which takes place a few days later. The period is chosen by it (days,registered_after).next_cursorsays where to continue from. Whoever asks daily keeps thenext_cursorof the last answer — even from the last page — and sends it the next day ascursor. Do not continue by the registration date: a company registered on a Monday may be indexed on the Friday, and the cursor brings that one too.
A company's secondary seat gets a CUI of its own at ANAF. It can be looked up by that CUI, but we neither count it nor return it as a new company.
The list includes natural persons who carry on an economic activity too. With persoana_fizica=false only legal persons are asked for, with persoana_fizica=true only natural persons; an entry we cannot classify yet appears in neither, and is not given a second time when we classify it.
What the dates in a response mean
updated_on: the day something in the company's data last changed.changed_on: the day a source last replaced something we already knew with something else (any field ANAF gives, from the name, the addresses and the phone to VAT and e-Factura, the trade register's data, the fiscal obligations). It is empty while nothing has changed since we have the company; a piece of information filled in where it was missing is not a change.checked_on: the day we last asked ANAF about the company, even if nothing had changed. It is empty for a company known so far only from the trade register's dataset.data_inmatriculare: the date of entry in the trade register (source: ONRC).data_inregistrare: the date of fiscal registration (source: ANAF).stare: the company's status in a single word:FUNCTIUNE,SUSPENDARE,REORGANIZARE JUDICIARA,INSOLVENTA,DIZOLVARE,LICHIDARE,FALIMENTorRADIERE. All statuses and remarks from the trade register are instari_registru.
A company we do not have yet is looked up at ANAF right away: the answer comes in the same request or, if the source is slow, as 202 with a Retry-After header.
Financial statements
They are the ones published by the Ministry of Finance, with the indicators in whole lei. An indicator the ministry leaves empty is null, not zero. Reporting types with indicators beyond the common ones (banks, insurers, non-profit organisations) have them in alti_indicatori, under the names the ministry gives them. Before taking a file we check that the figures add up: total income less total expenses must equal gross profit less gross loss. Statements filed after the ministry put its dataset together are missing from it: these we take from ANAF's public web service, from 2019 on, and check in the same way, except that there an indicator not reported shows as zero, not empty.
Fiscal obligations
From the list of taxpayers the Ministry of Finance publishes once a year we take, for each CUI, the fiscal obligations it was registered for (the "vector fiscal": profit tax or micro-enterprise income tax, excise duties, the tax on salaries, the contributions and the rest) and the days of its last declaration and of the last processing. We give them in obligatii_fiscale as they were on the list's day, la_data, not as they are today: a company that has changed its tax regime since appears with the old one until the next list. regim_impozitare says in one word how the income was taxed: profit, micro or specific. The list says only whether an obligation was registered, not since when.
ultima_declaratie is the day the taxpayer's last declaration was registered, as the list gives it; it is neither the date of fiscal registration nor that of the last tax return. Where we do not know them, obligatii_fiscale is null: for a company that is not in the list, or that we took in after the list was imported, until the next list.
What we do not serve
We serve no personal identification numbers (CNP), and we do not take the data about companies' legal representatives from the trade register. Natural persons who carry on an economic activity — sole traders (PFA), individual and family enterprises, liberal professions — are served like companies, with what the registers publish about them. The field persoana_fizica in the response says which kind of entry it is: false for a legal person, true for a natural person, null while the sources do not let us tell.
What we do not have yet
We would rather say that we do not have a piece of information than serve it from an unreliable source. At present we do not have:
- Debts to the state budget. ANAF publishes the list of companies with overdue obligations only through a protected search page, not as a dataset; the dataset on data.gov.ro is from 2016. The list covers only debts above a threshold anyway, so not being on it does not mean having no debts.
- Work points (places of business). The trade register does not publish them in its open data. ANAF gives some secondary seats a tax code of their own, but without the link to the company they belong to; we mark them as secondary seats and attribute them to no one.
- Directors, partners and shareholders. This is data about persons; we leave it aside until it has been reviewed legally.
- Court cases, insolvency (BPI), the Official Gazette, licences and authorisations (ANRE, ARR), imports and exports. Each has a different source, of different reliability; we will add them one at a time, only where the source is official and stable.
In a response, a null field means "we do not know", not "there is none": caen_autorizate, for example, is null for a company that does not appear in the trade register's dataset.
An error in the data
If you see something wrong, write to us at dev@apifirme.dev and give us the CUI. An error we made when taking the data over we correct here; one that is in the register is corrected at the register that publishes it (ONRC or ANAF), and we take the corrected information over at the next update.
Attribution
The trade register's data is published by the National Trade Register Office (Oficiul Național al Registrului Comerțului) under the Creative Commons Attribution 4.0 licence. We have processed it: we merged the entries of the same company, brought the diacritics to their correct form and translated the status codes.
The list of taxpayers ("Date de identificare plătitori") is published by the Ministry of Finance under the same licence, Creative Commons Attribution 4.0. We take from it only the fiscal obligations and the days of the last declaration; the codes' names we have written out in full, after the ministry's nomenclature.