> ## 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 as circulares e disposições do Banco de México desde 1969, com estado de ab-rogação e texto consolidado.

O índice cronológico de circulares e disposições do Banco de México: 1.200+
entradas desde 1969, cada uma com seu assunto, se continua vigente e qual
circular base modifica. Liste por ano e depois abra uma para ver seu texto
consolidado e sua cadeia de modificações.

## Circulares

`POST /mx/banxico/circulars/v1`

| Campo  | Tipo    | Notas                                                        |
| ------ | ------- | ------------------------------------------------------------ |
| `year` | string  | Ano de 4 dígitos, opcional. Omita para listar todos os anos. |
| `page` | integer | Número da 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" }'
```

Retorna `year` (eco do filtro, null quando se listam todos os anos),
`circulars` e `pagination`.

| Campo        | Notas                                                                       |
| ------------ | --------------------------------------------------------------------------- |
| `number`     | Número da circular tal como aparece, p. ex. `11/2026`, `E-126/2013`, `S/N`. |
| `year`       | Ano de emissão.                                                             |
| `subject`    | Assunto que a circular cobre.                                               |
| `modifies`   | Número da circular base quando esta a modifica; caso contrário, null.       |
| `abrogated`  | `true` quando já não está vigente.                                          |
| `has_detail` | Se esta entrada leva a um registro completo.                                |

Uma linha por entrada do índice, então uma circular que modifica várias
circulares base aparece uma vez para cada base.

## Uma circular

`POST /mx/banxico/circular/v1`

| Campo    | Tipo   | Notas                                                                                             |
| -------- | ------ | ------------------------------------------------------------------------------------------------- |
| `number` | string | **Obrigatório.** Número da circular tal como listado (p. ex. `3/2012`). Não distingue maiú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" }'
```

Retorna `found`, `number` e `circular`, que traz `title`, `subject`,
`abrogated`, `obligated_subjects` (a quem obriga), `compiled_pdf_url` (texto
consolidado vigente, com todas as modificações aplicadas), `original_pdf_url`
e `original_dof_date` (como foi publicada originalmente), `comparison_pdf_url`
(um quadro comparativo de todas as modificações, quando existe), `abrogated_by`
(o instrumento que a ab-roga, ou null enquanto continuar vigente),
`official_url` e `modifications`: cada circular modificatória com seu
`circular_number`, `dof_date`, `pdf_url` e `description`.

<Note>
  As circulares modificatórias não têm registro próprio. Ao consultar uma
  delas, retorna-se a **circular base modificada**: o `number` de nível
  superior repete o que você pediu, `circular.number` é o número próprio da
  circular base, e o número solicitado aparece na sua lista de
  `modifications`. Quando nenhuma entrada com esse número tem registro, a
  consulta retorna `found: false`.
</Note>

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