---
title: "Buscar localización"
method: GET
path: "/api/v1/location/search"
tags: ["location-v1"]
---

# Buscar localización

`GET /api/v1/location/search`

## Request

- Base URL: `https://docs.normatia.com` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.normatia.com/api/v1/location/search`
- Auth: HTTP bearer

Busca en todos los niveles geográficos (país, comunidad autónoma, provincia, municipio) por nombre. La búsqueda es insensible a mayúsculas y tildes. Devuelve un máximo de 50 resultados.

## Query parameters

- `q` string, required: Texto de búsqueda (insensible a mayúsculas y tildes)
- `level` string, nullable: Filtra por nivel: country | region | province | municipality
- `ancestor_id` string, nullable: Filtra por ID de geografía ancestro (ej. 'ES-41' para la provincia de Sevilla)

## Response `200`

Successful Response

- LocationSearchResponse
  - `results` LocationSearchResult[], required: Lista de localizaciones encontradas (máximo 50)
    - `geo_id` string, required: Identificador geográfico semántico (p.ej. 'ES-41091')
    - `name` string, required: Nombre de la localización
    - `level` string, required: Nivel geográfico: country | region | province | municipality

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/normatia/apis/normatia-api.md) · [All operations](https://skmtc.dev/normatia/apis/normatia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/normatia/apis/normatia-api/revisions/8a8c57d4441a?raw)