Italian Municipalities Data Update

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

Keep updated all data of Municipalities, Provinces, Regions thanks to our API service.

The Italian Municipalities Data Update service allows you to check and update data such as postcodes, Istat codes and their associated municipalities.

Esempio Italian Municipalities Data Update

Our APIs allow to verify in a second administrative and postal data of cities, provinces and regions, ensuring correct information for deliveries and checkout optimizations thanks to autocomplete.

Open API provides several types of Municipalities data verification and update services via API:

1) Search Municipalities (GET /cerca_comuni)

The Search Municipalities method is free and allows you to obtain the ISTAT code of any Italian city from a series of parameters such as city, postcode, land registry code, region, province, tax code. The ISTAT code obtained can then be used to obtain further information on municipalities via other endpoints, such as Search for Basic or Advance Municipalities.

The response may include one or more cities based on the parameters used with respective ISTAT codes:

{
  "data": [
    {
      "istat": "70006",
      "comune": "Campobasso"
    },
    {
      "istat": "70078",
      "comune": "Termoli"
    },
    {
      "istat": "94023",
      "comune": "Isernia"
    },
    {
      "istat": "94052",
      "comune": "Venafro"
    }
  ],
  "success": true,
  "message": "",
  "error": null
}

 

2) Search Municipalities Basic (GET /comuni_base/{istat_code})

The Search Municipalities Base method makes it possible, starting from the ISTAT code (obtainable via GET /cerca_comuni), to obtain the basic information of a city such as region, province, postcode.

{
    "data": {
      "istat: "70006",
      "comune": "Campobasso",
      "regione": "Molise",
      "provincia: "Campobasso",
      "cap: [
      "86100",
      ]
    },
    "success": true,
    "message": "",
    "error": null
  }
  

 

Many ecommerce or platforms have integrated these APIs because with a simple call, it is possible to simplify the processes of filling in shipping and invoicing forms with data that is always up-to-date and valid. For example, once the user enters the postcode in the form, it will be possible to automatically fill in the province and city data without manual errors or typos.

 

3) Search Municipalities Advance (GET /comuni_advance/{istat_code})

The Search Municipalities Advance method allows - again based on the ISTAT code (obtainable via GET /cerca_comuni) - to obtain more detailed information than a city. In fact, in addition to the data included in the response of the Basic Municipality Search, it is possible to obtain information such as area code, tax code, surface area, number of residents, address of town hall, PEC, telephone number, districts, etc.

{
    "data": {
      "istat": "58091",
      "comune": "Roma",
      "regione": "Lazio",
      "provincia": "Roma",
      "prefisso": "06",
      "cod_fisco": "H501",
      "superficie": 1308,
      "num_residenti": 2770226,
      "nome_abitanti": "Romani",
      "patrono": {
        "nome": "SS. Pietro e Paolo",
        "data": "29 giugno"
      },
      "municipio": {
        "municipio": "Via del Campidoglio"
      },
      "istat_old": null,
      "sigla_provincia": "RM",
      "email": "ld.gabinetto@comune.roma.it",
      "pec": "protocollo.segretariato@pec.comune.roma.it",
      "tel": "+39 06/67102001",
      "fax": "+39 06/67103590",
      "frazioni": [
      "Borgo Lotti",
        ".."
      ],
      "cap": [
      "00118",
        "..."
      ]
    },
    "success": true,
    "message": "",
    "error": null
  }

 

4) Search CAP (GET /cap/{cap})

IThis method makes it possible, from the postcode, to obtain the following corresponding data: ISTAT code, municipality, hamlet (if any), province, province abbreviation, region. If several municipalities are associated with the same postcode, all the corresponding data will be returned.

{
  "data": {
   "comuni": [
    {
      "istat": "1016",
      "comune": "Balangero"
      "frazione": null,
      "comune_istat": "1016"
    },
    {
      "istat": "1019",
      "comune": "Balme"
      "frazione": null,
      "comune_istat": "1019"
    },
    {
      "istat": "1021",
      "comune": "Barbania"
      "frazione": null,
      "comune_istat": "1021"
    },
    {
      "istat": "	047012",
      "comune": "Pescia"
      "frazione": Castelvecchio,
      "comune_istat": "47012"
    }
    ],
    "provincia": ""Torino",
    "sigla_provincia": ""TO",
    "regione": ""Piemonte"
  },
  "success": true,
  "message": "",
  "error": null
} 

 

5) Search suppressed Municipalities (GET /comuni_soppressi)

Starting from the abbreviation of the province (e.g. RM), the method allows you to obtain the list of suppressed municipalities in that province and information such as ISTAT code, tax code, region, province name in an extended manner.

{
  "data": [
    {
      "istat": "24011",
      "comune": "Barbarano Vicentino"
      "cod_fisco": "A627",
      "sigla_provincia": "VI"
      "regione": "Veneto",
      "provincia": "Vicenza"
    },
    {
      "...":"..."
    }
    ],
     "success": true,
    "message": "",
    "error": null
} 

 

6) Search Metropolitan Cities (GET /comuni_metropolitane)

With the Search Metropolitan Cities method it is possible to obtain a list of all metropolitan cities with information such as population, area, density, number of municipalities.

{
  "data": [
    {
      "denominazione": "MESSINA",
      "capoluogo": "Messina"
      "popolazione": 631297,
      "superficie": 3266,
      "densita": 193,
      "num_comuni": 108
    },
    {
      "...":"..."
    }
    ],
     "success": true,
    "message": "",
    "error": null
} 

 

7) Search Regions (GET /region)

With the Search Regions method it is possible to obtain a list of all regions with information such as capital city number, residents, number of municipalities, president, tax code, PEC, site, location.

{
  "data": [
    {
      "regione": "Abruzzo",
      "capoluogo": "L'Aquila"
      "superficie": 10831.84
      "num_residenti": 1305770,
      "num_comuni": 305,
      "presidente": "Marco Marsilio",
      "cod_fiscale": "80003170661",
      "piva": "",
      "pec": "urp@pec.regione.abruzzo.it",
      "sito": "www.regione.abruzzo.it",
      "sede": "Regione Abruzzo / Palazzo Silone - Via Leonardo da Vinci 6, 67100 L'Aquila",
      "istat": "13",
      "num_province": 4      
    },
    {
      "...":"..."
    }
    ],
     "success": true,
    "message": "",
    "error": null
} 

 

8) Search Provinces (GET /province)

With this method it is possible to obtain a list of all provinces with information such as acronym, surface area, residents, number of municipalities and istat codes.

{
  "data": [
    {
      "sigla": "AG",
      "capoluogo": "Agrigento"
      "superficie": 10831.84
      "residenti": 1305770,
      "num_comuni": 305,
      "istat": "084",
      
    },
    {
      "...":"..."
    }
    ],
     "success": true,
    "message": "",
    "error": null
} 

 

9) Search Provinces (GET /province/{code}

This method makes it possible to obtain information such as the acronym, surface area, residents, number of municipalities and istat codes of a given province.

{
  "data": [
    {
      "sigla": "AG",
      "capoluogo": "Agrigento"
      "superficie": 10831.84
      "residenti": 1305770,
      "num_comuni": 305,
      "istat": "084",
      
    },
    {
      "...":"..."
    }
    ],
     "success": true,
    "message": "",
    "error": null
} 

 
PLEASE NOTE: Provinces, regions, suppressed municipalities and metropolitan areas provide 10,000 calls/month free of charge. Above that limit, the cost of a single call is 0.01€.

Our prices

Price list for single API calls

  • Search Municipalities (Base) € 0,04 + vat
  • Search Municipalities (Advance) € 0,05 + vat
  • Search Postcode € 0,04 + vat

Subscribe and save

  • GET CAP
  • 2.000 API calls/years (pay annually) € 0,03 + vat
  • 10.000 API calls/years (pay annually) € 0,025 + vat
  • 50.000 API calls/years (pay annually) € 0,02 + vat
  • 200.000 API calls/years (pay annually) € 0,01 + vat
  • 500.000 API calls/years (pay annually) € 0,006 + vat
  • GET COMUNI BASE
  • 2.000 API calls/years (pay annually) € 0,03 + vat
  • 10.000 API calls/years (pay annually) € 0,025 + vat
  • 50.000 API calls/years (pay annually) € 0,02 + vat
  • 200.000 API calls/years (pay annually) € 0,01 + vat
  • 500.000 API calls/years (pay annually) € 0,006 + vat
  • GET COMUNI ADVANCE
  • 2.000 API calls/years (pay annually) € 0,0330 + vat
  • 10.000 API calls/years (pay annually) € 0,0275 + vat
  • 50.000 API calls/years (pay annually) € 0,022 + vat
  • 200.000 API calls/years (pay annually) € 0,011 + vat
  • 500.000 API calls/years (pay annually) € 0,0066 + vat