The service provides with a single call and in real time all the master data of a company, activity information, components and economic data.

All data are available from one of the following parameters:

• VAT number 
• Tax Code
• ID (internal company identifier)

1) Search Company Basic GET/base/{piva_cf_or_id}

The Search Company Basic service allows you to obtain all the master data of a company and check its activity status.

Through this you get the following data from the VAT number or company ID: 

• Tax Code
• Full company name
• VAT No
• Registered office (name, street, house number, address, city, county, province, postcode)
• Activity Status (Active, Registered, Inactive, Suspended, Enrolled, Ceased)
• Timestamp (internal use) 
• Timestamp creation (date of company creation in database)
• Timestamp last update (date of last company change)
• Recipient code for electronic invoicing
• ID (internal company identifier)
• GPS coordinates (longitude and latitude)
• Chamber of Commerce registration date

The Search Company service is identified by the endpoint: GET https://imprese.openapi.it /base/{piva_cf_or_id}

Data on new companies and the response are provided in real time.

EXAMPLE REQUEST GET Imprese Base

This is an example of a request for VAT number 12485671007:

https://imprese.openapi.it/base/12485671007

EXAMPLE RESPONSE GET Imprese Base

This is an example of a response using the VAT number 12485671007:

{
  "data": {
    "cf": "12485671007",
    "denominazione": "ALTRAVIA SERVIZI SOCIETA' A RESPONSABILITA' LIMITATA",
    "piva": "12485671007",
    "toponimo": "VIALE",
    "via": "F TOMMASO MARINETTI",
    "civico": "221",
    "indirizzo": "VIALE F TOMMASO MARINETTI 221",
    "comune": "ROMA",
    "frazione":  null,
    "provincia": "RM",
    "stato_attivita": "ATTIVA",
    "timestamp": 1622452306,
    "timestamp_creation": 1622452306,
    "timestamp_last_update": 1622452306,
    "cap": "00143",
    "codice_destinatario": "MJ1OYNU",
    "id": "60b4a85585e34e615c569ef5"
    "gps": {
     "coordinates": [
       12.47843,
       41.8071
     ]
    }
   },
  "success": true,
  "message": "",
  "error": null
  }

Search Company is the solution implemented by dozens of ecommerce companies to optimise form filling/checkout times for business customers and eliminate any billing errors. After the business user has entered the VAT number, the remaining billing fields are automatically filled in the checkout form.

2) Search Company Advance VAT Number GET/advance/{piva_cf_or_id}

This is the most comprehensive dataset of company information and allows you, starting again from the VAT number/Tax code or company ID parameter, to obtain all the information about a company that you can already find in "Search Company Basic" plus additional information such as REA code, Chamber of Commerce, Ateco Code and Description, Turnover, Profit and Employees.

Search Company Advance VAT Number, in addition to the information in the Basic, includes:

• PEC Address and Digital Domicile
• REA code
• Chamber of Commerce (CCIAA) of Registration
• Legal Nature Code
• ATECO (Economic Activity) Code and Description
• Share Capital
• Closing Date Balance Sheet Last 3 years
• Turnover Last 3 years
• Profit Last 3 years
• Employees 
• Shareholders (Name and Surname / Name and share of shareholders holding 10% or more)*
• Membership in a VAT group

The Search Company Advance VAT Number is identified by the endpoint: GET https://imprese.openapi.it/advance/{piva_cf_or_id}

The response is real-time.

EXAMPLE REQUEST GET Imprese Advance

This is an example of a request for VAT number 12485671007:

https://imprese.openapi.it/advance/12485671007

EXAMPLE RESPONSE GET Imprese Advance

This is an example of the response using the VAT number 12485671007 as a parameter:

{
  "data": {
    "cf": "12485671007",
    "denominazione": "ALTRAVIA SERVIZI SOCIETA' A RESPONSABILITA' LIMITATA",
    "piva": "12485671007",
    "toponimo": "VIALE",
    "via": "F TOMMASO MARINETTI",
    "civico": "221",
    "indirizzo": "VIALE F TOMMASO MARINETTI 221",
    "comune": "ROMA",
    "frazione":  null,
    "provincia": "RM",
    "stato_attivita": ""ATTIVA",
    "timestamp": 1622452306,
    "timestamp_creation": 1622452306,
    "timestamp_last_update": 1622452306,
    "dettaglio": {
      "rea": "1378273",
      "cciaa": "RM",
      "pec": "[email protected]",
      "codice_natura_giuridica": "SR",
      "descrizione_ateco": "Produzione di software non connesso all'edizione",
      "codice_ateco": "6201",
      "data_inizio_attivita": "2013-10-20",
      - "bilanci": {
       + "2017": {...},
       + "2018": {...},
       - "2019":  {
	   "data_chiusura_bilancio":"2019-12-31",
	   "fatturato": 1799587,
	   "utile": 11309,
	   "dipendenti":14,
	   "capitale_sociale": 10000
	 }
	 },
	- "gruppo_iva": {
	   "partecipazione": false,
	   "piva_capogruppo": false,
	      "anagrafica_ok": true
	  },
	"cessata":  false,
  "soci": [
    {
      "denominazione": "OPEN HOLDING S.R.L.",
      "nome":null,
      "cognome"null,
      "valore": "100"
    }
  ]
},  
    "cap": "00143",
    "codice_destinatario": "MJ1OYNU",
    "id": "60b4a85585e34e615c569ef5",
    "gps": {
     "coordinates": [
        12.47843,
       41.8071
     ]
    }
  },
  "success":  true,
  "message": "",
  "error":  <null
 }

Many business intelligence companies use this to get details about a company.

With the company search service it is also possible to check which companies have changed over a defined period of time.

There are 2 endpoints available:

1) Search Company Updates GET /updates

The "Updates" service allows you to obtain a list of all company ids for which changes have occurred in the last 6 months.

The parameters for performing the search are:

• latitude and longitude
• radius

EXAMPLE REQUEST GET Imprese Updates

This is an example of a call with the parameters latitude 13.5478, longitude 42.859, radius 1000 (metres) and a result limit of 3:

https://imprese.openapi.it/updates?lat=13.5478&lng=42.859&radius=1000&skip=0&limit=3&dry_run=0

EXAMPLE RESPONSE GET Imprese Updates

The result will be a list of company IDs for which calls can be made with the basic/advance endpoints to obtain all updated data. 

This is an example of a response in which 3 company IDs are given:

{
  "data": [
    {
      "id": "61f2c4d69fb8571d19235463"
    },
    {
      "id": "61f4r5y69fb8571d19237859"
    },
    {
      "id": "61f2f6t09fb8571d19237773"
    }
    ],
  "success": true,
  "message": "",
  "error": null
}

2) Search Company Updates GET /updates{timestamp}

The GET endpoint /updates/{timestamp} allows you to limit the search to a well-defined date and not generically the last 6 months.

EXAMPLE REQUEST GET Imprese Updates{timestamp}

This is an example of a call with the parameters latitude 13.5478, longitude 42.859, radius 1000 (metres) and a result limit of 3 but with the timestamp 1682936900 (converted to date is 1/5/2023 12:28:20). Basically I am making the same call as before but with the "timestamp" parameter I indicate that I only want to obtain companies updated after 1/5/2023 12:28:20:

https://imprese.openapi.it/updates/1682936900?lat=13.5478&lng=42.859&radius=100&skip=0&limit=3&dry_run=0

EXAMPLE RESPONSE GET Imprese Updates{timestamp}

This is an example of a response in which 2 company IDs are given:

{
  "data": [
    {
      "id": "61f2c4d69fb8571d19235463"
    },
    {
      "id": "61f2f6t09fb8571d19237773"
    }
    ],
  "success": true,
  "message": "",
  "error": null
}

For both Updates calls, the parameters 'limit' / 'skip' were inserted.

With the parameter 'limit', it is possible to indicate the maximum number of desired results. With 'skip', on the other hand, it is possible to set the number of results to be skipped. This second parameter was implemented to 'skip' any results from previous searches.

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 (Company List) to obtain a list of enterprises based on a number of parameters such as ATECO code, turnover, CCIAA, employees
• Search Company Autocomplete to have a list of company names from a query
• 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 VAT Group to find out if the company belongs to a VAT Group

The 10 free searches are available for GET:/imprese.openapi.it/base

*The list of shareholders is available for companies that have filed their balance sheet in the last four years and includes private individuals and legal entities with a share of more than 10%. To have all stakeholders up-to-date use "Stakeholders" of the Company service.