> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CNBV

> Normativa bancaria y bursátil de la CNBV, incluida la Circular Única de Bancos y su historial completo de modificaciones.

El catálogo normativo de la Comisión Nacional Bancaria y de Valores: \~113 normas
(leyes, disposiciones de carácter general, circulares, acuerdos, reglas), cada
una con los sectores a los que aplica y su texto oficial. Solo la Circular Única
de Bancos acumula 180+ modificaciones, disponibles en el endpoint de historial.

## Normativa

`POST /mx/cnbv/regulations/v1`

| Campo   | Tipo    | Notas                                                                       |
| ------- | ------- | --------------------------------------------------------------------------- |
| `query` | string  | Filtro opcional por nombre. Subcadena sin distinguir mayúsculas ni acentos. |
| `page`  | integer | Número de página (base 1). 50 por página.                                   |

```bash theme={"dark"}
curl https://api.croma.run/mx/cnbv/regulations/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "instituciones de crédito" }'
```

Devuelve `regulations` y `pagination` (`total`, `page`, `page_size`,
`total_pages`).

| Campo           | Notas                                                                                      |
| --------------- | ------------------------------------------------------------------------------------------ |
| `regulation_id` | Identificador para el endpoint de historial; null cuando la norma no tiene modificaciones. |
| `name`          | Nombre completo de la norma.                                                               |
| `type`          | P. ej. `Ley`, `Acuerdo`, `Circular`, `Disposiciones de carácter general`.                  |
| `dof_date`      | Fecha de publicación en el DOF (`yyyy-mm-dd`); null cuando no aplica.                      |
| `sectors`       | Sectores financieros a los que aplica (p. ej. `Sector Bancario`).                          |
| `pdf_url`       | Texto oficial.                                                                             |

## Historial de modificaciones

`POST /mx/cnbv/regulation-history/v1`

| Campo           | Tipo   | Notas                                                      |
| --------------- | ------ | ---------------------------------------------------------- |
| `regulation_id` | string | **Obligatorio.** El `regulation_id` del catálogo anterior. |

```bash theme={"dark"}
curl https://api.croma.run/mx/cnbv/regulation-history/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "regulation_id": "1024" }'
```

Devuelve `found`, `regulation_id`, `modifications` y `annexes`. Cada
modificación trae `description`, `dof_date`, `pdf_url` y `order`; los anexos
traen `description`, `pdf_url` y `order`.

<Note>
  Solo las normas con `regulation_id` no nulo tienen historial. Las normas
  publicadas una vez y nunca modificadas devuelven `found: false`.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, campos de respuesta y un playground interactivo.
</Card>