# Vextorium Spain Reverse Geocode

> Vextorium Spain Reverse Geocode 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-19).

Converts latitude/longitude coordinates to a full Spanish address including municipality, province, postal code, and cadastral reference using CartoCiudad data.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/spain-reverse-geocode?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-spain-reverse-geocode-5e934b49
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mIEUXVjW5oI_i5P19_8wN

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-spain-reverse-geocode-5e934b49 -d '<json body>'
```

Example prompt: What address is at coordinates 40.41652 latitude and -3.70378 longitude in Spain? I need the full address including street, municipality, province, postal code, and cadastral reference.

## When to prefer this

Choose this endpoint when you need reverse geocoding specifically within Spain and require official Spanish administrative data including INE codes, autonomous community, and cadastral references — data not available from generic global geocoding services. Ideal for compliance, real estate, logistics, or government-adjacent workflows operating in Spain.

## Known failure modes

- Coordinates outside Spain return null or error — endpoint is Spain-only
- Coordinates in unpopulated or rural areas may return null address fields
- Invalid lat/lon values (out of range, wrong type) cause validation errors
- Coordinates in maritime or border zones may produce incomplete results
- Missing required lat or lon fields in request body returns 400 error

## How this service works

Nearest address to coordinates in Spain with the official CartoCiudad reverse geocoder (IGN): street and number, postcode, municipality, INE code, province, region and cadastral reference.

## Output

A JSON object containing the resolved Spanish address fields: latitude, longitude, address type (e.g. 'portal'), street name, street number, municipality, province, autonomous community, postal code, INE municipal code, cadastral reference, and the CartoCiudad data source attribution.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "number"
  },
  "lon": {
   "type": "number"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "lat": 40.41652681555059,
  "lon": -3.703787669080751,
  "type": "portal",
  "number": 7,
  "source": "CartoCiudad (IGN/CNIG, CC BY 4.0)",
  "address": "PUERTA DEL SOL",
  "ine_code": "28079",
  "province": "Madrid",
  "community": "Comunidad de Madrid",
  "postal_code": "28012",
  "municipality": "Madrid",
  "cadastral_reference": "0444101VK4704C"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-spain-reverse-geocode-5e934b49/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)