Municipalities Search

Search Municipalities is identified by the endpoint GET https://cap.openapi.it/cerca_comuni

The service is completely free of charge and allows the ISTAT code to be obtained from a series of parameters such as:

One or more parameters may be combined in the same request.

The name (city) field provides a textual search and will present all cities containing that name in the results. For example, if the search parameter for city name is ‘Roma’, the response will return other cities that include ‘roma’ such as Campagnano di Roma or Trevignano Romano. It is possible to refine the search using other parameters such as province, region and postal code.

EXAMPLE REQUEST

GET /cerca_comuni

This is an example of a request where we chose the municipality of Florence as a parameter:

https://cap.openapi.it/cerca_comuni?comune=Firenze

The response may include one or more cities, depending on the parameters used, with the following information:

EXAMPLE RESPONSE

GET /cerca_comuni

This is an example of response:

{
  "data": {
      "istat": "48017",
      "comune": "Firenze",
      "suppressed":false
     }
  ],
   "suppressed": []
  },
  "success": true,
  "message": "",
  "error": null
}

In the event of suppression, the six-character alphanumeric code that identified it at the time of suppression remains assigned to the suppressed municipality and is no longer re-assigned. In the event of a change of name, the code remains unchanged and is assigned to the new name.

The ISTAT code obtained can then be used to obtain further information on municipalities via other endpoints, such as Basic or Advance Municipalities.