Enterprises Basic and Advance VAT Number

FREE first 30 calls/month

  • Openapi Delivery : Immediate
  • Openapi starting from € 0,015 + vat

All Italian enterprises information such as CEM, Turnover, Employees, Shareholders available via API and in real time.

Enterprises is designed for who wants information on Italian businesses in an immediate and up-to-date manner: business intelligence and B2B marketing companies, or simply all activities that need to verify the data of companies registered with the Chamber of Commerce.

Esempio Enterprises Basic and Advance VAT Number

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:

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.

Our prices

Price list for single API calls

  • Check Company Base € 0,05 + vat
  • Check Company Advance VAT € 0,10 + vat
  • Updates € 0,00 + vat

Subscribe and save

  • GET IMPRESA BASE
  • 1.000 API calls/month (pay monthly) € 0,04 + vat
  • 1.000 API calls/month (pay annually) € 0,03 + vat
  • 5.000 API calls/month (pay annually) € 0,025 + vat
  • 10.000 API calls/month (pay annually) € 0,02 + vat
  • 75.000 API calls/year (pay annually) € 0,025 + vat
  • 150.000 API calls/year (pay annually) € 0,02 + vat
  • 500.000 API calls/year (pay annually) € 0,015 + vat
  • GET IMPRESA ADVANCE P. IVA
  • 1.000 API calls/month (pay monthly) € 0,08 + vat
  • 1.000 API calls/month (pay annually) € 0,06 + vat
  • 5.000 API calls/month (pay monthly) € 0,07 + vat
  • 5.000 API calls/month (pay annually) € 0,05 + vat
  • 10.000 API calls/month (pay monthly) € 0,05 + vat
  • 10.000 API calls/month (pay annually) € 0,04 + vat
  • 30.000 API calls/years (pay annually) € 0,07 + vat
  • 75.000 API calls/years (pay annually) € 0,05 + vat
  • 150.000 API calls/year (pay annually) € 0,04 + vat
  • 500.000 API calls/year (pay annually) € 0,03 + vat