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) Enterprises Basic GET/base/{piva_cf_or_id}

The Enterprises 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 at the Italian Business Register (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 and timestamp of the data update
• ID (internal company identifier)
• GPS coordinates (longitude and latitude)
• Chamber of Commerce registration date

The Enterprises 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",
    "timestamp_codice_destinatario": 1622452306,
    "id": "60b4a85585e34e615c569ef5"
    "gps": {
     "coordinates": [
       12.47843,
       41.8071
     ]
    }
   },
  "success": true,
  "message": "",
  "error": null
  }

Enterprises 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) Enterprises 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 Enterprises Basic plus additional information such as REA code, Chamber of Commerce, Ateco Code and Description, Turnover, Profit and Employees.

Enterprises 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
• Company status with the Italian Internal Revenue Service and timestamp of the data update

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

The response is real-time.

SAMPLE REQUEST GET Imprese Advance

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

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

SAMPLE 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,
        "timestamp_cessata": 1622452306,
  "soci": [
    {
      "denominazione": "OPEN HOLDING S.R.L.",
      "nome":null,
      "cognome"null,
      "valore": "100"
    }
  ]
},  
    "cap": "00143",
    "codice_destinatario": "MJ1OYNU",
    "timestamp_codice_destinatario": 1622452306,
    "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) Enterprises Updates GET /updates

The Updates service allows you to obtain a list of all company ids for which changes have occurred.

The parameters for performing the search are:

• latitude and longitude
• radius

SAMPLE 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

SAMPLE 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) Enterprises Updates GET /updates{timestamp}

The GET endpoint /updates/{timestamp} allows you to limit the search to a well-defined date.

SAMPLE 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

SAMPLE 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.

All endpoints of the Enterprises API

The Enterprises API provides access, depending on the endpoint used, from single company information, such as PEC and recipient code, to more comprehensive datasets such as those in the 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
• Autocomplete (Enterprises) To get a list of company names from a query (one or more words)
• 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

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.