# Vextorium Catastro Spanish Property Lookup

> Vextorium Catastro Spanish Property Lookup is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-10).

Returns public cadastral data for a Spanish property by its cadastral reference, including address, use, built area, year built, plot area, construction units, and a map link.

## Facts

- Endpoint: POST https://api.vextorium.com/catastro-inmueble-pago?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-catastro-spanish-property-lookup-66c7745d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LUraLCZgwcE9RL5SBDCx4

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 vextorium-catastro-spanish-property-lookup-66c7745d -d '<json body>'
```

Example prompt: Can you pull the cadastral data for the Spanish property with reference 9872023VH5797S0001WX? I need the address, built area, plot area, year of construction, and a link to the map.

## When to prefer this

Use this endpoint when you need official public cadastral data for a specific Spanish property and have the cadastral reference (referencia catastral) available. It is ideal for real estate due diligence, property verification, urban planning research, or enriching property databases with official government data. It does not return owner identity data, so if ownership information is needed, a different source must be consulted.

## Known failure modes

- Invalid or malformed cadastral reference (not 14 or 20 characters) — API returns an error or null response
- Property reference not found in the Catastro database — response may return null fields or an error
- Catastro upstream service unavailable — request may time out or return an error
- Reference corresponds to a protected or restricted record — some fields may be null

## How this service works

Public data of a Spanish property from the Catastro by cadastral reference: address, use, built area, year built, ownership share coefficient, plot type and area, building units and map link. No owner data (protected).

## Output

Returns a JSON object with the property's full cadastral details: normalized address, municipality, province, postal code, use classification (e.g. Residencial), class (urban/rustic), plot type, participation coefficient percentage, total built area in m², plot area in m², year of construction, an array of construction units (each with use, floor/planta, and area), and a link to the Catastro cartography map. Owner identity data is not included as it is legally protected.

## 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": [
      "referencia"
     ],
     "properties": {
      "referencia": {
       "type": "string",
       "description": "14 or 20-character cadastral reference"
      }
     }
    },
    "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": {
      "uso": {
       "type": [
        "string",
        "null"
       ]
      },
      "clase": {
       "type": [
        "string",
        "null"
       ]
      },
      "fuente": {
       "type": [
        "string",
        "null"
       ]
      },
      "direccion": {
       "type": [
        "string",
        "null"
       ]
      },
      "municipio": {
       "type": [
        "string",
        "null"
       ]
      },
      "provincia": {
       "type": [
        "string",
        "null"
       ]
      },
      "referencia": {
       "type": [
        "string",
        "null"
       ]
      },
      "tipo_finca": {
       "type": [
        "string",
        "null"
       ]
      },
      "cartografia": {
       "type": [
        "string",
        "null"
       ]
      },
      "codigo_postal": {
       "type": [
        "string",
        "null"
       ]
      },
      "anio_construccion": {
       "type": [
        "number",
        "null"
       ]
      },
      "superficie_parcela_m2": {
       "type": [
        "number",
        "null"
       ]
      },
      "unidades_constructivas": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "uso": {
          "type": [
           "null",
           "string"
          ]
         },
         "planta": {
          "type": [
           "null",
           "string"
          ]
         },
         "superfic
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "uso": "Residencial",
  "clase": "urbano",
  "fuente": "Dirección General del Catastro (datos no protegidos)",
  "direccion": "CL GLORIA 51 13730 SANTA CRUZ DE MUDELA (CIUDAD REAL)",
  "municipio": "SANTA CRUZ DE MUDELA",
  "provincia": "CIUDAD REAL",
  "referencia": "9872023VH5797S0001WX",
  "tipo_finca": "Parcela construida sin división horizontal",
  "cartografia": "https://www1.sedecatastro.gob.es/Cartografia/mapa.aspx?del=13&mun=77&refcat=9872023VH5797S",
  "codigo_postal": "13730",
  "anio_construccion": 1980,
  "superficie_parcela_m2": 397,
  "unidades_constructivas": [
   {
    "uso": "VIVIENDA",
    "planta": "00",
    "superficie_m2": 109
   },
   {
    "uso": "ALMACEN",
    "planta": "00",
    "superficie_m2": 187
   },
   {
    "uso": "OTROS USOS",
    "planta": "00",
    "superficie_m2": 12
   }
  ],
  "superficie_construida_m2": 308,
  "coeficiente_participacion_pct": 100
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-catastro-spanish-property-lookup-66c7745d/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)