Our API makes it possible to verify and obtain administrative, territorial and postal data of cities, provinces and regions in real time, ensuring official, accurate and correct information (e.g. for deliveries and checkout optimisation thanks to autocomplete). The Italian Municipalities Data Update service is already used by hundreds of ecommerce companies with thousands of transactions per day.

The data are official from Poste Italiane and are updated twice a year. All data are available via API and the database can be accessed entirely on request. 

Openapi provides various types of services for checking and updating postal code data and API Territorial data:

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": "[email protected]",
      "pec": "[email protected]",
      "tel": "+39 06/67102001",
      "fax": "+39 06/67103590",
      "frazioni": [
      "Borgo Lotti",
        ".."
      ],
      "cap": [
      "00118",
        "..."
      ]
    },
    "success": true,
    "message": "",
    "error": null
  }

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

This 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": "[email protected]",
      "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€.