terminal Cadastral API

Portugal cadastral parcel API

Look up any parcel in Portugal by its cadastral reference, by coordinates or by address and get its GPS point, outline and area as JSON. The data comes from the predial cadastre of the Direção-Geral do Território (DGT). 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 Portugal

Parcel by cadastral reference the digital predial cadastre is partial and does not cover Lisbon, Porto or Coimbra	Partial
Parcel by coordinates (lat, lng)	Yes
Outline and area the digital predial cadastre is partial and does not cover Lisbon, Porto or Coimbra	Partial
Address to parcel the digital predial cadastre is partial and does not cover Lisbon, Porto or Coimbra	Partial
Building: use, built area, year, dwellings, floors	No
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 Portugal

The API takes the DGT cadastral parcel identifier (for example AAA000025300). You can also start from a point with /api/search/coordinates or from an address with /api/search/address/candidates?country=PT.

Example with a real response

Lookup by reference (AAA000025300). Response measured against production on 1 October 2026 and trimmed: the outline has 42 vertices and two are shown.

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

{
  "success": true,
  "data": {
    "refCatastral": "AAA000025300",
    "pais": "PT",
    "municipio": "CADAVAL, Lamas e Cercal",
    "provincia": "CADAVAL, Lamas e Cercal",
    "latitud": 39.215402,
    "longitud": -9.08081,
    "googleMapsUrl": "https://www.google.com/maps?q=39.215402,-9.080810",
    "superficieParcela": 3302,
    "poligono": [
      [39.21452, -9.079979],
      [39.214494, -9.080091]
    ]
  }
}

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/AAA000025300/terrain?country=PT&lat=39.215402&lng=-9.08081"

curl -H "X-API-Key: $CATASTROGPS_API_KEY" \
  "https://api.parcelgps.com/api/catastro/AAA000025300/ground-motion?country=PT&lat=39.215402&lng=-9.08081"

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 Portugal 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 Portugal

Real estate agencies and portals

Outline and area of each listing from 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 Portugal?

The official data is published by the predial cadastre of the Direção-Geral do Território (DGT), 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 Portugal?

With the DGT cadastral parcel identifier (for example AAA000025300). 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 Portugal?

Partly. /api/search/address/candidates?country=PT geocodes with OpenStreetMap; the digital predial cadastre is partial and does not cover Lisbon, Porto or Coimbra.