Le nostre tariffe
Listino prezzi a chiamata
- Ricerca Nazionale (Catasto) € 0,30 + iva
Ricerca Nazionale (Catasto)
Evasione :
3 Minuti
-
a partire da € 0,10 + iva
Verifica la presenza di immobili intestati ad un soggetto a livello nazionale tramite API
Ottieni l’elenco delle città in cui un soggetto è intestatario di immobili o terreni in pochi minuti
Il servizio Ricerca Nazionale appartiene all'API Catasto e consente di verificare a livello nazionale tutti gli immobili intestati ad un soggetto. Il risultato è un elenco con le città ed il numero di proprietà intestate al soggetto, suddivise per tipo di catasto (fabbricato e terreno).
Il servizio è identificato dall'endpoint https://catasto.openapi.it/richiesta/ricerca_nazionale
La ricerca può essere effettuata sia su soggetto privato che giuridico.
ESEMPIO RICHIESTA POST /ricerca_nazionale
Il metodo da utilizzare nella richiesta è POST e segue un esempio di chiamata all'endpoint ricerca_nazionale:
POST https://catasto.openapi.it/richiesta/ricerca_nazionale
I parametri da passare nel body della richiesta sono:
- codice fiscale o partita IVA
- tipo di catasto (T per terreno o F per Fabbricato)
Questo è un esempio dei parametri necessari per una richiesta con tipo di catasto 'Fabbricato':
{
"cf_piva": "12485671007",
"tipo_catasto": "F",
}
La risposta è asincrona. È possibile impostare, in fase di richiesta, anche una callback per essere aggiornati su quando i dati saranno disponibili, senza dover chiamare più volte l'endpoint GET /richiesta/{id} per verificarne lo stato.
ESEMPIO RISPOSTA POST /ricerca_persona
La risposta includerà i parametri utilizzati in fase di richiesta più l'ID della richiesta:
{
"data": {
"endpoint": "ricerca_persona_pg",
"stato": "in_erogazione",
"callback": false,
"parametri": {
"cf_piva": "12485671007",
"tipo_catasto": "F",
"provincia": "NAZIONALE-IT"
},
"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 seconda richiesta, come anticipato, ad un altro endpoint con l'id precedentemente ottenuto.
Questo è un esempio di richiesta ricerca nazionale utilizzando l'ID risultato dalla chiamata precedente (664dcdc97de11b2d0426430f):
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 in fase di richiesta ed 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:
- nome o denominazione intestatario
- sede
- codice fiscale intestatario
- id_soggetto
- comuni
- fabbricati (numero)
- terreni (numero)
- provincia
Questo è un esempio di risposta che accerta la presenza di 1 immobile intestato a livello nazionale ad una persona giuridica:
{
"data": {
"endpoint": "ricerca_persona_pg",
"stato": "evasa",
"callback": false,
"parametri": {
"cf_piva": "12485671007",
"tipo_catasto": "F",
"provincia": "NAZIONALE-IT"
},
"risultato": {
"soggetti": [
{
"denominazione": "OPENAPI SRL con sede in ROMA (RM)",
"sede": "ROMA (RM)",
"cf": "12485671007",
"id_soggetto": "1111efff3cwxwewecwfdwedwqddwwed",
"catasti": [
{
"città": "ROMA",
"fabbricati": "1",
"terreni": "0",
"comuni": [
{
"comune": "ROMA",
"fabbricati": "1",
"terreni": "0",
}
],
"provincia": "RM",
}
]
}
]
},
"esito": "OK",
"timestamp": 1625232029,
"owner": "[email protected]",
"id": "60e581c58138e80d804dad20"
},
"success": true,
"message": "",
"error": null
}
Questo invece è un esempio di risposta di ricerca nazionale per persona fisica su catasto 'Fabbricato' e 'Terreno'.
{
"data": {
"endpoint": "ricerca_persona_pf",
"stato": "evasa",
"callback": false,
"parametri": {
"cf_piva": "XXXXXXXXXXX",
"tipo_catasto": "TF",
"provincia": "NAZIONALE-IT",
},
"risultato":{
soggetti:[
{
"cognome": "MARIO",
"nome": "ROSSI",
"data_nascita": "10/01/1982",
"luogo_nascita": "ROMA",
"sesso": "M",
"cf_piva": "XXXXXXXXXXX",
"id_soggetto": "BBRseVB£43mdSd2dqqdqda",
"catasti": [
{
"città": "ROMA",
"fabbricati": "3",
"terreni": "0",
"comuni": [
{
"comune": "ROMA",
"fabbricati": "1",
"terreni": "0",
},
{
"comune": "FIUMICINO",
"fabbricati": "1",
"terreni": "0",
},
{
"comune": "CIAMPINO",
"fabbricati": "1",
"terreni": "0",
}
],
"provincia": "RM",
},
{
"città": "FOGGIA",
"fabbricati": "1",
"terreni": "1",
"comuni": [
{
"comune": "FOGGIA",
"fabbricati": "1",
"terreni": "1",
},
],
"provincia": "RM",
}
]
}
]
},
"esito": "OK",
"timestamp": 1625232029,
"owner": "[email protected]",
"id": "60e581c58138e80d804dad20"
},
"success": true,
"message": "",
"error": null
}
In questo caso il risultato indica che il soggetto è intestario di 3 fabbricati nella provincia di Roma (1 Roma, 1 Fiumicino, 1 Ciampino) e ha 2 proprietà nella provincia di Foggia (1 fabbricato e 1 terreno).
Nella risposta sono presenti anche alcune informazioni sul soggetto:
- Nome e Cognome
- Data e Luogo di Nascita
- Sesso
- ID Soggetto
L'ID soggetto potrà essere utilizzato per effettuare una richiesta diretta di visura catastale soggetto (ordinaria o storica) con l'endpoint dedicato.
Abbonati e risparmia
- CATASTO
- 100 API calls/month (pay monthly) € 0,28 + iva
- 100 API calls/month (pay annually) € 0,25 + iva
- 300 API calls/month (pay monthly) € 0,25 + iva
- 300 API calls/month (pay annually) € 0,20 + iva
- 1.000 API calls/month (pay monthly) € 0,20 + iva
- 1.000 API calls/month (pay annually) € 0,15 + iva
- 5.000 API calls/month (pay monthly) € 0,15 + iva
- 5.000 API calls/month (pay annually) € 0,10 + iva
- 10.000 API calls/year (pay annually) € 0,25 + iva
- 25.000 API calls/year (pay annually) € 0,20 + iva