Tutti i dati di CAP, Comuni, Province, Regioni sempre aggiornati
Verifica e ottieni in tempo reale info su CAP, Codici Istat e rispettivi Comuni. Fonte ufficiale Poste Italiane.
È possibile ottenere il codice ISTAT tramite l'endpoint GET /cerca_comuni.
I parametri per /cerca-comuni possono essere:
- Nome Comune
- CAP
- ISTAT
- Codice Catastale
- Regione
- Provincia
La risposta restituirà:
- Codice ISTAT
- Comune
- Soppresso
L'API consente di ottenere informazioni aggiornate su singole città tramite 2 API:
- Get /comuni_base/{istat_code}
- Get /comuni_advance/{istat_code}
In entrambi i casi il parametro di ricerca è il Codice ISTAT ottenibile tramite l'endpoint GET /cerca_comuni
La risposta alla richiesta all'endpoint /comuni_base/{istat_code} include:
- Codice istat
- Comune
- Regione
- Provincia
- CAP (tutti i CAP inclusi nell’unità amministrativa definita nel codice ISTAT)
La risposta alla richiesta all'endpoint /comuni_advance/{istat_code} include:
- Codice istat
- Comune
- Regione
- Provincia
- Prefisso
- Codice Fisco (o Codice Bellofiore)
- Numero residenti
- Nome Abitanti
- Nome Patrono e data festività
- Indirizzo del Municipio
- Eventuale vecchio codice Istat
- Indirizzo Email e PEC
- Telefono e Fax
- Frazioni
- CAP
Il codice comune catastale (cod_fisco), denominato anche codice Bellofiore, composto da 3 numeri e una lettera è disponibile nella risposta dell’endpoint /comuni_advance/{istat_code}.
Tramite l'endpoint /comuni_soppressi è possibile ottenere l'elenco dei comuni soppressi in una provincia.
Il parametro della richiesta è la sigla provincia e la risposta include anche i seguenti dati:
- Codice istat
- Comune
- Codice Fisco
- Sigla Provincia
- Provincia
- Regione
La richiesta all’endpoint /regioni non richiede nessun parametro.
La risposta restituisce l’elenco di tutte le regioni italiane con le seguenti informazioni:
- Nome Regione
- Capoluogo
- Superficie
- Numero residenti
- Numero comuni
- Presidente
- Codice fiscale
- Partita iva
- PEC
- Sito
- Indirizzo Sede
- Codice Istat
- Numero Province
La richiesta all’endpoint /citta-metropolitane non richiede alcun parametro.
La risposta restituisce l’elenco di tutte le città metropolitane e i seguenti dati:
- Nome
- Capoluogo
- Superficie
- Densità
- Numero Comuni
È possibile utilizzare 2 endpoint:
- GET /province
- GET /province/{code}
La richiesta verso l’endpoint GET /province non richiede parametri e restituisce l’elenco di tutte le province italiane con le seguenti informazioni:
- Sigla Provincia
- Provincia
- Superficie
- Numero Residenti
- Numero Comuni
- Codice Istat
- Regione
La richiesta all’endpoint GET /province/{code} invece richiede come parametro il codice della provincia e restituisce le informazioni specifiche su questa:
- Sigla Provincia
- Provincia
- Superficie
- Numero Residenti
- Numero Comuni
- Codice Istat
- Regione
Il servizio restituisce la risposta in tempo reale.
Il costo della richiesta singola dipende dall’endpoint:
- Cerca Comuni Base €0,04
- Cerca Comuni Advance €0,05
- Cerca CAP €0,04
Per gli altri endpoint sono gratuite fino alla soglia massima di 10.000 richieste mensili, poi verranno addebitati €0,01 a richiesta.
Sì, è possibile attivare l’abbonamento annuale, e risparmiare quindi sul costo della singola chiamata.
Nella sezione Abbonamenti dell’API specifica puoi vedere le opzioni disponibili (con i relativi prezzi e la percentuale di risparmio) e puoi anche attivare l’abbonamento che preferisci.
Nella sezione Utilizzo, a livello di API, è possibile monitorare le richieste gratuite ed effettuate tramite abbonamento o ricarica. Sono disponibili sia in modalità grafica (periodo mese e anno), sia con un riepilogo testuale.
I dati sono aggiornati 3 volte l’anno.
La fonte principale è Poste Italiane. I dati sono arricchiti da ulteriori fonti affidabili e certificate.