---
title: "Free-text Spanish address to reference (Catastro callejero, live)"
method: POST
path: "/api/search/address/parse"
tags: ["Parcels"]
---

# Free-text Spanish address to reference (Catastro callejero, live)

`POST /api/search/address/parse`

## Request

- Base URL: `https://api.parcelgps.com`
- URL: `https://api.parcelgps.com/api/search/address/parse`
- Auth: API key in header `X-API-Key`

Parses the text and asks the Catastro street index live. Prefer `GET /api/search/address/candidates`, which does not depend on the Catastro and returns several candidates.

## Request body

- object
  - `direccion` string, required

## Response `200`

The reference at that address.

- LegacyAddressResponse
  - `success` true, required
  - `data` object, required
    - `referenciaCatastral` string
    - `refCat14` string
    - `direccion` string
    - `provincia` string
    - `municipio` string
    - `tipoVia` string
    - `nombreVia` string
    - `numero` integer
    - `planta` string
    - `puerta` string
    - `codigoPostal` string
  - `searchesRemaining` integer

## Other responses

- `400`: Malformed parameters (code VALIDATION_ERROR).
- `401`: Missing, malformed or unknown API key (KEY_AUTH_001, KEY_AUTH_002, KEY_AUTH_003, UNAUTHORIZED).
- `404`: The reference or address does not exist (code NOT_FOUND). Never used for outages.
- `429`: KEY_AUTH_004: monthly quota used up and no prepaid balance left to cover the request (see X-Quota-*); nothing is charged. The message says the plan, the price per 1,000 extra units, where to top up and when the quota resets. KEY_RATE_002 or RATE_LIMIT_EXCEEDED: per-minute limit, wait Retry-After seconds.

---

[API](https://skmtc.dev/catastrogps/apis/catastro-gps-api.md) · [All operations](https://skmtc.dev/catastrogps/apis/catastro-gps-api/llms.txt) · [OpenAPI document](https://skmtc.dev/catastrogps/apis/catastro-gps-api/revisions/1a86d44aa8ae?raw)