The Autocomplete service is a service that from a specific textual search string, query, provides a series of relevant company results in real time.

Autocomplete allows you to search a database of more than 15 million Italian companies in real time and geolocalise it within a defined radius.

The search parameters are:

• query (the term to be searched for)
• search term mode: start (start), contain (contain), end (end with)
• geographical coordinates latitude and longitude
• radius

The special character '*' can be used as a wildcard to search for strings that start, contain or end with the specified query.

EXAMPLE REQUEST GET /autocomplete

https://imprese.openapi.it/autocomplete/openapi%2A?lat=13.5478&lng=42.859&radius=10000

This is an example of a query with the following parameters:

• starts with openapi query
• latitude 13.5478
• longitude 42.859
• radius 10000 metres

EXAMPLE RESPONSE  GET /autocomplete

The response with respect to the previous query presents 3 results with the company name starting with openapi and occurring within 10,000 metres of the point identified by latitude 13.5478 and longitude 42.859.

{
  "data": [
    {
      "id": "60bf66ea35a4c0041e84826c",
      "denominazione": "OPENAPI SRL"
    },
    {
      "id": "56bf66ea35a4c0021e84826f",
      "denominazione": "OPENAPI PLATFORM SPA"

    },
    {
      "id": "47bf66ea35a4c0051e84826f",
      "denominazione": "OPENAPI HOLDING" 
    }
  ],
  "success": true,
  "message": "",
  "error": null
}

The result will return the company ID in addition to the company name. This identifier can be used as a parameter for other endpoints of the Enterprises service such as Basic and Advance to obtain detailed company information such as VAT number, PEC, Turnover, Ateco, Shareholders, etc.

The Autocomplete service has been chosen by hundreds of companies to optimise their search form. In fact, Autocomplete's integration allows suggestions to be offered while the customer is typing, even before pressing the search button. The customer can choose any of the autocomplete suggestions from the drop-down list and be directed to the results page without having to manually enter each character in the field.

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 (List) to have a list of enterprises based on a number of parameters such as ateco code, turnover, CCIAA, employees
• Enterprises Advance VAT Number to get detailed information on companies such as turnover, profits, employee pec, registered capital, status with Internal Revenue Service, shareholders
• 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