Il servizio Elenco Immobili da Indirizzo appartiene all'API Catasto e consente di accedere ad informazioni aggiornate su immobili e terreni a partire da un indirizzo.

Il servizio è identificato dall'endpoint https://catasto.openapi.it/richiesta/indirizzo

A differenza degli altri servizi dell'API Catasto, in questo caso bisogna effettuare una richiesta per ottenere uno dei parametri obbligatori: l'ID indirizzo. L'endpoint da utilizzare è GET /indirizzo ed è necessario passare i dati Provincia, Comune, Sezione (se presente) ed indirizzo.

Una volta ottenuto l'ID, sarà possibile effettuare la richiesta al servizio Elenco Immobili da Indirizzo.

ESEMPIO RICHIESTA POST /indirizzo

Il metodo da utilizzare è POST, segue un esempio di chiamata all'endpoint:

POST https://catasto.openapi.it/richiesta/indirizzo

I parametri da passare nel body della richiesta sono:

• id_indirizzo
• dal_civico
• al_civico

Questo è un esempio dei parametri necessari: 

{
      "id_indirizzo": "MjUwNSMyMzYjVklBIERFTCBSSVZP",
      "dal_civico": "3",
      "al_civico": "4", 
    }

La risposta è asincrona. In fase di richiesta è possibile anche impostare una callback per essere aggiornati su quando i dati saranno disponibili.

ESEMPIO RISPOSTA POST /indirizzo

La risposta includerà i parametri utilizzati in fase di chiamata più l'ID : 

{
  "data": {
    "endpoint": "indirizzo",
    "stato": "in_erogazione",
    "callback": false,
    "parametri": {
      "id_indirizzo": "MjUwNSMyMzYjVklBIERFTCBSSVZP",
      "dal_civico": 2,
      "al_civico": 3      
    },
    "risultato": null,
    "esito": null,
    "timestamp": 1716374985,
    "owner": "[email protected]",
    "id": "664dcdc97de11b2d0426430f"
  },
  "success": true,
  "message": "",
  "error": null
}

ESEMPIO RICHIESTA GET /richiesta/{id}

Per ottenere i dati sarà necessario effettuare una chiamata ad un altro endpoint con l'ID precedentemente ottenuto. Questo è un esempio di richiesta:

GET https://catasto.openapi.it/richiesta/664dcdc97de11b2d0426430f

ESEMPIO RISPOSTA GET /richiesta/{id}

Anche in questo caso i dati presenti nella risposta includeranno i parametri utilizzati precedentemente più oltre 10 informazioni sugli immobili o terreni compatibili con la ricerca. 

Nel caso in cui la ricerca sia stata effettuata su tipo di catasto 'Fabbricato', le informazioni saranno le seguenti:

• subalterno
• indirizzo
• zona censuaria
• categoria
• classe
• consistenza
• rendita
• id_immobile 

 Di seguito un esempio di risposta che prevede 2 immobili nel risultato:

{
  "data": {
    "endpoint": "indirizzo",
    "stato": "evasa",
    "callback": false,
    "parametri": {
      "id_indirizzo": "MjUwNSMyMzYjVklBIERFTCBSSVZP",
      "dal_civico": "2",
      "al_civico": "3"
    },
    "risultato": {
      "immobili": [
        {
          "sezione_urbana": null,
          "foglio": 84,
          "particella": 252,
          "subalterno": "",
          "indirizzo": "VIA DEL RIVO, 2 Piano T - S1",
          "zona_censuaria": "2",
          "categoria": "A/7",
          "classe": "4",
          "consistenza": "5,5 vani",
          "rendita": "Euro:426,09",
          "partita": "",
          "id_immobile": "saf1sf9djosaj0asdaljf93jfjkdkjsòfrjòjsdfòajdsòjfòsjf"

        },
        {
          "sezione_urbana": null,
          "foglio": 69,
          "particella": 965,
          "subalterno": 1,
          "indirizzo": "VIA DEL RIVO, 3 Piano T",
          "zona_censuaria": "2",
          "categoria": "C/1",
          "classe": "3",
          "consistenza": "70 mq",
          "rendita": "Euro: 566,79",
          "id_immobile": "saf1sf9djosaj0adsf3234eedeòjsdfòajdsòjfòsjf"

        }
      ]
    },
    "esito": "OK",
    "timestamp": 1625232029,
    "owner": "[email protected]",
    "id": "60e581c58138e80d804dad20"
  },
  "success": true,
  "message": "",
  "error": null
}

La risposta conterrà anche gli ID degli immobili/terreni che potranno essere utilizzati per effettuare una richiesta diretta di visura catastale immobile (ordinaria o storica) utilizzando l'endpoint dedicato.