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

> Every circular and disposición issued by Banco de México since 1969, with abrogation status and consolidated text.

The chronological index of Banco de México circulares and disposiciones: 1,200+
entries back to 1969, each with its subject, whether it is still in effect, and
which base circular it modifies. List by year, then open one for its
consolidated text and modification chain.

## Circulars

`POST /mx/banxico/circulars/v1`

| Field  | Type    | Notes                                           |
| ------ | ------- | ----------------------------------------------- |
| `year` | string  | Optional 4-digit year. Omit to list every year. |
| `page` | integer | 1-based page number. 100 per page.              |

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

Returns `year` (echo of the filter, null when listing every year), `circulars`,
and `pagination`.

| Field        | Notes                                                              |
| ------------ | ------------------------------------------------------------------ |
| `number`     | Circular number as printed, e.g. `11/2026`, `E-126/2013`, `S/N`.   |
| `year`       | Year of issue.                                                     |
| `subject`    | What the circular covers.                                          |
| `modifies`   | Base circular number when this one amends another; otherwise null. |
| `abrogated`  | `true` when no longer in effect.                                   |
| `has_detail` | Whether this entry links to a full record.                         |

One row per index entry, so a circular that amends several base circulars
appears once per base.

## One circular

`POST /mx/banxico/circular/v1`

| Field    | Type   | Notes                                                                                  |
| -------- | ------ | -------------------------------------------------------------------------------------- |
| `number` | string | **Required.** Circular number as listed (e.g. `3/2012`). Matching is case-insensitive. |

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

Returns `found`, `number`, and `circular`, which carries `title`, `subject`,
`abrogated`, `obligated_subjects` (who it binds), `compiled_pdf_url` (current
consolidated text, all modifications applied), `original_pdf_url` and
`original_dof_date` (as first published), `comparison_pdf_url` (a consolidated
comparison of every modification, when offered), `abrogated_by` (the abrogating
instrument, or null while in force), `official_url`, and `modifications`: each
amending circular with its `circular_number`, `dof_date`, `pdf_url`, and
`description`.

<Note>
  Amendment circulars have no record of their own. Looking one up returns the
  **amended base circular**: the top-level `number` echoes what you asked for,
  `circular.number` is the base circular's own number, and the requested número
  appears in its `modifications` list. When no entry with that number has a
  record at all, the lookup returns `found: false`.
</Note>

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