# Catastro Coordinates to Parcel Reference (Spain)

> Catastro Coordinates to Parcel Reference (Spain) is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-13).

Returns the Spanish cadastral parcel reference and postal address for a given latitude/longitude coordinate pair, using official Dirección General del Catastro data.

## Facts

- Endpoint: POST https://api.vextorium.com/catastro-coordenadas-pago?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/catastro-coordinates-to-parcel-reference-spain-9d8dbf1a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZKTBfjd0jJ9F5bbPQLTuH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability catastro-coordinates-to-parcel-reference-spain-9d8dbf1a -d '<json body>'
```

Example prompt: What is the Spanish cadastral parcel reference and address for the coordinates 40.453 latitude, -3.6883 longitude in Madrid?

## When to prefer this

Use this endpoint when you have GPS coordinates inside Spain and need the official cadastral parcel reference (referencia catastral) and address from the authoritative Spanish government source. It is the necessary first step before querying detailed property data via the catastro-inmueble endpoint. Prefer this over generic reverse geocoding services when you need the legally recognized Spanish parcel identifier rather than just a street address.

## Known failure modes

- Coordinates outside Spain return no result or an error
- Sea or uninhabited coordinates may not resolve to any parcel
- Slight GPS imprecision may resolve to a neighboring parcel
- Service unavailability from upstream Catastro API causes failure
- Invalid or non-numeric lat/lon values cause validation errors

## How this service works

Cadastral parcel reference and address at given coordinates in Spain, to then query its data with catastro-inmueble. Official Catastro data.

## Output

Returns the input coordinates echoed back, the full postal address of the property at that location (e.g. 'AV CONCHA ESPINA 1 MADRID (MADRID)'), the cadastral parcel reference string (referencia_parcela, e.g. '1784401VK4718D'), and the data source name (Dirección General del Catastro).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number"
      },
      "lon": {
       "type": "number"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "lat": {
       "type": [
        "number",
        "null"
       ]
      },
      "lon": {
       "type": [
        "number",
        "null"
       ]
      },
      "fuente": {
       "type": [
        "string",
        "null"
       ]
      },
      "direccion": {
       "type": [
        "string",
        "null"
       ]
      },
      "referencia_parcela": {
       "type": [
        "string",
        "null"
       ]
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "lat": 40.453,
  "lon": -3.6883,
  "fuente": "Dirección General del Catastro",
  "direccion": "AV CONCHA ESPINA 1 MADRID (MADRID)",
  "referencia_parcela": "1784401VK4718D"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/catastro-coordinates-to-parcel-reference-spain-9d8dbf1a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)