terminal Cadastral API

Spain cadastral parcel API

Look up any parcel in Spain by its cadastral reference, by coordinates or by address and get its GPS point, outline and area as JSON. The data comes from the Dirección General del Catastro and the foral cadastres of Navarre and the Basque Country. You call one REST API with one key, and the same key answers 29 European countries.

redeem 250 calls a month free, with no card and no expiry date.

Create a free API key arrow_forward Read the documentation

What the API returns in Spain

Parcel by cadastral reference	Yes
Parcel by coordinates (lat, lng)	Yes
Outline and area	Yes
Address to parcel with CartoCiudad	Yes
Building: use, built area, year, dwellings, floors	Yes
Solar, agriculture and score (/solar, /agro, /score)	Yes
Relief, Natura 2000 and protected areas (/terrain)	Yes
Ground motion from Copernicus EGMS, 2020-2024 (/ground-motion)	Yes
Climate normals from ERA5-Land (inside /terrain) The ERA5-Land grid is still loading: until it finishes, the climate block answers status unavailable.	Loading

How a parcel is identified in Spain

The API takes the cadastral reference of 20 characters, or its first 14 for the parcel (for example 9872023VH5797S0001WX). You can also start from a point with /api/search/coordinates or from an address with /api/search/address/candidates?country=ES.

Example with a real response

Lookup by reference (9872023VH5797S0001WX). Response measured against production on 3 October 2026 and trimmed: the outline has 6 vertices and two are shown.

curl -H "X-API-Key: $CATASTROGPS_API_KEY" \
  "https://api.parcelgps.com/api/catastro/9872023VH5797S0001WX?country=ES"

{
  "success": true,
  "data": {
    "refCatastral": "9872023VH5797S0001WX",
    "pais": "ES",
    "direccion": "CL GLORIA 51 Pl:OD Pt:OS",
    "codigoPostal": "13730",
    "municipio": "SANTA CRUZ DE MUDELA",
    "provincia": "Ciudad Real",
    "latitud": 38.6401435,
    "longitud": -3.4632835,
    "googleMapsUrl": "https://www.google.com/maps?q=38.640144,-3.463284",
    "uso": "Residencial",
    "clase": "Urbano",
    "superficieConstruida": 308,
    "superficieParcela": 397,
    "anioConstruccion": 1980,
    "poligono": [
      [38.64033960550103, -3.463190495967865],
      [38.64014267310775, -3.4631650149822235]
    ]
  }
}

Relief, protected areas and ground motion of the same parcel

Pass the reference and the point of the parcel to /terrain (Copernicus DEM GLO-30 relief, Natura 2000 and national protected areas) and to /ground-motion (vertical and east-west velocity from EGMS). Each answer carries its source, licence and the attribution to display.

curl -H "X-API-Key: $CATASTROGPS_API_KEY" \
  "https://api.parcelgps.com/api/catastro/9872023VH5797S0001WX/terrain?country=ES&lat=38.6401435&lng=-3.4632835"

curl -H "X-API-Key: $CATASTROGPS_API_KEY" \
  "https://api.parcelgps.com/api/catastro/9872023VH5797S0001WX/ground-motion?country=ES&lat=38.6401435&lng=-3.4632835"

Prices

The same plans in every country. Only answers with data count: not found, 304 and errors are free.

Free

€0

250 calls a month

10 requests/min

Developer

€19/month

5,000 calls a month

60 requests/min

Startup

€49/month

15,000 calls a month

120 requests/min

Growth

€99/month

50,000 calls a month

300 requests/min

For businesses

The public plans go from 250 free calls to 50,000 calls a month, with the same key in Spain and in 29 countries. If you need more volume, your own SLA or a country we do not cover yet, write to us.

checkOnly answers with data count: not found, 304 Not Modified and errors are free.
checkThe free plan needs no card and does not expire; the paid plans are monthly.
checkEvery answer names its source, its licence and the attribution to show.

What companies use it for in Spain

Real estate agencies and portals

Outline and area of each listing from its address, its reference or a point on the map.

Property managers

A portfolio of parcels kept up to date; a re-check that has not changed answers 304 and costs nothing.

Insurers and lenders

Subsidence (/ground-motion), slope and protected areas (/terrain) for each insured or financed parcel.

Solar

Yearly production, savings and payback of a rooftop or ground installation with /solar.

Write to us with your expected volume and countries; we answer by email: soporte@catastrogps.es

Create a free API key arrow_forward

Frequently asked questions

Is there an official cadastre API in Spain?

The official data is published by the Dirección General del Catastro and the foral cadastres of Navarre and the Basque Country, through its own services with their own formats, reference systems and limits. Parcel GPS reads those services and gives you one REST/JSON API with an API key, WGS84 coordinates ready for a map and the same response in 29 countries.

How is a parcel identified in Spain?

With the cadastral reference of 20 characters, or its first 14 for the parcel (for example 9872023VH5797S0001WX). If you do not have it, search by coordinates or by address and the API returns the reference together with the outline.

How much does it cost?

250 calls a month are free, forever and without a card. Paid plans: Developer €19 a month (5,000 calls), Startup €49 a month (15,000 calls), Growth €99 a month (50,000 calls). Lookups without a result do not count.

What does a response contain?

The reference, the country, the GPS point (latitud, longitud), the outline (poligono) and the area in m² (superficieParcela), plus the municipality where the source gives it. availableFields says which optional fields each answer really carries.

Can I search by address in Spain?

Yes. /api/search/address/candidates?country=ES geocodes the address with CartoCiudad and returns the parcel under it, ranked by a confidence from 0 to 1.