Il servizio Monitoraggio Catastale è la soluzione ideale per società immobiliari, aziende, istituti di credito, studi legali e professionisti che necessitano di vigilare costantemente sulla situazione immobiliare di un soggetto o di una specifica particella. Grazie all’integrazione tramite API, il Monitoraggio Catastale elimina la necessità di effettuare richieste manuali periodiche riducendo i costi di gestione e azzerando il rischio di operare con dati obsoleti.
Il servizio agisce come un sistema di allerta automatizzato: attraverso un endpoint dedicato è possibile abilitare un monitoraggio per ricevere notifiche in caso di variazioni o aggiornamenti ai seguenti servizi catastali:
Impostando una callback, il sistema invierà una notifica al completamento del primo controllo e, successivamente, periodicamente ogni 7 giorni.
Il monitoraggio ha una durata di 12 mesi.
POST /monitoraggio
Per procedere alla richiesta di Monitoraggio Catastale tramite l'API Catasto è necessario passare in fase di richiesta i seguenti dati:
La configurazione del parametro "campi_monitorati" varia in base al servizio scelto. Per "Prospetto Catastale", il parametro è flessibile: lasciandolo vuoto o impostandolo su "all" il sistema monitora l'intero set di dati, ma vi è la possibilità di personalizzare il monitoraggio indicando un elenco di campi specifici. Per "Ricerca Persona" e "Ricerca Nazionale" invece non è prevista personalizzazione e vengono monitorati automaticamente tutti i campi.
Per richiedere il Monitoraggio Catastale passeremo le informazioni con tutti i parametri necessari per completare correttamente la richiesta.
https://catasto.openapi.it/monitoraggio
Nel payload saranno passate le informazioni precedentemente indicate (di seguito l'esempio per Prospetto Catastale):
{
"tipo_monitoraggio": "prospetto_catastale",
"tipo_catasto": "F",
"provincia": "RM",
"comune": "ROMA",
"foglio": 123,
"particella": 123,
"subalterno": 123,
"campi_monitorati": [
"rendita",
"classe",
"intestatari"
],
"rinnovo_automatico": true,
"callback": {
"url": "https://www.mysite.it/callback.php"
}La risposta includerà i parametri utilizzati in fase di richiesta più l'ID della richiesta.
Verranno inoltre indicate le date di creazione, dell'ultima e della prossima verifica, oltre alla scadenza del servizio (la cui durata è di un anno).
{
"data": {
"tipo_monitoraggio": "ricerca_nazionale_pg",
"campi_monitorati": [
"all"
],
"rinnovo_automatico": true,
"callback": {
"method": "JSON",
"url": "https://www.mysite.it/callback.php",
"user_id": "",
"username": "",
"field": "data",
"headers": {},
"data": {},
"retry": 0,
"scope": null,
"domain": null,
"custom": null
},
"owner": "[email protected]",
"parametri": {
"cf_piva": "12485671007",
"tipo_catasto": "TF",
"provincia": "NAZIONALE-IT"
},
"data_creazione": "2026-06-22",
"data_ultima_verifica": null,
"data_prossima_verifica": "2026-06-29",
"data_scadenza": "2027-06-22",
"esito": null,
"campi_aggiornati": null,
"ultimo_dataset": null,
"dataset_precedente": null,
"id": "6a39525d5748340e5c0d5891"
},
"success": true,
"message": "",
"error": null
}
GET /monitoraggio{_id}
Per verificare lo stato della richiesta è possibile utilizzare l'endpoint dedicato passando l'id precedentemente ottenuto nella risposta.
https://catasto.openapi.it/monitoraggio/6a1234a2e60c4e3ad1234d19In caso di stato evaso la risposta riporterà tutte le informazioni corrispondenti alla richiesta.
{
"data": {
"tipo_monitoraggio": "prospetto_catastale",
"rinnovo_automatico": true,
"callback": {
"method": "JSON",
"url": "https://www.mysite.it/callback.php",
"user_id": "",
"username": "",
"field": "data",
"headers": {},
"data": {},
"retry": 0,
"scope": null,
"domain": null,
"custom": null
},
"campi_monitorati": [
"rendita"
],
"owner": "[email protected]",
"parametri": {
"tipo_catasto": "F",
"provincia": ROMA Territorio-RM",
"comune": "H501#ROMA#0#0",
"sezione": null,
"sezione_urbana": "",
"foglio": 123,
"particella": 123,
"subalterno": 123
},
"data_creazione": "2023-06-22",
"data_ultima_verifica": "2023-06-22",
"data_prossima_verifica": "2023-06-29",
"data_scadenza": "2024-06-22",
"esito": "OK",
"campi_aggiornati": {
"rendita": "R.Euro:43,30"
},
"ultimo_dataset": {
"immobili": [
{
"sezione_urbana": null,
"foglio": 123,
"particella": 123,
"subalterno": 23,
"indirizzo": "VIA ROMA",
"sezione": null,
"zona_censuaria": "",
"categoria": "C06",
"classe": "02",
"consistenza": 20 m2",
"rendita": "R.Euro:43,30",
"partita": "",
"id_immobile": "MTIzNDU2IzEyMzQ1NiNGIzEyMyMxMjMjSDUwMSMjMTIzIyAjUk9NQQ==",
"intestatari": [
{
"denominazione": "MARIO BIANCHI nato a ROMA (RM) il 28/05/1984",
"cf": "BNCMRA84E28H501E",
"proprieta": "Proprieta'",
"quota": "1/1"
}
]
}
]
},
"dataset_precedente": {
"immobili": [
{
"sezione_urbana": "C",
"foglio": 456,
"particella": 456,
"subalterno": 456,
"indirizzo": "VIA MILANO",
"sezione": "C",
"zona_censuaria": "C",
"categoria": "A01",
"classe": "03",
"consistenza": 5,5 vani",
"rendita": "R.Euro:200,25",
"partita": "",
"id_immobile": "MTIzNDU2IzEyMzQ1NiNGIzEyMyMxMjMjSDUwMSMjMTIzIyAjUk9NQQ==",
"intestatari": [
{
"denominazione": MARIO BIANCHI nato a ROMA (RM) il 28/05/1987",
"cf": "RSSMRA87E28H501E",
"proprieta": "Proprieta'",
"quota": "1/1"
}
]
}
]
},
"id": "6a1234a2e60c4e3ad1234d19"
},
"success": true,
"message": "",
"error": null
}
DELETE /monitoraggio/{id}/
È possibile eliminare un monitoraggio su catasto prima della fine del servizio tramite metodo DELETE /monitoraggio/{id} passando l'id precedentemente ottenuto nella risposta.
https://catasto.openapi.it/delete/6a1234a2e60c4e3ad1234d19In caso di stato evaso la risposta riporterà esito positivo.
{
"data": [],
"success": true,
"message": "1 deleted monitor",
"error": null
}
Hai bisogno di aiuto?
Non hai trovato la risposta che cercavi?
Compila tutti i campi, ti ricontatteremo al più presto!
È un sistema di monitoraggio automatizzato progettato per inviare notifiche in caso di variazioni o aggiornamenti dei dati catastali. Il servizio avvisa quando viene rilevata una variazione nei dati relativi a un immobile o a un determinato soggetto (monitorabile sia a livello nazionale che presso una specifica conservatoria).
Puoi scegliere tra tre diversi tipi di monitoraggio, in base alle tue esigenze:
Il primo controllo viene eseguito istantaneamente (in pochi secondi). Qualora i dati non fossero immediatamente disponibili, la richiesta verrà elaborata in automatico entro le 24 ore successive (con allineamento alle ore 01:00). I monitoraggi successivi verranno poi eseguiti periodicamente ogni 7 giorni.
Se hai configurato l'URL di callback, riceverai una notifica in due momenti:
Dipende dal tipo di servizio:
Se non viene specificato nel payload della richiesta, il sistema imposta il valore predefinito su true. Il monitoraggio continuerà quindi a rinnovarsi automaticamente alla scadenza annuale.
È sufficiente inviare una richiesta utilizzando il metodo DELETE /monitoraggio/{id}/.
L'evento di monitoraggio verrà rimosso e i controlli automatici interrotti.
Se nei controlli precedenti erano presenti dei beni e in quello attuale il soggetto non risulta più intestatario di nulla, l'esito restituito sarà "Nessun risultato trovato". Nel JSON la struttura del soggetto verrà mantenuta, ma l'array degli immobili (immobili o catasti) verrà restituito vuoto.
Nel JSON di risposta del monitoraggio evaso troverai l'oggetto “Campi Aggiornati” (che isola il valore modificato, ad esempio: "Rendita"), affiancato dai due blocchi storici completi ultimo_dataset e dataset_precedente per effettuare un confronto puntuale.