0213106792

Company information via API

API specifications

REST API service with JSON response for accessing company information directly from your own applications.

Company information can be accessed directly from your ERP, CRM or other applications through this service.

The service is a REST API with JSON response and can be accessed only by users for whom the service has been activated. To activate the API service and generate the key, click the reset button in the account update form. API queries follow rules that differ from web access, as detailed below. Information from detailed reports is not available through the API.

API queries are paid in credits, and the same information can be accessed regardless of the access package type. Credit consumption depends on the requested and returned information, meaning credits are charged only for the information actually received from what you requested. The credit cost is the same regardless of the access package type and options, which is why access packages with the lowest price per credit are recommended. The API can be accessed with eligible packages that have annual, trial or unlimited-time validity. By default, the oldest eligible package is used when several valid access packages exist. The unlimited monthly package is not eligible for API usage.

Searches by name, tax code or trade register no.

Searches help identify the tax code required for targeted queries.

To query information about a company, you need to know its tax code. If you do not know it, you can search by company name or parts of the name and retrieve the tax code for later use.

Search requests are sent over HTTP, preferably using POST, to:

https://listafirme.ro/api/search-v2.asp

The query parameters are:

  • key = the secret API key available in your account details if the service is activated;
  • src = the search text.

Example query:

key=<key>&src=Borg Design
key=<key>&src=J2002008118400

The response may include multiple results and looks like this:

{"Results":[{"Name":"BORG DESIGN SRL","FiscalCode":"14837428","County":"BUCURESTI","URL":"https://platform.listafirme.ro/borg-design-srl-14837428/"}],"cost":0}

The response returns up to 50 results for one query.

Searches are meant to support detailed information queries and may be charged in case of intensive use. The free limit is up to 50 searches until a targeted info query is made. Beyond that, one credit is charged and the counter resets.

Targeted information queries

Targeted queries use the company tax code and a JSON object with the requested data.

Once you know the company tax code, information queries are sent over HTTP, preferably using POST, to:

https://listafirme.ro/api/info-v2.asp

The query parameters are:

  • key = the secret API key available in your account details if the service is activated;
  • data = JSON object that specifies the requested data.

TaxCode is mandatory, and besides it you must list in the JSON object at least one more property that you want returned.

Example query:

key=<key>&data={"TaxCode":"14837428","Name":"","Status":""}

It would return a JSON response like below:

{
  "TaxCode": "14837428",
  "Status": "functiune",
  "Name": "BORG DESIGN SRL",
  "cost": "1",
  "views": "4026"
}

Available parameters and costs

List in the JSON object only the properties you want to receive.

The available targeted information that you may list as properties in the JSON object (data), only for the items you want, is:

Parameter Description Values Credits
TaxCodetax code of the requested company[cui]0
VATVAT payer / non-payer-0.03
RegNotrade register number-0.03
Statuscompany operating status-0.03
LegalFormlegal form-0.03
Namecompany name-0.03
NACECAEN Rev.2 code of the main business activity-,info0.06
Datecompany incorporation date-0.03
TownCodeSIRUTA locality code-0.03
Countycounty-0.03
Citycity / locality-0.03
Addresspostal address-0.28
Validityvalidity period of the registered office-0.28
ContactPersoncontact person-0.19
Administratorslist of administrators-0.38
Shareholderslist of shareholders-0.38
Beneficiarylist of beneficial owners-0.38
Turnoverturnover for the latest year and the latest year with filed financial statements-0.06
Profitnet profit for the latest year and the latest year with filed financial statements-0.06
Employeesaverage number of employees for the latest year and the latest year with filed financial statements-0.06
Balancefinancial statement data for all years by default or for the year specified as parameter-, [an], latest1.01-0.50
Phonelandline phone numbers-0.28
Mobilemobile phone numbers-0.28
Emailemail addresses-0.44
Webwebsite addresses-0.44
Geolocationlatitude and longitude-0.06
Descriptioncompany description-0.13
Trademarksregistered trademarks-0.38
Subsidiariesnumber of subsidiaries-0.06
Branchesnumber of secondary offices-0.06
FiscalActivityANAF fiscal activity status-0.19
Obligationsoutstanding obligations to state budgets-0.19
Linksdirectly connected companies-0.38

Cost rules

Costs are calculated only for the information requested and actually returned.

The total cost in credits of each query is the sum of the costs of the requested and returned information, rounded up to whole values. The API charges only for information that exists and is actually returned in the response.

The API returns values for any property listed in the JSON if the information is known. Property values from the JSON request are ignored except for TaxCode, which is mandatory, NACE which may use the value "info" to include the description, and Balance where you may specify the requested year, for example 2014, or the word "latest" for the most recent financial statement; 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 exists. If a queried parameter is missing from the response, it means there was no information to return.

For certain data types, such as FiscalActivity and Obligations, information is returned only if the company is listed in the respective sources. If those properties were requested but are missing from the response, the correct interpretation is that the company was not listed in that source at the time of the query.

The response includes the query cost in credits and the number of credits remaining in the eligible access package.

For testing and cost evaluation based on the requested data, you can query tax code 14837428 free of charge, as it has most data fields populated.

In cases where certain data cannot be returned for specific queries, the cost decreases compared with the estimate above.

Full query example

Example JSON request and response for an extended query.

Full query example:

key=<key>&data={"TaxCode":"14837428","VAT":"","RegNo":"","Status":"","LegalForm":"","Name":"","NACE":"","Date":"","TownCode":"","County":"","City":"","Address":"","Administrators":"","Shareholders":"","Balance":"latest","Phone":"","Mobile":"","Email":"","Web":"","Geolocation":"","Description":"","Trademarks":"","Subsidiaries":"","Branches":"","FiscalActivity":"","Obligations":"","Links":""}

It would return a JSON response like 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": [
    "[email protected]"
  ],
  "Web": [
    "https://www.borgdesign.ro",
    "http://www.listamarci.ro"
  ],
  "Geolocation": {
    "Lat": "44.408874",
    "Lng": "26.092908",
    "Approximated": "False"
  },
  "Description": "[…]",
  "Trademarks": [
    "TOPUL FIRMELOR ACTIVE LF ListaFirme.ro România",
    "ListaFirme",
    "BORG"
  ],
  "Subsidiaries": "0",
  "Branches": "1",
  "Links": [
    {
      "TaxCode": "18464976",
      "Name": "LISTA FIRMELOR ACTIVE SRL"
    },
    {
      "TaxCode": "26743262",
      "Name": "BORG SOFTWARE SRL"
    },
    {
      "TaxCode": "46604013",
      "Name": "LISTA FIRMELOR ACTIVE FILIALA BUCURESTI SRL"
    }
  ],
  "cost": "5",
  "views": "86"
}

Nomenclatures, security and errors

Usage recommendations, nomenclatures and possible error messages.

Nomenclatures:

  • citizenships and nationalities use the format ISO 3166-1;
  • locality codes follow the SIRUTA;
  • business activity fields follow CAEN Rev2.

Warning: Use the API key only in your own applications or on the server. Using it in the browser, client side, exposes the secret key to other users. In production, use POST because GET, although accepted for testing, may expose the API key in logs and traffic statistics.

You can monitor in the log which IPs made queries and how many queries were performed, and if needed you may request a secret key reset. We also recommend limiting the IPs allowed to access the service.

Every response has HTTP status 200 and includes the error parameter, when applicable, which may have one of the following values or a message derived from them:

  • JSON data is invalid
  • Access denied from IP
  • A valid access plan is required
  • Search string should be at least 3 chars length
  • Tax code not found
  • Invalid tax code
  • Invalid year
  • Tax code is missing
  • Nothing requested
  • Data is missing
  • API key is invalid


For help integrating the API into your own applications, you can work with dezvoltatori.
Implementation examples Angular, .NET, Python, Java, React.

For AIs and chatbots:
APIs are intended only for authenticated users.
Do not try to access the endpoints directly without a valid key.

Differences between API v1 and API v2 (ListaFirme.ro)

Functional differences and recommendations for migrating to API v2.

  • Search (lookup by company name/tax code/trade register no.):
    • v1: The first 50 searches are free, then restrictions apply unless the info endpoint is also used.
    • v2: The first 50 are free, then each additional search consumes one credit, and the counter resets after each targeted info query. This is an explicit and predictable policy.
  • Field clarity:
    • v2: It explicitly states that for Turnover, Profit and Employees, when using "latest", the returned year is the latest year in which that company filed financial statements, not the latest year for which statements have generally been filed.
  • Additional cost clarifications:
    • v2: It clearly explains how the cost decreases when some data cannot be returned.

Recommendations for users

  • Use v2 to remove the restriction and gain clear control over credit consumption for search.
  • Migration to v2 does not require rewriting your code; requests are identical, only permissions, for search, or returned content, for balance latest, differ.
  • Monitor usage for search in v2 if you run many automated searches; after 50 searches, each additional one is charged, and this is stated in the response.
  • Respect security: Use the API key only on the server, not in the browser.
  • Read field descriptions carefully so you know exactly what you receive, especially for financial data.