Autocomplete is a feature of the Search Company service that, given a specific textual search string (query), provides a series of relevant results of companies in real-time.

Autocomplete allows you to search a database of over 15 million Italian companies in real-time and geolocate them within a defined radius.

The search parameters are:

• query (the term to search for)
• search mode for the term: starts with (start), contains (contain), ends with (end with)
• geographical coordinates latitude and longitude
• radius
• Catastal Code
• CCCIA
• ATECO Code
• Chamber of Commerce
• REA
• Turnover (min. / max.)
• Employees (min. / max.)
• SDI Code
• Legal Form Code
• PEC (Certified Email)
• Tax Code of the partner

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 /IT-search

https://company.openapi.com/IT-search/openapi%2A?lat=13.5478&long=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 /IT-search

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

{
  "data": [
    {
      "id": "60bf66ea35a4c0041e84826c"
    },
    {
      "id": "56bf66ea35a4c0021e84826f"

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

This id can be used as a parameter for other endpoints of the Company service such as Start and Advanced to obtain detailed company information such as VAT number, PEC, Turnover, Ateco, Shareholders, etc.

During the request phase, you can also use the "dataEnrichment" parameter, which allows you to define the desired data in the response:

• No parameter: A list of company IDs will be returned, which can be used to request information through other Company endpoints.
• Name: The response will include company ID, VAT number, tax code, company name, and the city of the registered office.
• Address: The response will include company ID, VAT number, tax code, company name, and the address of the registered office with coordinates and cadastral code.
• PEC: The response will include company ID, VAT number, tax code, company name, and a list of companies with current and historical PEC (Certified Email) registered at the Chamber of Commerce.
• Start: For each company corresponding to the parameters, the response will include all the information of the start service, such as name, tax code, VAT number, address, office, activity status, and SdI code.
• Advanced: This will behave in the same way as the start but will offer additional information such as PEC, SdI code, REA, legal form, ATECO code, revenue, profits, employees, and shareholders.
• Shareholders: The response will include company ID, VAT number, tax code, company name, and information about shareholders such as first and last name or company name, tax code, and share percentage.