canonical: https://jentic.com/apis/parcelgps.com/parcelgps

# Parcelgps Catastro GPS API

The Catastro GPS API turns addresses and coordinates into cadastral parcels for Spain and 25 other European countries, returning the parcel reference, its GPS point, outline polygon, and area. It looks up a parcel or unit by cadastral reference, finds the parcel at a WGS84 point, ranks address candidates, and for Spain resolves structured or free-text addresses through the live Catastro street index. Spanish data comes from Parcel GPS's own copy of the Dirección General del Catastro with live Catastro as a fallback, and further operations list every unit of a finca and report a parcel's terrain, protected areas, climate normals, and ground motion in millimetres per year.

## For AI agents

Find the cadastral parcel for an address or a GPS point in Spain and other European countries, look up a parcel by reference, list the units in a building, and read its terrain and ground-motion data.

## Scope

Does not calculate routes, render map tiles, or value properties. Use for cadastral parcel lookups by address, coordinates, or reference in Spain and other European countries only.

## Capabilities

- Resolve an address to ranked parcel candidates in Spain and 25 other European countries through `/api/search/address/candidates`
- Find the parcel at a WGS84 point with lat and lng, or latitude and longitude in a JSON body
- Look up a parcel or unit by cadastral reference with `/api/catastro/{refcat}` and get its outline and area
- List all dwellings, shops, garages, and storage units of a finca by its 14-character reference
- Resolve a Spanish address from provincia, municipio, nombreVia, and numero, or from free text in direccion, against the live Catastro street index
- Read a parcel's relief, protected areas, and climate normals, and its 2020 to 2024 ground motion in mm per year

## Use cases

### Agent property lookups through Jentic

A real-estate assistant agent receives an address from a client and needs the official parcel. Through Jentic it calls searchAddressCandidates with the address, picks the top candidate, and then getParcel for the outline and area, citing the Dirección General del Catastro attribution returned with Spanish data. Your own Jentic One instance injects the X-API-Key value, so the agent never holds it.

Example prompt: GET `/api/search/address/candidates` with country 'ES' and q 'Calle Mayor 10, Madrid', then GET `/api/catastro/{refcat}` for the first candidate and report its superficieParcela

### Field and drone work by coordinates

Surveyors, insurers, and agricultural teams often start from a GPS point rather than an address. GET `/api/search/coordinates` with lat and lng, or the POST form with latitude and longitude, returns the parcel at that point, and the terrain operation adds relief, protected areas, and climate normals for the same reference.

Example prompt: GET `/api/search/coordinates` with lat 39.4699 and lng -0.3763, then GET `/api/catastro/{refcat}/terrain` for the returned reference

### Building units and ground motion checks

Property due diligence needs both what is in a building and whether the ground beneath it moves. GET `/api/catastro/{refcat14}/units` lists every dwelling, shop, garage, and storage unit of a finca with cursor paging, and GET `/api/catastro/{refcat}/ground-motion` reports subsidence or uplift in millimetres per year for 2020 to 2024.

Example prompt: GET `/api/catastro/{refcat14}/units` for reference '9872023VH5797S', then GET `/api/catastro/{refcat}/ground-motion` for the same reference and report the yearly movement

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/api/search/address/candidates` | Address to ranked parcel candidates |
| GET | `/api/search/coordinates` | Parcel at a WGS84 point |
| GET | `/api/catastro/{refcat}` | Parcel or unit by cadastral reference |
| GET | `/api/catastro/{refcat14}/units` | All units of a finca |
| POST | `/api/search/address/parse` | Free-text Spanish address to reference |
| GET | `/api/catastro/{refcat}/ground-motion` | Parcel ground motion 2020 to 2024 |

## Key resources

- **Parcels** — Parcel or unit lookup by cadastral reference, units of a finca, terrain, and ground motion
- **Search** — Address candidates across European countries, coordinate lookups, and Spanish structured and free-text address resolution

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 63 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 99 / 100
  - Developer Experience & Jentic Compatibility: 68 / 100
  - AI-Readiness & Agent Experience: 47 / 100
  - Agent Usability: 94 / 100
  - Security: 50 / 100
  - AI Discoverability: 47 / 100
- **View full report:** https://jentic.com/apis/parcelgps.com/parcelgps/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring Catastro GPS by hand means the X-API-Key header, a unit-based monthly quota with per-key rate limits, and picking between European candidate search and the Spanish live Catastro operations. Through Jentic you install once, import Catastro GPS from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Catastro GPS puts the cadastral reference in the URL path, as in `/api/catastro/{refcat}/terrain`, so a rule can pin your agent to one parcel. You choose which of the nine read and search operations it may call, which also bounds how many units it can spend.
- **Credential handling:** Your Catastro GPS API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'find the parcel at these coordinates' or 'look up a cadastral reference', and Jentic returns the matching Catastro GPS operation with its input schema so the agent sends the right fields.

## Related APIs

- **Regrid Parcel API** — Land parcel data with boundaries and attributes
- **OpenCage Geocoding API** — Forward and reverse geocoding worldwide
- **Mapbox API** — Maps, tiles, and geospatial services

## FAQ

### What authentication does the Catastro GPS API use?

The Catastro GPS API authenticates with an API key sent in the X-API-Key header per its OpenAPI spec; keys are created in the developer portal. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at call time, so it never enters the agent's prompt or logs.

### What are the rate limits for the Catastro GPS API?

The spec sets limits per API key and minute by plan: Free 10, Developer 60, Startup 120, and Growth 300 requests per minute, with monthly quotas of 250, 5,000, 15,000, and 50,000 units. Going over the per-minute limit returns 429 with code KEY_RATE_002 and a Retry-After header.

### Which countries does the Catastro GPS API cover?

Address candidate search covers Spain and 25 other European countries, and every covered country returns the parcel reference, GPS point, outline, and area by reference and by coordinates unless the spec's coverage table says otherwise. The structured and free-text address operations resolve Spanish addresses only, against the live Catastro street index.

### How do I find a parcel from an address through Jentic?

Install Jentic One, add the Catastro GPS API from the Jentic API Directory, and store your API key once. Your agent searches for 'find the cadastral parcel for an address', gets searchAddressCandidates with its input schema, and calls it with country and q. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### Is there a Catastro GPS MCP server?

You don't need an MCP server to give your agent the Catastro GPS API. Jentic connects it directly from the API Directory: import it, store your credential once, and your agent calls it.

### Can I limit what my agent is allowed to do with the Catastro GPS API?

Yes. Write a rule that allows only the address candidates and coordinate search operations, and your agent can locate parcels but cannot spend units on unit listings, terrain, or ground-motion reports. Your own Jentic One instance logs what it called, which helps you track quota use.