Search Company Advance allows you, from a set of parameters, to search for all companies matching those criteria.

The Search Company Advance service must not be confused with the Search Company Advance VAT Number of the same name, which offers more detailed information but only on a single company.

The parameters that can be used for the Search Company Advance are:

• Company name (or part of the terms in it)
• Province
• ATECO code
• Chamber of Commerce
• REA
• Turnover (min. / max.)
• Employees (min. / max.)
• Latitude and Radius

The Search Company Advance is identified by the endpoint: GET https://imprese.openapi.it/advance

EXAMPLE REQUEST GET /Advance

This is an example of a call in which the following parameters were used:

• the province of Rome
• ATECO code 62.01
• turnover minimum 500,000 and maximum 2,000,000
• employees minimum 5 and maximum 20

https://imprese.openapi.it/advance?provincia=RM&codice_ateco=6201&cciaa=RM&fatturato_min=500000&fatturato_max=2000000&dipendenti_min=5&dipendenti_max=20

EXAMPLE RESPONSE GET /Advance

The answer returns a list of companies compatible with the given parameters and the following data:

• Tax code
• Name
• VAT No.
• Registered office (name, street, address, municipality, district, province, postcode)
• Activity Status
• Timestamp (date and time of request)
• Timestamp creation (date company was created in database)
• Timestamp last update (date of last company change)
• Legal nature code
• Timestamp_creation
• Geographical coordinates registered office (longitude and latitude)
• Chamber of Commerce registration date
• Internal company identifier (ID)

 This is an example of an answer:

{
   "data": [
    {
     "cf": "12485671007",
     "denominazione": "ALTRAVIA SERVIZI SOCIETA' A RESPONSABILITA' 		
     LIMITATA",
     "piva": "12485671007",
     "toponimo": "VIALE",
     "via": "F TOMMASO MARINETTI",
     "civico": "221",
     "indirizzo": "F TOMMASO MARINETTI, 221",
     "comune": "ROMA",
     "frazione":  null,
     "provincia": "RM",
     "stato_attivita": "ATTIVA",
     "timestamp": 1622452306,
     "timestamp_creation": 1622452306,
     "timestamp_last_update": 1622452306,
     "cap": "00143",
     "id": "60b4a85585e34e615c569ef5"
     "gps": {
     "coordinates": [
       12.47843,
       41.8071
      ]
     }  
    },
    {
     "cf": "05526560874",
     "denominazione": "ALTRAVIA - SOCIETA' A RESPONSABILITA' LIMITATA SEMPLIFICATA' 		
     LIMITATA",
     "piva": "05526560874",
     "toponimo": "VIA",
     "via": "DELLE SCALE",
     "civico": "10/18",
     "indirizzo": "DELLE SCALE 10/18",
     "comune": "CATANIA",
     "frazione":  null,
     "provincia": "CT",
     "stato_attivita": "ATTIVA",
     "timestamp": 1622452306,
     "timestamp_creation": 1622452306,
     "timestamp_last_update": 1622452306,
     "cap": "95129",
     "codice_destinatario": ".....",
     "id": "60b4a85585e34e615c569ef8"
     "gps": {
      "coordinates": [
       12.47843,
       41.8071
     ]
    }
  },
 ] 
 "success": true,
 "message": "",
 "error":  null
}

The cost is charged according to the number of companies in the answer and it is possible to have a count of the available results via the "dry_run" parameter before making the call.

In order to prevent errors, the service also has a maximum limit of 100 results by default. It is possible to further reduce the number of results with the parameter "limit" where the desired number of results will be indicated.

In the event that more than 100 companies are to be answered, it is possible to obtain all results with several calls and via the "skip" parameter, which indicates the number of results that are to be "skipped".

In practice, if 150 companies are expected as results for a query, the first call will allow the first 100 companies to be obtained, the second call, in which the skip parameter and the value 100 (i.e. to skip the first 100 already obtained with the first call) will allow the remaining 50 to be obtained.

Search Company Advance is used, for example, for sectoral market surveys and analyses or for marketing activities.

With the Search Company Advance service it is possible to obtain both the VAT number and the company ID, which can be useful for then proceeding to the Search Company Advance VAT Number call and obtain further information such as: REA, CCIAA, PEC, Recipient Code, ATECO Code and Description, Balance Sheet, Profit and Employees.

Other Endpoints of the Search Company Service

The Search Company service allows through other endpoints to obtain individual information already present in the Search Company Basic and Advance:

• Search Company Active/Closed to check the status of a company
• Search Company Advance VAT Number to have detailed information on a company
• Search Company Autocomplete to have a list of company names from a query
• Search Company Basic to get specific information about Italian companies
• Search Company CEM to obtain the CEM of a company
• Search Company Legal Form to get the list and code of all companies’ legal forms
• Search Company Shareholders to obtain the list of partners of a company
• Search Company Updates to get a list of all company ids for which changes have been registered
• Search Company VAT Group to find out if the company belongs to a VAT Grou