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

> Normas bancárias e do mercado de valores da CNBV, incluindo a Circular Única de Bancos e seu histórico completo de modificações.

O catálogo normativo da Comisión Nacional Bancaria y de Valores: \~113 normas
(leis, disposições de caráter geral, circulares, acordos, regras), cada uma
com os setores aos quais se aplica e seu texto oficial. Só a Circular Única
de Bancos acumula 180+ modificações, disponíveis no endpoint de histórico.

## Normativa

`POST /mx/cnbv/regulations/v1`

| Campo   | Tipo    | Notas                                                                      |
| ------- | ------- | -------------------------------------------------------------------------- |
| `query` | string  | Filtro opcional por nome. Substring sem distinguir maiúsculas nem acentos. |
| `page`  | integer | Número da 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" }'
```

Retorna `regulations` e `pagination` (`total`, `page`, `page_size`,
`total_pages`).

| Campo           | Notas                                                                                 |
| --------------- | ------------------------------------------------------------------------------------- |
| `regulation_id` | Identificador para o endpoint de histórico; null quando a norma não tem modificações. |
| `name`          | Nome completo da norma.                                                               |
| `type`          | P. ex. `Ley`, `Acuerdo`, `Circular`, `Disposiciones de carácter general`.             |
| `dof_date`      | Data de publicação no DOF (`yyyy-mm-dd`); null quando não se aplica.                  |
| `sectors`       | Setores financeiros aos quais se aplica (p. ex. `Sector Bancario`).                   |
| `pdf_url`       | Texto oficial.                                                                        |

## Histórico de modificações

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

| Campo           | Tipo   | Notas                                                    |
| --------------- | ------ | -------------------------------------------------------- |
| `regulation_id` | string | **Obrigatório.** O `regulation_id` do 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" }'
```

Retorna `found`, `regulation_id`, `modifications` e `annexes`. Cada
modificação traz `description`, `dof_date`, `pdf_url` e `order`; os anexos
trazem `description`, `pdf_url` e `order`.

<Note>
  Só as normas com `regulation_id` não nulo têm histórico. As normas
  publicadas uma vez e nunca modificadas retornam `found: false`.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, campos de resposta e um playground interativo.
</Card>