Romanian
EnglishEnterprise information through API
Business information can be accessed directly from your ERP, CRM or other applications through this service.
The service is REST API with JSON response and can only be accessed by users for whom the service has been activated. For API activation and key generation click the reset button in the account settings. API querying is done under different rules than web access. The information in the detailed reports is not accessible through the API.
Payment of API queries is done in views, the same information can be accessed regardless of the type of access plan. The consumption of views depends on the information requested and returned, respectively views are consumed only for the information actually received from what you requested. The cost in views is the same regardless of the type and options of the access package, which is why access plans with a minimum price per view are recommended. The access plans with which the API can be accessed are the annual ones. By default, the oldest eligible package is used if there are several valid access plans. API cannot be accessed with Unlimited monthly access plans.
Searches by name, fiscal code or registry no.
To query information about a company you need to know its fiscal code. If you don't know its fiscal code, you can search by name or parts of the name and find out the fiscal code for further use.
Searches are sent using the HTTP protocol (preferably POST) to:
https://www.listafirme.ro/api/search-v1.asp
The parameters of a request are:
- key = the secret api key that you find in your account data if the service is activated;
- src = searched text.
Sample querry:
key=yourkey&src=Borg Design
key=yourkey&src=J2002008118400
The answer can include multiple results and is of the form:
{"Results":[{"Name":"BORG DESIGN SRL","FiscalCode":"14837428","County":"BUCURESTI","URL":"https://www.listafirme.ro/borg-design-srl-14837428/"}]}
Free searches are intended to facilitate the queries for detailed information and may be restricted in case of abuse (usage for other purposes). The limit is a maximum of 50 searches up to one spot information query.
Queries for spot information
Knowing the company fiscal code, the requests for info are transmitted using the HTTP protocol (preferably POST) at the address
https://www.listafirme.ro/api/info-v1.asp
The parameters of a request are:
- key = the secret api key that you find in your account data if the service is activated;
- data = JSON object that care specifică datele care se doresc.
Sample querry:
key=yourkey&data={"TaxCode":"14837428","Name":"","Status":""}would return a JSON response as below
{
"TaxCode": "14837428",
"Status": "functiune",
"Name": "BORG DESIGN SRL",
"cost": "1",
"views": "4026",
}
The available point information from which you need to list as properties in the JSON (data) object the only ones you want, are:
| Parameter | Description | Values | Cost views |
|---|---|---|---|
| TaxCode | The fiscal code of the company sought | [cui] | 0 |
| VAT | VAT payer/non-payer | - | 0.03 |
| RegNo | registration number at the Trade Register | - | 0.03 |
| Status | the state of operation of the company | - | 0.03 |
| LegalForm | the form of legal organization | - | 0.00 |
| Name | the company's name | - | 0.03 |
| NACE | NACE Rev 2 code of the predominant field of activity | -,info | 0.06 |
| Date | date of company establishment | - | 0.03 |
| TownCode | SIRUTA code of the locality | - | 0.03 |
| County | county | - | 0.03 |
| City | city / town | - | 0.03 |
| Address | postal adress | - | 0.26 |
| Validity | validity period of the registered office | - | 0.26 |
| ContactPerson | contact person (redundant with administrators) | - | 0.17 |
| Administrators | list of administrators | - | 0.34 |
| Shareholders | list of associates / shareholders | - | 0.34 |
| Beneficiary | list of real beneficiaries | - | 0.34 |
| Turnover | turnover for the last year | - | 0.06 |
| Profit | net profit for the last year | - | 0.06 |
| Employees | the average number of employees in the last year | - | 0.06 |
| Balance | balance sheet information for all default years or for the year specified as a parameter, if specified | -, [an], latest | 0.92-0.46 |
| Phone | landline phone numbers | - | 0.26 |
| Mobile | cell phone numbers | - | 0.26 |
| Fax | fax numbers | - | 0.26 |
| email addresses | - | 0.40 | |
| Web | web page addresses | - | 0.40 |
| Geolocation | latitude and longitude | - | 0.06 |
| Description | description of the company provided by its representatives | - | 0.11 |
| Trademarks | trademarks | - | 0.34 |
| Subsidiaries | number of branches | - | 0.06 |
| Branches | number of secondary offices | - | 0.06 |
| FiscalActivity | ANAF activity status | - | 0.17 |
| Obligations | outstanding obligations to state budgets | - | 0.17 |
| Links | directly connected companies | - | 0.34 |
The total cost in views of each query is the sum of the costs of the requested and returned information rounded up to integer values.
The API returns values for any property listed in the JSON if the information is known. The property values in the JSON request are ignored except TaxCode (which is required) and Balance at which the desired year can be specified (ex: 2014) or the word "latest" for the most recent balance (otherwise all years are returned)
The service does not return values for parameters that were not specified in the query or for which no data is available. The lack in response of a parameter that was queried means that there was no information to return.
The response states the cost in views of the query and the number of views remaining in the annual access plan.
For testing and evaluation of costs based on the requested data you can query for free CUI = 14837428 (which has most of the information completed).
In cases where certain data cannot be returned for certain queries, the cost decreases compared to the above estimate.
Example of a complete query:
key=yourkey&data={"TaxCode":"14837428","VAT":"","RegNo":"","Status":"","LegalForm":"","Name":"","NACE":"","Date":"","TownCode":"","County":"","City":"","Address":"","Administrators":"","Shareholders":"","Balance":"latest","Phone":"","Mobile":"","Fax":"","Email":"","Web":"","Geolocation":"","Description":"","Trademarks":"","Subsidiaries":"","Branches":"","FiscalActivity":"","Obligations":"","Links":""}would return a JSON response as below
{
"TaxCode": "14837428",
"RegNo": "J2002008118400",
"Status": "functiune",
"LegalForm": "SRL",
"Name": "BORG DESIGN SRL",
"NACE": "6201",
"Date": "2002/8/26",
"TownCode": "179187",
"County": "BUCURESTI",
"City": "SECTORUL 5",
"Address": "STR. ING. STEFAN HEPITES, Nr. 16A, Et. P, ",
"VAT": "True",
"Administrators": [
{
"Name": "DIAC IUSTIN",
"Sex": "M",
"Nationality": "642",
"Position": "administrator",
"Active": "-1"
}
],
"Shareholders": [
{
"Name": "DIAC IUSTIN",
"Sex": "M",
"Nationality": "642",
"Position": "asociat",
"Shares": "100"
}
],
"Balance": [
{
"Year": "2022",
"FixedAssets": "247479",
"CurrentAssets": "1689945",
"Turnover": "3708712",
"NetProfit": "351060",
"GrossProfit": "380337",
"Debts": "1522077",
"EquityOwnership": "351447",
"Stocks": "160769",
"Cash": "1396890",
"Receivables": "132286",
"Income": "3943592",
"Outgoings": "3563255",
"Employees": "23",
"NACE": "6201"
}
],
"Phone": [
"0213106791",
"0213106793"
],
"Mobile": [
"0730593252",
"0731013139"
],
"Email": [
"office@borgdesign.ro"
],
"Web": [
"https://www.borgdesign.ro",
"http://www.listamarci.ro"
],
"Geolocation": {
"Lat": "44.408874",
"Lng": "26.092908",
"Approximated": "False"
},
"Description": "Borg Design este o companie cu capital privat ale cărei principale activităţi sunt dezvoltarea şi distribuţia de software precum şi consultanţă in tehnologia informaţiei. În particular, preocupările Borg Design sunt orientate şi către Inteligenţa Artificială.
Software-ul dezvoltat de Borg Design are la bază solicitările, indicaţiile şi sugestiile clienţilor, şi are ca utilitate posibilitatea rapidă şi automatizată de a accesa şi prelucra informaţii publice de interes general. Obiectivul Borg Design este de a colecţiona aceste informaţii şi a vi le pune la dispoziţie intr-o formă prelucrată, alături de unele unelte software care au ca scop economisirea timpului dumneavoastră de informare şi in special a costurilor.
Borg Design şi-a inceput activitatea in septembrie 2003, a realizat pană in prezent mai multe colecţii de date cu informaţii de interes public şi unele unelte software populare:
- CD-ul Lista Firme;
- Asistent Financiar;
- Expert Email Validator;
- TVA Validator;
- Programul Telefoane.
Nomenclatures:
- citizenships and nationalities are in the format ISO 3166-1;
- the locality codes are according to the nomenclature SIRUTA;
- the fields of activity are according to the code NACE Rev2.
Warning: Use the API key only in your own applications or on the server. Use in the browser (client side) exposes the secret key to other users. In production, use the POST method because the GET method, although accepted for testing, can expose the API key in logs and traffic statistics.
You can view / log in from which IPs and how many queries were performed and, if necessary, request the reset of the secret key. We also recommend that you limit the IPs from which the service can be accessed.
Each response returns HTTP 200 status and includes the error parameter (if applicable) with one of the possible values:
- JSON data is invalid
- Access denied from IP
- A valid access plan is required
- Tax code not found
- Invalid tax code
- Tax code is missing
- Nothing requested
- Data is missing
- API key is invalid
The API is also available on the Zappier.com and Make.com platforms (by invitation).
For help integrating the API into your own applications, we recommend our partner Makeitfuture SRL.
Implementation examples Angular, .NET, Python, Java, React.
Ania