Il servizio Province appartiene all'API CAP e consente di verificare ed ottenere la lista delle province italiane in tempo reale e tramite API.

È identificato dall’endpoint GET https://cap.openapi.it/province

Questo servizio permette di ottenere la lista delle province con oltre 7 informazioni:

• Sigla Provincia
• Nome Provincia
• Superficie
• Numero residenti
• Numero comuni
• Istat
• Nome regione

ESEMPIO RICHIESTA /province

Province non richiede alcun parametro di ricerca.

https://cap.openapi.it/province

ESEMPIO RISPOSTA /province

Questo è un esempio di risposta:

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

È disponibile inoltre un altro endpoint (/province/{code}) che consente di ottenere informazioni esclusivamente riguardo una singola provincia.

In questo caso è necessario passare come parametro la sigla della provincia.

ESEMPIO RICHIESTA /province/{code}

Questo è un esempio di richiesta di informazioni per la provincia di Frosinone dove il parametro è FR

https://cap.openapi.it/province/fr

La risposta sarà sempre con le stesse informazioni ma unicamente riguardo alla provincia indicata.

ESEMPIO RISPOSTA /province/{code}

Questo è un esempio di risposta per la provincia di Frosinone (FR):

{
  "data": [
    {
      "sigla": "FR",
      "capoluogo": "Frosinone"
      "superficie": 3243.89
      "residenti": 493229,
      "num_comuni": 91,
      "istat": "060",
      "regione": "Lazio"
      
    },
     "success": true,
    "message": "",
    "error": null
}