Le nostre API permettono di verificare e ottenere in tempo reale dati amministrativi, territoriali e postali di città, province e regioni, assicurando informazioni ufficiali, accurate e corrette (ad esempio per consegne e ottimizzazioni checkout grazie all'autocomplete). Il service CAP è già utilizzato da centinaia di ecommerce con migliaia di transazioni al giorno.

I dati sono quelli ufficiali di Poste Italiane e sono aggiornati due volte l'anno. Sono tutti dati disponibili tramite API e si può accedere al database interamente su richiesta. 

Openapi mette a disposizione diverse tipologie di servizi di verifica e aggiornamento dati CAP e Dati Territoriali API: 

1) Cerca Comuni (GET /cerca_comuni)

Il metodo Cerca Comuni è gratuito e consente di ottenere il codice ISTAT di qualsiasi città italiana a partire da una serie di parametri come città, CAP, Codice Catasto, Regione, Provincia, Codice Fisco. Il codice ISTAT ricavato potrà poi essere utilizzato per ottenere ulteriori informazioni sui Comuni tramite altri endpoint, come Cerca Comuni Base o Advance.

La risposta può includere una o più città in base ai parametri utilizzati con rispettivi codici ISTAT:

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

2) Cerca Comuni Base (GET /comuni_base/{istat_code})

Il metodo Cerca Comuni Base permette, a partire dal codice ISTAT (ottenibile tramite il GET /cerca_comuni), di ricavare le informazioni base di una città come regione, provincia, CAP.

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

Molti ecommerce o piattaforme hanno integrato queste API perché con una semplice chiamata è possibile semplificare i processi di compilazione di form di spedizione e fatturazione con dati sempre aggiornati e validi. Ad esempio, una volta che l'utente inserisce il CAP nel form, sarà possibile compilare automaticamente i dati di provincia e città senza errori manuali o refusi di inserimento.

3) Cerca Comuni Advance (GET /comuni_advance/{istat_code})

Il metodo Cerca Comuni Advance consente - sempre a partire dal codice ISTAT (ricavabile tramite il GET /cerca_comuni) - di ottenere informazioni più dettagliate rispetto ad una città. Infatti oltre ai dati inclusi nella risposta del Cerca Comuni Base è possibile avere informazioni come prefisso, codice fisco, superificie, numero residenti, indirizzo sede del municipio, PEC, telefono, frazioni, 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) Cerca CAP  (GET /cap/{cap})

Il metodo permette, a partire dal CAP, di ottenere i seguenti dati corrispondenti: codice ISTAT, Comune, eventuale frazione, provincia, sigla provincia, regione. Nel caso in cui allo stesso CAP siano associati più comuni verranno riportati tutti i dati corrispondenti.

{
  "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) Cerca Comuni Soppressi (GET /comuni_soppressi)

A partire dalla sigla di provincia (es. RM), il metodo consente di ottenere l'elenco dei comuni soppressi in quella provincia ed informazioni come codice ISTAT, Codice Fiscale, Regione, nome provincia in maniera estesa.

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

6) Cerca Città Metropolitane (GET /comuni_metropolitane)

Con il metodo Cerca Città Metropolitane è possibile ottenere la lista di tutte le città metropolitane con informazioni quali popolazione, superficie, densità, numero comuni.

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

7) Cerca Regioni (GET /regioni)

Il metodo Cerca Regioni consente di ottenere la lista di tutte le regioni con informazioni quali numero capoluogo, residenti, numero comuni, presidente, codice fiscale, PEC, sito, Sede.

{
  "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) Cerca Province (GET /province)

Con questo metodo è possibile ricavare la lista di tutte le province con informazioni come sigla, superficie, residenti, numero comuni e codici istat.

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

9) Cerca Province (GET /province/{code}

Il metodo permette di ottenere informazioni come sigla, superficie, residenti, numero comuni e codici istat di una determinata provincia.

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

NOTA BENE: I metodi province, regioni, comuni soppressi e metropolitani prevedono 10.000 chiamate / mese gratuite. Superato quel limite, il costo della singola chiamata è pari a 0,01€.