Search Company Basic and Advance VAT Number

FREE first 30 calls/month

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

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

Search Company 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 Search Company 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) 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:

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
  • 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