Check a property before buying it
From the address in the listing to what the cadastre says and what the satellite sees: which finca it is, what is inside, whether it falls in a protected area and whether the ground moves. Each step uses a different parcel to show a case with data; in your flow it is the same reference from start to end.
Countries: ES
1. From the address to the finca
A free-text address returns candidates ranked by confidence (0 to 1) with the 14-character reference, the use, the dwellings and the year. From 0.75 up, number and municipality match. It costs 1 unit only when there are candidates.
curl -G "https://api.parcelgps.com/v1/search/address/candidates" \
--data-urlencode "q=Avenida José Rodríguez de la Borbolla Camoyán 10, Dos Hermanas" \
--data-urlencode "limit=3" \
-H "X-API-Key: $CATASTROGPS_API_KEY"Real response
{
"success": true,
"data": {
"query": {
"text": "Avenida José Rodríguez de la Borbolla Camoyán 10, Dos Hermanas",
"street": "Avenida José Rodríguez de la Borbolla Camoyán",
"number": 10,
"municipality": "Dos Hermanas"
},
"candidates": [
{
"reference": "0745901TG4304N",
"country": "ES",
"address": "AVENIDA JOSE RGUEZ BORBOLLA CAMOY 10",
"number": 10,
"postalCode": "41704",
"municipality": "Dos Hermanas",
"region": "Sevilla",
"latitude": 37.31947088654626,
"longitude": -5.926788955974699,
"confidence": 0.93,
"numberMatches": true,
"municipalityMatches": true,
"inOwnCopy": true,
"cadastreAddress": "AV JOSE RGUEZ BORBOLLA CAMOY 10",
"use": "Residencial",
"dwellings": 346,
"yearBuilt": 2023
},
{
"reference": "0747201TG4304N",
"country": "ES",
"address": "BULEVAR JOSE RODRIGUEZ DE LA BORBOLLA CAMOYAN 11",
"number": 11,
"confidence": 0.55,
"numberMatches": false,
"municipalityMatches": true,
"inOwnCopy": true
}
],
"attribution": "CartoCiudad (Instituto Geográfico Nacional) y Dirección General del Catastro"
},
"remainingSearches": 2894
}2. What is inside: dwellings, premises and annexes
With the 14-character reference you get every unit of the finca with use, area, floor, door and participation coefficient. Use it to check that the area and use in the listing match the cadastre. It costs 1 unit per unit served.
curl "https://api.parcelgps.com/v1/parcels/0745901TG4304N/units" \
-H "X-API-Key: $CATASTROGPS_API_KEY"Real response
HTTP/2 200
etag: "5ab6bd3d95f85dddba81818bcb0cb65e"
cache-control: private, max-age=21600
x-quota-remaining: 2893
{
"success": true,
"data": {
"reference": "0745901TG4304N",
"address": "AV JOSE RGUEZ BORBOLLA CAMOY 10",
"postalCode": "41704",
"municipality": "DOS HERMANAS",
"region": "Sevilla",
"mainUse": "Residencial",
"totalArea": 32789,
"yearBuilt": 2023,
"unitCount": 200,
"propertyUnitCount": 365,
"units": [
{
"reference": "0745901TG4304N0002KH",
"staircase": "",
"floor": "01",
"door": "B",
"use": "Residencial",
"area": 155,
"description": "Planta 01, Pta. B - Residencial",
"ownershipShare": 0.279543,
"yearBuilt": 2023,
"address": "AV JOSE RGUEZ BORBOLLA CAMOY 10 Pl:01 Pt:B"
},
{
"reference": "0745901TG4304N0003LJ",
"staircase": "",
"floor": "01",
"door": "C",
"use": "Residencial",
"area": 163,
"description": "Planta 01, Pta. C - Residencial",
"ownershipShare": 0.293879,
"yearBuilt": 2023,
"address": "AV JOSE RGUEZ BORBOLLA CAMOY 10 Pl:01 Pt:C"
}
],
"truncated": true,
"nextCursor": "0745901TG4304N0201MZ",
"dataSource": "clone",
"dataDate": "2026-01-23",
"attribution": "Dirección General del Catastro"
},
"remainingSearches": 2893
}3. Protected areas: Natura 2000 and parks
Before buying rural land it pays to know whether it lies inside a protected area: it limits what can be built or planted. /terrain intersects the parcel outline with Natura 2000 and the national protected areas (CDDA) and says which share of the parcel is inside. Real example: a parcel fully inside the Monfragüe National Park.
curl "https://api.parcelgps.com/v1/parcels/10194A00110004/terrain?country=ES" \
-H "X-API-Key: $CATASTROGPS_API_KEY"Real response, trimmed
{
"success": true,
"data": {
"reference": "10194A00110004",
"country": "ES",
"protectedAreas": {
"status": "ok",
"intersects": true,
"inside": true,
"maxOverlapPct": 100,
"natura2000": [
{
"code": "ES0000014",
"name": "Monfragüe y las Dehesas del Entorno",
"type": "SPA",
"country": "ES",
"overlapPct": 100
},
{
"code": "ES4320077",
"name": "Monfragüe",
"type": "SCI",
"country": "ES",
"overlapPct": 100
}
],
"national": [
{
"code": "4820",
"name": "Monfragüe",
"designation": "National Park",
"country": "ES",
"overlapPct": 100
}
],
"method": "parcel",
"sources": [
{
"name": "Natura 2000",
"license": "CC BY 4.0",
"edition": "end 2024"
},
{
"name": "Nationally designated areas (CDDA)",
"license": "CC BY 4.0",
"edition": "2025"
}
]
}
}
}4. Whether the ground is sinking
/ground-motion gives the vertical velocity of the ground measured by the Sentinel-1 radar (Copernicus EGMS, 2020-2024) over the parcel. Real example: a parcel in Murcia sinking 40.9 mm a year, class severe_subsidence. When the satellite has no reflectors (open fields, forest, water) it answers status no_data instead of guessing.
curl "https://api.parcelgps.com/v1/parcels/30024A16000286/ground-motion?country=ES" \
-H "X-API-Key: $CATASTROGPS_API_KEY"Real response
{
"success": true,
"data": {
"reference": "30024A16000286",
"country": "ES",
"status": "ok",
"period": { "from": "2020-01", "to": "2024-12", "label": "2020-2024" },
"groundMotion": {
"class": "severe_subsidence",
"worstClass": "severe_subsidence",
"vertical": {
"meanMmYear": -40.9, "maxSubsidenceMmYear": -40.9, "maxUpliftMmYear": 0,
"stdMmYear": 0.1, "accelerationMmYear2": -0.7, "rmseMm": 2.3
},
"eastWest": { "meanMmYear": -5.1, "stdMmYear": 0.1 },
"yearlyDisplacement": [
{ "year": 2020, "mm": -17.9 }, { "year": 2021, "mm": -57.2 }, { "year": 2022, "mm": -95.8 },
{ "year": 2023, "mm": -141.8 }, { "year": 2024, "mm": -179.8 }
],
"cellsWithData": 1, "cellsConsidered": 1, "coveragePct": 100,
"basis": "parcel", "cellSizeM": 100
},
"source": {
"name": "European Ground Motion Service (EGMS) L3 Ortho",
"license": "Copernicus data policy (Regulation (EU) No 1159/2013): free, commercial use allowed with attribution",
"attribution": "Contains modified Copernicus Land Monitoring Service information, European Ground Motion Service 2020-2024 (© European Union, Copernicus Land Monitoring Service, EEA)",
"resolution": "100 m"
},
"calculatedAt": "2026-10-01T08:13:58Z",
"provenance": "2"
},
"remainingSearches": 4320
}