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

> The CNBV's banking and securities regulations, including the Circular Única de Bancos and its full modification history.

The Comisión Nacional Bancaria y de Valores regulatory catalog: \~113 normas
(leyes, disposiciones de carácter general, circulares, acuerdos, reglas),
each with the sectors it applies to and the official text. The Circular Única de
Bancos alone carries 180+ modifications, available through the history endpoint.

## Regulations

`POST /mx/cnbv/regulations/v1`

| Field   | Type    | Notes                                                         |
| ------- | ------- | ------------------------------------------------------------- |
| `query` | string  | Optional name filter. Case- and accent-insensitive substring. |
| `page`  | integer | 1-based page number. 50 per page.                             |

```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" }'
```

Returns `regulations` and `pagination` (`total`, `page`, `page_size`,
`total_pages`).

| Field           | Notes                                                                                |
| --------------- | ------------------------------------------------------------------------------------ |
| `regulation_id` | Identifier for the history endpoint; null when the norm has no modification history. |
| `name`          | Full name of the norma.                                                              |
| `type`          | E.g. `Ley`, `Acuerdo`, `Circular`, `Disposiciones de carácter general`.              |
| `dof_date`      | DOF publication date (`yyyy-mm-dd`); null when not applicable.                       |
| `sectors`       | Financial sectors the norm applies to (e.g. `Sector Bancario`).                      |
| `pdf_url`       | Official text.                                                                       |

## Modification history

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

| Field           | Type   | Notes                                                     |
| --------------- | ------ | --------------------------------------------------------- |
| `regulation_id` | string | **Required.** The `regulation_id` from the catalog above. |

```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" }'
```

Returns `found`, `regulation_id`, `modifications`, and `annexes`. Each
modification has `description`, `dof_date`, `pdf_url`, and `order`; annexes
carry `description`, `pdf_url`, and `order`.

<Note>
  Only norms with a non-null `regulation_id` have a history. Norms published
  once and never amended return `found: false`.
</Note>

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, response fields, and an interactive playground.
</Card>