---
title: "Banxico Circulars"
method: POST
path: "/mx/banxico/circulars/v1"
tags: ["Mexico", "Banco de México"]
---

# Banxico Circulars

`POST /mx/banxico/circulars/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/mx/banxico/circulars/v1`
- Auth: HTTP bearer

The chronological index of every circular and disposición issued by Banco de México (1,200+ entries back to 1969), each with subject, abrogation status, and which base circular it modifies. One row per index entry: a circular amending several bases appears once per base. Optional `year` filters one year. Paged, 100 per page; drill into one with `banxico-circular`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `year` string: Optional 4-digit year filter.
  - `page` integer: 1-based page number for paginated results.

## Response `200`

Successful response

- BanxicoCircularsResponse
  - `data` BanxicoCircularsData, required
    - `year` number, nullable, required: Echo of the year filter; null when listing every year.
    - `circulars` object[], required
      - `number` string, required: As printed in the index, e.g. "11/2026", "E-126/2013", "S/N".
      - `year` number, required
      - `subject` string, required
      - `modifies` string, nullable, required: Base circular number when the subject is "Modifica la Circular X/YYYY".
      - `abrogated` boolean, required: Marked abrogated (no longer in effect) in the index.
      - `has_detail` boolean, required: Whether the row links to a detail page usable with the lookup endpoint.
    - `pagination` object, required
      - `total` number, required
      - `page_size` number, required
      - `total_pages` number, required
      - `page` number, required

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)