Our prices
Price list for single API calls
- National Search (Cadastre) € 0,30 + vat
National Search (Cadastre)
- Home
- Real Estate Services
- National Search (Cadastre)
Evasione :
3 Minutes
-
starting from € 0,10 + vat
Check for properties in a subject's name at national level via API
Obtain a list of cities where a person is the owner of real estate or land in a few minutes
The National Search service belongs to the Cadastre API and allows checking nationwide all properties owned by a subject. The result is a list with cities and the number of properties owned by the subject, divided by cadastral type (building and land).
The service is identified by the endpoint https://catasto.openapi.it/richiesta/ricerca_nazionale
Search can be performed for both private and legal subjects.
EXAMPLE REQUEST POST /ricerca_nazionale
The method to use in the request is POST and here is an example of a request to the ricerca_nazionale (national search) endpoint:
POST https://catasto.openapi.it/richiesta/ricerca_nazionale
The parameters to pass in the request body are:
- tax code or VAT number
- cadastral type (T for land or F for Building)
This is an example of the parameters required for a request with 'Building' (Fabbricato in Italian) as cadastral type:
{
"cf_piva": "12485671007",
"tipo_catasto": "F",
}
The response is asynchronous. It is possible to set a callback during the request phase to be updated when the data is available, without having to call the GET /richiesta/{id} endpoint multiple times to check its status.
EXAMPLE RESPONSE POST /ricerca_nazionale
The response will include the parameters used in the request along with the request ID:
{
"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
}
EXAMPLE REQUEST GET /richiesta/{id}
To obtain the data, it will be necessary to make a second request, as mentioned earlier, to another endpoint using the previously obtained ID.
This is an example of a national search request using the ID obtained from the previous call (664dcdc97de11b2d0426430f):
GET https://catasto.openapi.it/richiesta/664dcdc97de11b2d0426430f
EXAMPLE RESPONSE GET /richiesta/{id}
Again, the data in the response will include the parameters used in the request and information about the properties or lands compatible with the search.
If the search was performed on the 'building' cadastral type, the information will be as follows:
- owner's name or denomination
- location
- owner's tax code
- subject ID
- municipalities
- buildings (number)
- lands (number)
- province
This is an example of a response that includes 1 property at the national level:
{
"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
}
This is an example of a national search response for an individual on both 'Building' and 'Land' cadasters.
{
"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 this case, the result indicates that the subject is the owner of 3 buildings in the province of Rome (1 Rome, 1 Fiumicino, 1 Ciampino) and has 2 properties in the province of Foggia (1 building and 1 piece of land).
The answer also includes some information about the subject:
- Name and Surname
- Date and Place of Birth
- Gender
- Subject ID
The subject ID can be used to make a direct request for a subject cadastral certificate (ordinary or historical) with the dedicated endpoint.
Subscribe and save
- CATASTO
- 100 API calls/month (pay monthly) € 0,28 + vat
- 100 API calls/month (pay annually) € 0,25 + vat
- 300 API calls/month (pay monthly) € 0,25 + vat
- 300 API calls/month (pay annually) € 0,20 + vat
- 1.000 API calls/month (pay monthly) € 0,20 + vat
- 1.000 API calls/month (pay annually) € 0,15 + vat
- 5.000 API calls/month (pay monthly) € 0,15 + vat
- 5.000 API calls/month (pay annually) € 0,10 + vat
- 10.000 API calls/year (pay annually) € 0,25 + vat
- 25.000 API calls/year (pay annually) € 0,20 + vat