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

# Banxico Circular

`POST /mx/banxico/circular/v1`

## Request

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

One Banco de México circular in full, by its `number`: subject, obligated entities, the consolidated (compiled) text PDF, the original text PDF with its DOF date, and every modification with dates and PDFs. Amendment circulars have no page of their own: looking one up returns the amended base circular (its `number` says which), whose modifications list carries the requested número.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `number` string, required: Circular number as listed (e.g. `3/2012`, `E-126/2013`). Matching is case-insensitive.

## Response `200`

Successful response

- BanxicoCircularResponse
  - `data` BanxicoCircularData, required
    - `found` boolean, required
    - `number` string, required
    - `circular` object, nullable, required
      - `number` string, required: The circular this page describes; amendment lookups resolve to their base.
      - `abrogated` boolean, required
      - `title` string, nullable, required
      - `subject` string, nullable, required
      - `obligated_subjects` string[], required
      - `compiled_pdf_url` string, nullable, required: Current consolidated text (all modifications applied).
      - `original_pdf_url` string, nullable, required: Text as originally published.
      - `original_dof_date` string, nullable, required
      - `comparison_pdf_url` string, nullable, required: Consolidated comparison of every modification, when the page offers one.
      - `abrogated_by` object, nullable, required: The abrogating instrument, from the page banner; null while in force.
        - `text` string, required
        - `circular_number` string, nullable, required
        - `url` string, nullable, required
      - `modifications` object[], required
        - `circular_number` string, nullable, required: Modifying circular, e.g. "11/2026"; null when the entry names no one.
        - `dof_date` string, nullable, required
        - `pdf_url` string, nullable, required
        - `description` string, required
      - `official_url` string, 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)