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

# Banxico

> Todas las circulares y disposiciones del Banco de México desde 1969, con estado de abrogación y texto consolidado.

El índice cronológico de circulares y disposiciones del Banco de México: 1,200+
entradas desde 1969, cada una con su asunto, si sigue vigente y qué circular
base modifica. Lista por año y luego abre una para ver su texto consolidado y su
cadena de modificaciones.

## Circulares

`POST /mx/banxico/circulars/v1`

| Campo  | Tipo    | Notas                                                           |
| ------ | ------- | --------------------------------------------------------------- |
| `year` | string  | Año de 4 dígitos, opcional. Omítelo para listar todos los años. |
| `page` | integer | Número de página (base 1). 100 por página.                      |

```bash theme={"dark"}
curl https://api.croma.run/mx/banxico/circulars/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "year": "2026" }'
```

Devuelve `year` (eco del filtro, null cuando se listan todos los años),
`circulars` y `pagination`.

| Campo        | Notas                                                                       |
| ------------ | --------------------------------------------------------------------------- |
| `number`     | Número de circular tal como aparece, p. ej. `11/2026`, `E-126/2013`, `S/N`. |
| `year`       | Año de emisión.                                                             |
| `subject`    | Asunto que cubre la circular.                                               |
| `modifies`   | Número de la circular base cuando esta la modifica; si no, null.            |
| `abrogated`  | `true` cuando ya no está vigente.                                           |
| `has_detail` | Si esta entrada enlaza a un registro completo.                              |

Una fila por entrada del índice, así que una circular que modifica varias
circulares base aparece una vez por cada base.

## Una circular

`POST /mx/banxico/circular/v1`

| Campo    | Tipo   | Notas                                                                                             |
| -------- | ------ | ------------------------------------------------------------------------------------------------- |
| `number` | string | **Obligatorio.** Número de circular tal como se lista (p. ej. `3/2012`). No distingue mayúsculas. |

```bash theme={"dark"}
curl https://api.croma.run/mx/banxico/circular/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "number": "3/2012" }'
```

Devuelve `found`, `number` y `circular`, que trae `title`, `subject`,
`abrogated`, `obligated_subjects` (a quién obliga), `compiled_pdf_url` (texto
consolidado vigente, con todas las modificaciones aplicadas), `original_pdf_url`
y `original_dof_date` (como se publicó originalmente), `comparison_pdf_url` (un
cuadro comparativo de todas las modificaciones, cuando existe), `abrogated_by`
(el instrumento que la abroga, o null mientras siga vigente), `official_url` y
`modifications`: cada circular modificatoria con su `circular_number`,
`dof_date`, `pdf_url` y `description`.

<Note>
  Las circulares modificatorias no tienen registro propio. Al consultar una se
  devuelve la **circular base modificada**: el `number` de nivel superior repite
  lo que pediste, `circular.number` es el número propio de la circular base, y
  el número solicitado aparece en su lista de `modifications`. Cuando ninguna
  entrada con ese número tiene registro, la consulta devuelve `found: false`.
</Note>

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