# Comprobar referencia catastral

Consulta una referencia catastral en el Catastro y comprueba a qué inmueble corresponde: dirección, uso, superficie construida, año de construcción y coordenadas. Datos oficiales y públicos, sin certificado digital.

- Página: https://herramient.as/comprobar-referencia-catastral
- Categoría: Validación
- Dónde se ejecuta: en nuestro servidor

Es una herramienta interactiva: se usa desde el navegador en https://herramient.as/comprobar-referencia-catastral.

## Uso por API

También se puede usar por API REST, con una clave en la cabecera `Authorization: Bearer htas_...`. Referencia completa: https://herramient.as/api-docs.md

### `POST /api/v1/tools/catastral/lookup`

Consulta una referencia catastral en el Catastro

Resuelve una referencia catastral contra los servicios web libres de la Dirección General del Catastro y devuelve los datos no protegidos del inmueble: dirección, uso, superficie construida, año de construcción, el desglose de construcciones y las coordenadas de la parcela. Añade además la superficie de la parcela, lo edificado sobre ella y el plano catastral, tomados de los servicios INSPIRE; esas tres superficies miden cosas distintas y no deben sumarse. No se consultan datos de titularidad, que requieren certificado digital. Admite la referencia completa de 20 caracteres y la parcela de 14. Si los caracteres de control no cuadran, el Catastro lo indica y la respuesta llega con found a false.

Consume 5 unidades de cuota.

**Parámetros**

| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `reference` | string | sí | Referencia catastral de 20 caracteres, o parcela de 14. Se admiten espacios (Ejemplo: `9872023VH5797S0001WX`) |

**Respuesta**

| Nombre | Tipo | Descripción |
|---|---|---|
| `found` | boolean | Si el Catastro ha resuelto la referencia |
| `reference` | string | La referencia completa de 20 caracteres tal y como la devuelve el Catastro |
| `nature` | string | Urbana o rústica, según el Catastro |
| `address` | string | Localización completa del inmueble |
| `province` | string | Provincia |
| `municipality` | string | Municipio |
| `postal_code` | string | Código postal |
| `use` | string | Uso principal, por ejemplo Residencial o Agrario |
| `built_area_m2` | integer | Superficie construida del inmueble, en metros cuadrados |
| `year_built` | integer | Año de construcción, null si el Catastro no lo recoge |
| `participation_coefficient` | number | Coeficiente de participación en la finca |
| `constructions` | array | Desglose por unidad: use, block, floor, door y area_m2 |
| `plot_area_m2` | integer | Superficie de la parcela en metros cuadrados, según la cartografía INSPIRE. No es la del inmueble |
| `built_on_plot_m2` | integer | Suma de la superficie construida de todos los edificios de la parcela. En un piso es mucho mayor que built_area_m2 |
| `buildings_count` | integer | Número de edificios levantados sobre la parcela |
| `dwellings` | integer | Número de viviendas en la parcela |
| `plan` | object | Plano catastral: url del PNG, width, height, bbox (min_lon, min_lat, max_lon, max_lat) y outline con el contorno de la parcela en pares [lat, lon] |
| `coordinates` | object | lat, lon y srs del centroide de la parcela. null si el Catastro no las sirve |
| `catastro_url` | string | Enlace a la ficha oficial en la Sede Electrónica del Catastro |
| `cartography_url` | string | Enlace a la parcela en la cartografía catastral oficial |
| `message` | string | Mensaje legible del resultado |

**Errores**

- `400`: La referencia catastral está vacía
- `503`: El servicio del Catastro no está disponible

```bash
curl -X POST https://herramient.as/api/v1/tools/catastral/lookup \
  -H "Authorization: Bearer htas_tu_clave_api" \
  -H "Content-Type: application/json" \
  -d '{"reference":"9872023VH5797S0001WX"}'
```

### `POST /api/v1/tools/catastral/search`

Busca la referencia catastral a partir de una dirección

El camino inverso: de dirección a referencia catastral. Un número de calle suele agrupar muchos inmuebles, así que la respuesta habitual es una lista en properties con la referencia y la planta y puerta de cada uno; eso no es un error. Añadiendo planta y puerta la respuesta se concreta en un solo inmueble, con found a true y todos sus datos. Los nombres de provincia, municipio y calle tienen que coincidir con la grafía del Catastro: el endpoint libre no permite listar su callejero, así que cuando algo no cuadra devolvemos el motivo exacto del Catastro en catastro_error.

Consume 5 unidades de cuota.

**Parámetros**

| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `province` | string | sí | Provincia, en la grafía del Catastro (Ejemplo: `MADRID`) |
| `municipality` | string | sí | Municipio (Ejemplo: `MADRID`) |
| `street_type` | string | no | Sigla de la vía: CL, AV, PZ, CR... (Ejemplo: `CL`) |
| `street` | string | sí | Nombre de la vía, sin la sigla (Ejemplo: `ARTURO SORIA`) |
| `number` | string | sí | Número de policía (Ejemplo: `100`) |
| `block` | string | no | Bloque (Ejemplo: ``) |
| `stairway` | string | no | Escalera (Ejemplo: ``) |
| `floor` | string | no | Planta. Acota la búsqueda a un inmueble (Ejemplo: `01`) |
| `door` | string | no | Puerta. Acota la búsqueda a un inmueble (Ejemplo: `A`) |

**Respuesta**

| Nombre | Tipo | Descripción |
|---|---|---|
| `found` | boolean | true solo cuando la dirección identifica un único inmueble |
| `properties` | array | Cuando la dirección agrupa varios inmuebles: reference y address de cada uno |
| `reference` | string | La referencia completa de 20 caracteres, si hay un único inmueble |
| `address` | string | Localización completa, con planta y puerta |
| `built_area_m2` | integer | Superficie construida en metros cuadrados |
| `year_built` | integer | Año de construcción |
| `use` | string | Uso principal |
| `coordinates` | object | lat, lon y srs del centroide de la parcela |
| `catastro_url` | string | Enlace a la ficha oficial en la Sede Electrónica |
| `cartography_url` | string | Enlace a la parcela en la cartografía catastral oficial |
| `catastro_error` | object | code y description del Catastro cuando rechaza la dirección |
| `message` | string | Mensaje legible del resultado |

**Errores**

- `400`: Faltan provincia, municipio, calle o número
- `503`: El servicio del Catastro no está disponible

```bash
curl -X POST https://herramient.as/api/v1/tools/catastral/search \
  -H "Authorization: Bearer htas_tu_clave_api" \
  -H "Content-Type: application/json" \
  -d '{"province":"MADRID","municipality":"MADRID","street_type":"CL","street":"ARTURO SORIA","number":"100","block":"","stairway":"","floor":"01","door":"A"}'
```

### `GET /api/v1/tools/catastral/municipios`

Lista los municipios de una provincia con la grafía del Catastro

Pensado para montar un selector antes de llamar a /catastral/search. Los nombres son los que usa el Catastro, que no siempre coinciden con los del INE. Devuelve una lista vacía para Álava, Gipuzkoa, Bizkaia y Navarra, que tienen catastro foral propio y no están en este servicio.

Consume 1 unidad de cuota.

**Parámetros**

| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `province` | string | sí | Provincia, en la grafía del Catastro (Ejemplo: `MADRID`) |

**Respuesta**

| Nombre | Tipo | Descripción |
|---|---|---|
| `municipalities` | array | Nombres de municipio, alfabéticamente |

```bash
curl -X GET https://herramient.as/api/v1/tools/catastral/municipios \
  -H "Authorization: Bearer htas_tu_clave_api"
```

### `GET /api/v1/tools/catastral/vias`

Busca vías de un municipio con la grafía del Catastro

El Catastro guarda los nombres de vía normalizados, sin tildes y a veces con el orden invertido, de modo que no se pueden deducir del nombre de la placa. Este endpoint los devuelve tal cual, para usarlos en el parámetro street de /catastral/search. Hacen falta al menos 3 caracteres en q y se devuelven como máximo 50 resultados.

Consume 1 unidad de cuota.

**Parámetros**

| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `province` | string | sí | Provincia (Ejemplo: `MADRID`) |
| `municipality` | string | sí | Municipio (Ejemplo: `MADRID`) |
| `q` | string | sí | Parte del nombre de la vía, mínimo 3 caracteres (Ejemplo: `ALCAL`) |

**Respuesta**

| Nombre | Tipo | Descripción |
|---|---|---|
| `streets` | array | street_type (sigla), name (el valor para search) y label (legible) |

```bash
curl -X GET https://herramient.as/api/v1/tools/catastral/vias \
  -H "Authorization: Bearer htas_tu_clave_api"
```

### `GET /api/v1/tools/catastral/plano`

Devuelve el plano catastral de una parcela en PNG

Responde con una imagen PNG, no con JSON: es la cartografía catastral oficial recortada sobre la parcela de la referencia. Hacemos de intermediarios porque el servicio WMS del Catastro no envía cabeceras CORS y porque el encuadre hay que calcularlo a partir de la geometría de la parcela. La atribución a la Dirección General del Catastro va impresa en la propia imagen. Devuelve 404 cuando la parcela no tiene cartografía, lo que incluye Álava, Gipuzkoa, Bizkaia y Navarra. Para situar el plano o dibujar encima, el bbox y el contorno vienen en el campo plan de /catastral/lookup.

Consume 5 unidades de cuota.

**Parámetros**

| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `reference` | string | sí | Referencia catastral de 20 caracteres, o parcela de 14 (Ejemplo: `9872023VH5797S0001WX`) |
| `tamano` | string | no | Tamaño de la imagen: card (640x420) o wide (1024x420). Por defecto card (Ejemplo: `card`) |

**Respuesta**

| Nombre | Tipo | Descripción |
|---|---|---|
| `(binario)` | string | La imagen PNG. El Content-Type es image/png |

**Errores**

- `404`: La parcela no tiene cartografía disponible

```bash
curl -X GET https://herramient.as/api/v1/tools/catastral/plano \
  -H "Authorization: Bearer htas_tu_clave_api"
```

## Para entenderlo

- [Fondos buitre, empresas y particulares: de quién es la vivienda en España](https://herramient.as/articulos/quien-es-dueno-vivienda-espana-octubre-2026): Los fondos buitre salen en casi todas las conversaciones sobre vivienda, pero ¿cuántas casas tienen de verdad? Quién es dueño del parque, quién del alquiler y qué cambia en Madrid y Barcelona, con los datos oficiales en la mano.

## Preguntas frecuentes

### ¿Qué es la referencia catastral y dónde la encuentro?

Es el identificador oficial y único de cada inmueble en España: 20 caracteres que asigna la Dirección General del Catastro y que no cambian aunque el inmueble se venda. La encuentras en el recibo del IBI, en la escritura de compraventa, en la nota simple del Registro de la Propiedad y en los contratos de suministro de luz y agua.

### ¿Cómo se lee una referencia catastral?

En una referencia urbana, los siete primeros caracteres identifican la finca o parcela, los siete siguientes la hoja del plano donde está, los cuatro siguientes son el número de orden del inmueble dentro de la finca y los dos últimos son caracteres de control. En una referencia rústica, los cinco primeros dígitos son la provincia y el municipio, después viene el sector, el polígono y el número de parcela. Si solo tienes los 14 primeros caracteres también puedes consultarla aquí: esa es la parcela.

### ¿Comprobáis los caracteres de control vosotros?

No los calculamos nosotros. Enviamos la referencia al Catastro y es el Catastro el que responde si está bien formada y a qué inmueble corresponde. Lo hacemos así a propósito: el algoritmo exacto de los dos caracteres de control no está publicado oficialmente, y una herramienta que rechazara por error una referencia real sería peor que no tener herramienta. Preguntando a la fuente, el resultado es el oficial.

### ¿Qué datos me vais a mostrar?

Los datos catastrales no protegidos: la localización completa, el municipio y la provincia, el código postal, el uso principal, la superficie construida, el año de construcción, el coeficiente de participación y el desglose de construcciones por planta y puerta. También la superficie de la parcela, lo que hay construido en ella, el plano catastral oficial con tu parcela marcada y las coordenadas para verla en un mapa.

### ¿Por qué me salen varias superficies distintas y cuál es la mía?

Porque miden cosas diferentes y conviene no confundirlas. La «superficie construida» es la de tu inmueble, es decir tu piso o tu casa. La «superficie de la parcela» es la del solar entero, que en un edificio de vecinos compartes con todos los demás. Y «construido en la parcela» suma todo lo edificado sobre ese solar, así que en un piso será mucho mayor que lo tuyo. La que te interesa para comparar con otra vivienda es la superficie construida.

### ¿La superficie del Catastro es la misma que anuncian los pisos?

Casi nunca, y es la causa más habitual de sorpresas. Los anuncios suelen dar la superficie útil, que es la pisable por dentro, mientras que el Catastro publica la construida, que incluye el grosor de los muros y la parte proporcional de los elementos comunes. La útil sale normalmente entre un 10 % y un 25 % menor que la construida. Si el anuncio da más metros que el Catastro, pregunta qué está contando: puede haber una terraza cerrada, un altillo sin declarar o simplemente un redondeo generoso.

### ¿De dónde sale el plano y puedo usarlo en un documento?

Es la cartografía catastral oficial de la Dirección General del Catastro, pedida en directo a su servicio de mapas y recortada sobre tu parcela, que marcamos en azul. La atribución va impresa en la propia imagen, así que puedes reutilizarla citando la fuente, tal y como permiten las condiciones de reutilización del Catastro. No es un documento con validez jurídica: para eso necesitas una certificación catastral descriptiva y gráfica, que se pide en la Sede Electrónica.

### ¿Funciona en el País Vasco y Navarra?

La consulta no, y no es un fallo nuestro. Álava, Gipuzkoa, Bizkaia y Navarra tienen catastro propio por su régimen foral y sus datos no están en los servicios de la Dirección General del Catastro, así que ni la ficha ni el plano aparecerán. Tienes que consultarlos en la Diputación Foral correspondiente o, en Navarra, en la Hacienda Tributaria de Navarra.

### ¿Puedo ver quién es el propietario?

No. La titularidad es un dato protegido y solo se consulta en la Sede Electrónica del Catastro identificándote con certificado digital, Cl@ve o DNI electrónico, y únicamente si eres el titular o acreditas un interés legítimo. Aquí no se muestra ningún dato personal, ni nosotros tenemos acceso a él.

### ¿Para qué me sirve la referencia catastral al comprar una vivienda?

Para dos cosas importantes. La primera es comprobar que el inmueble que te están vendiendo es el que crees: que la superficie, la planta y la puerta coinciden con lo que has visto. La segunda es el valor de referencia del Catastro, que desde 2022 es la base sobre la que se calcula el Impuesto de Transmisiones Patrimoniales cuando supera el precio declarado en la escritura. Sin la referencia catastral no puedes consultar ese valor.

### ¿Es gratis y hace falta registrarse?

Es gratis y no hace falta registrarse ni dar ningún dato. Los servicios web del Catastro para datos no protegidos son públicos y abiertos, así que la consulta sale directamente de la fuente oficial sin coste alguno.

## Herramientas relacionadas

- [Gastos de compraventa de vivienda](https://herramient.as/gastos-compraventa-vivienda): Calcula cuánto efectivo necesitas de verdad para comprar una casa: entrada, impuestos y gastos de notaría y registro, con el arancel oficial y los tipos de tu comunidad. Separa lo que pagas tú de lo que paga el banco.
- [Calculadora de ITP](https://herramient.as/calculadora-itp): Cuánto ITP pagas al comprar una vivienda de segunda mano, con el tipo de tu comunidad, los tipos reducidos que podrían aplicarte y la base correcta: el mayor entre precio y valor de referencia del Catastro.
- [Comprobar CIF de empresa](https://herramient.as/comprobar-cif): Comprueba si el CIF de una empresa es válido y descubre qué tipo de entidad es. Validamos el carácter de control con el algoritmo oficial.
- [Borradores de contrato](https://herramient.as/contratos-borradores): Genera borradores de oferta de compra y de encargo de venta con la plantilla de tu inmobiliaria, con avisos de lo que falta o no cuadra.