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

The Enterprises Advance service must not be confused with the Enterprises 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 Enterprises 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

Enterprises 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 Number
• 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
          ]
         },
         "dettaglio": {
           "codice_natura_giuridica": "SR", 
         },
         "data_iscrizione": "2013-07-19", 
        },
        {
         "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
         ]
        },
         "dettaglio": {
         "codice_natura_giuridica": "SR", 
    },
    "data_iscrizione": "1979-04-05", 
    }
   ], 
     "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.

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

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

All endpoints of the Enterprises API

The Enterprises API provides access, depending on the endpoint used, from single company information, such as legal address and certified email, to more comprehensive datasets such as those in Enterprises Basic or Advance:

• Enterprises Advance VAT Number to get detailed information on companies such as turnover, profits, employee pec, registered capital, status with Internal Revenue Service, shareholders
• Autocomplete (Enterprises) to get a list of company names from a query (one or more words)
• Enterprises Basic to obtain basic information about Italian companies such as company name, registered office, recipient code, and activity statuses
• Enterprises Closed to check the status of an enterprise with the Internal Revenue Service
• SdI Code to obtain an enterprise's Recipient Code.
• Enterprises Legal Form to obtain the list and code of all legal forms of enterprises
• Enterprises VAT Group to check whether an enterprise belongs to VAT Group
• Enterprises CEM to discover an enterprise's certified email (CEM / PEC)
• List of Shareholders to obtain the list of partners of a firm
• Enterprises Updates to get a list of all company ids for which changes have been recorded