Comuni Italiani (1.0.0)

URL: https://openapi.it/en/support License: Apache 2.0 Terms of Service

This service provides an updated database of italian CAP, COMUNI, ISTAT CODE, PROVINCE and REGIONI

First time here? Generate a new access token

Elenco Comuni

Returns a list of italian COMUNI looking for a specific CAP, ISTAT code, PROVINCIA or Regione

This service returns a list of COMUNI included in a specific CAP

Authorizations:

bearerAuth

path Parameters

CAP

required

string

Default: "<string>"

Example: 05100

Italian ZipCode aka CAP of the COMUNE needed

Responses

Response Schema: application/json

success	boolean
message	string
error	integer
	Array of objects (ElencoComuni) [ items ]

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://comuni.openapi.it/cap/%7BCAP%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200
400
401
402
404

Content type

application/json

{"data": {"nome_provincia": "Terni",
"sigla_provincia": "TR",
"regione": "Umbria",
"comuni": ["Terni"
],
"dettaglio_comuni": [{"nome": "Terni",
"popolazione": 109193,
"codice_catastale": "L117",
"codice_istat": "055032"
}
]
},
"success": true,
"message": "",
"error": null
}

This service returns a COMUNE with a specific ISTAT code

Authorizations:

bearerAuth

path Parameters

ISTAT

required

string

Default: "<string>"

Example: 055032

Italian ISTAT code of the COMUNE needed

Responses

Response Schema: application/json

success	boolean
message	string
error	integer
	Array of objects (ElencoComuni) [ items ]

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://comuni.openapi.it/istat/%7BISTAT%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200
400
401
402
404

Content type

application/json

{"data": {"nome_provincia": "Terni",
"sigla_provincia": "TR",
"regione": "Umbria",
"comuni": ["Terni"
],
"dettaglio_comuni": [{"nome": "Terni",
"popolazione": 109193,
"codice_catastale": "L117",
"codice_istat": "055032"
}
]
},
"success": true,
"message": "",
"error": null
}

This service returns a COMUNE with a specific CODICE_CATASTALE

Authorizations:

bearerAuth

path Parameters

CODICE_CATASTALE

required

string

Default: "<string>"

Example: L117

Italian Codice Catastale of the COMUNE needed

Responses

Response Schema: application/json

success	boolean
message	string
error	integer
	Array of objects (ElencoComuni) [ items ]

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://comuni.openapi.it/catasto/%7BCODICE_CATASTALE%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200
400
401
402
404

Content type

application/json

{"data": {"nome_provincia": "Terni",
"sigla_provincia": "TR",
"regione": "Umbria",
"comuni": ["Terni"
],
"dettaglio_comuni": [{"nome": "Terni",
"popolazione": 109193,
"codice_catastale": "L117",
"codice_istat": "055032"
}
]
},
"success": true,
"message": "",
"error": null
}

This service returns a COMUNE located in a specific REGIONE

This service returns a list of COMUNI included in a specific REGIONE

Authorizations:

bearerAuth

path Parameters

REGIONE

required

string

Default: "<string>"

Example: umbria

Italian region name

Responses

Response Schema: application/json

success	boolean
message	string
error	integer
	Array of objects (ElencoComuni) [ items ]

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://comuni.openapi.it/regioni/%7BREGIONE%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200
401
402
404

Content type

application/json

{"data": {"nome_provincia": "Terni",
"sigla_provincia": "TR",
"regione": "Umbria",
"comuni": ["Terni"
],
"dettaglio_comuni": [{"nome": "Terni",
"popolazione": 109193,
"codice_catastale": "L117",
"codice_istat": "055032"
}
]
},
"success": true,
"message": "",
"error": null
}

This service returns a COMUNE with a specific PROVINCIA CODE

This service returns a list of COMUNI included in a specific PROVINCIA

Authorizations:

bearerAuth

path Parameters

PROVINCIA

required

string

Default: "<string>"

Example: TR

Italian provincia code

Responses

Response Schema: application/json

success	boolean
message	string
error	integer
	Array of objects (ElencoComuni) [ items ]

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://comuni.openapi.it/province/%7BPROVINCIA%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200
401
402
404

Content type

application/json

{"data": {"nome_provincia": "Terni",
"sigla_provincia": "TR",
"regione": "Umbria",
"comuni": ["Terni"
],
"dettaglio_comuni": [{"nome": "Terni",
"popolazione": 109193,
"codice_catastale": "L117",
"codice_istat": "055032"
}
]
},
"success": true,
"message": "",
"error": null
}

Elenco Province

Returns a list of italian PROVINCE

This service returns a list of PROVINCE

Authorizations:

bearerAuth

Responses

Response Schema: application/json

success	boolean
message	string
error	integer
data	object

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://comuni.openapi.it/province/");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200
401
402

Content type

application/json

{"data": {"AG": "Agrigento",
"AL": "Alessandria",
"AN": "Ancona",
"AO": "Valle d'Aosta/Vallée d'Aoste",
"AP": "Ascoli Piceno",
"AQ": "L'Aquila",
"AR": "Arezzo",
"AT": "Asti",
"AV": "Avellino",
"BA": "Bari",
"BG": "Bergamo",
"BI": "Biella",
"BL": "Belluno",
"BN": "Benevento",
"BO": "Bologna",
"BR": "Brindisi",
"BS": "Brescia",
"BT": "Barletta-Andria-Trani",
"BZ": "Bolzano/Bozen",
"CA": "Cagliari",
"CB": "Campobasso",
"CE": "Caserta",
"CH": "Chieti",
"CL": "Caltanissetta",
"CN": "Cuneo",
"CO": "Como",
"CR": "Cremona",
"CS": "Cosenza",
"CT": "Catania",
"CZ": "Catanzaro",
"EN": "Enna",
"FC": "Forlì-Cesena",
"FE": "Ferrara",
"FG": "Foggia",
"FI": "Firenze",
"FM": "Fermo",
"FR": "Frosinone",
"GE": "Genova",
"GO": "Gorizia",
"GR": "Grosseto",
"IM": "Imperia",
"IS": "Isernia",
"KR": "Crotone",
"LC": "Lecco",
"LE": "Lecce",
"LI": "Livorno",
"LO": "Lodi",
"LT": "Latina",
"LU": "Lucca",
"MB": "Monza e della Brianza",
"MC": "Macerata",
"ME": "Messina",
"MI": "Milano",
"MN": "Mantova",
"MO": "Modena",
"MS": "Massa-Carrara",
"MT": "Matera",
"NA": "Napoli",
"NO": "Novara",
"NU": "Nuoro",
"OR": "Oristano",
"PA": "Palermo",
"PC": "Piacenza",
"PD": "Padova",
"PE": "Pescara",
"PG": "Perugia",
"PI": "Pisa",
"PN": "Pordenone",
"PO": "Prato",
"PR": "Parma",
"PT": "Pistoia",
"PU": "Pesaro e Urbino",
"PV": "Pavia",
"PZ": "Potenza",
"RA": "Ravenna",
"RC": "Reggio Calabria",
"RE": "Reggio nell'Emilia",
"RG": "Ragusa",
"RI": "Rieti",
"RM": "Roma",
"RN": "Rimini",
"RO": "Rovigo",
"SA": "Salerno",
"SI": "Siena",
"SO": "Sondrio",
"SP": "La Spezia",
"SR": "Siracusa",
"SS": "Sassari",
"SU": "Sud Sardegna",
"SV": "Savona",
"TA": "Taranto",
"TE": "Teramo",
"TN": "Trento",
"TO": "Torino",
"TP": "Trapani",
"TR": "Terni",
"TS": "Trieste",
"TV": "Treviso",
"UD": "Udine",
"VA": "Varese",
"VB": "Verbano-Cusio-Ossola",
"VC": "Vercelli",
"VE": "Venezia",
"VI": "Vicenza",
"VR": "Verona",
"VT": "Viterbo",
"VV": "Vibo Valentia"
},
"success": true,
"message": "107 Risultati",
"error": null
}

Elenco Regioni

Returns a list of italian REGIONI

This service returns a list of REGIONI

Authorizations:

bearerAuth

Responses

Response Schema: application/json

success	boolean
message	string
error	integer
data	Array of strings <= 2 items

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://comuni.openapi.it/regioni/");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200
401
402

Content type

application/json

{"data": ["Piemonte",
"Valle d'Aosta/Vallée d'Aoste",
"Lombardia",
"Trentino-Alto Adige/Südtirol",
"Veneto",
"Friuli-Venezia Giulia",
"Liguria",
"Emilia-Romagna",
"Toscana",
"Umbria",
"Marche",
"Lazio",
"Abruzzo",
"Molise",
"Campania",
"Puglia",
"Basilicata",
"Calabria",
"Sicilia",
"Sardegna"
],
"success": true,
"message": "20 Risultati",
"error": null
}

Comuni Italiani (1.0.0)

Elenco Comuni

This service returns a list of COMUNI included in a specific CAP

Authorizations:

path Parameters

Responses

Response Schema: application/json

Request samples

Response samples

This service returns a COMUNE with a specific ISTAT code

Authorizations:

path Parameters

Responses

Response Schema: application/json

Request samples

Response samples

This service returns a COMUNE with a specific CODICE_CATASTALE

Authorizations:

path Parameters

Responses

Response Schema: application/json

Request samples

Response samples

This service returns a COMUNE located in a specific REGIONE

Authorizations:

path Parameters

Responses

Response Schema: application/json

Request samples

Response samples

This service returns a COMUNE with a specific PROVINCIA CODE

Authorizations:

path Parameters

Responses

Response Schema: application/json

Request samples

Response samples

Elenco Province

This service returns a list of PROVINCE

Authorizations:

Responses

Response Schema: application/json

Request samples

Response samples

Elenco Regioni

This service returns a list of REGIONI

Authorizations:

Responses

Response Schema: application/json

Request samples

Response samples

You might also be interested:

Catasto

Cap

VisEngine 2.0

PDF

Gateway SMS