---
title: "Buscar normativas"
method: GET
path: "/api/v1/codes/search"
tags: ["codes-v1"]
---

# Buscar normativas

`GET /api/v1/codes/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/codes/search`
- Auth: HTTP bearer

Búsqueda paginada de colecciones normativas por título, ámbito o etiqueta. Devuelve las normativas coincidentes con metadatos de paginación.

## Query parameters

- `q` string, nullable: Búsqueda parcial por título
- `normative_scope` string, nullable: Filtra por ámbito: national | regional | municipal
- `tag` string, nullable: Filtra por etiqueta
- `page` integer: Número de página (base 1)
- `page_size` integer: Resultados por página (máximo 50)

## Response `200`

Successful Response

- PaginatedCodesResponse
  - `items` CodeSummary[], required: Normativas de esta página
    - `slug` string, required: Slug identificador único de la normativa
    - `title` string, required: Título completo de la normativa
    - `short_title` string, nullable: Título corto para presentación
    - `normative_scope` string, required: Ámbito normativo: national | regional | municipal
    - `tags` string[], nullable: Etiquetas de categorización
  - `total` integer, required: Total de normativas que coinciden con el filtro
  - `page` integer, required: Página actual (empieza en 1)
  - `page_size` integer, required: Número de resultados por página
  - `total_pages` integer, required: Número total de páginas

## 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)