Elenco Immobili da Indirizzo - Italia

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

Il servizio appartiene all'API Catasto ed è 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.

I dati necessari per effettuare la richiesta sono:

Il servizio consente di accedere a dati come ad esempio indirizzo, zona censuaria, categoria, classe, consistenza, rendita o reddito agrario / dominicale, etc.

Il servizio è asincrono e quindi è necessario effettuare una prima richiesta per ottenere l'id e poi una seconda per ottenere i dati quando la richiesta sarà nello stato evaso.

ESEMPIO RICHIESTA

POST /indirizzo

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

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

Questo è un esempio dei parametri necessari da passare nel payload della richiesta:

{
      "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
}

L'ID sarà necessario per effettuare lo stato della richiesta ed accedere ai dati desiderati quando la richiesta sarà evasa. I dati sono generalmente disponibili in qualche minuto.

ESEMPIO RICHIESTA (id)

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:

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.

Il servizio è ideale per chi necessita di un accesso rapido ad informazioni catastali verificate come ad esempio agenzie immobiliari, studi notarili, società di consulenza immobiliare e patrimoniale.