---
title: "CNSF Provision"
method: POST
path: "/mx/cnsf/provision/v1"
tags: ["Mexico", "CNSF"]
---

# CNSF Provision

`POST /mx/cnsf/provision/v1`

## Request

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

Retrieve one provision of Mexico's insurance and surety rulebook by its `provision_id` from the search results (e.g. `cusf:disp:3.1.2`, `lisf:art:41`, `cusf:anexo:14.2.1-a`), with its full text and the chapter it sits in.

**Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `provision_id` string, required: Provision identifier from the search results (`id`), e.g. `cusf:disp:3.1.2`, `lisf:art:41`, `cusf:anexo:14.2.1-a`.

## Response `200`

Successful response

- CnsfProvisionResponse
  - `data` CnsfProvisionData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `found` boolean, required
    - `provision_id` string, required
    - `provision` object, nullable, required
      - `id` string, required: Stable identifier: instrument, kind and the number the instrument gives the provision (e.g. `cusf:disp:3.1.2`, `lisf:art:41`, `cusf:anexo:14.2.1-a`).
      - `instrument` 'LISF' | 'CUSF', required: `LISF` (Ley de Instituciones de Seguros y de Fianzas) or `CUSF` (Circular Única de Seguros y de Fianzas).
      - `kind` 'articulo' | 'disposicion' | 'anexo' | 'transitoria' | 'anexo_transitorio' | 'capitulo' | 'documento', required: `articulo` (LISF), `disposicion`, `anexo`, `anexo_transitorio` and `documento` (CUSF), `transitoria` (either), or `capitulo` for a chapter repealed in full, which has explanatory text but no numbered provisions.
      - `number` string, required: The number the instrument itself gives the provision: "41", "3.1.2", "14.2.1-a".
      - `title_number` string, nullable, required: Number of the título the provision sits under, e.g. "3".
      - `title_name` string, nullable, required: Name of the título, e.g. "DEL GOBIERNO CORPORATIVO".
      - `chapter_number` string, nullable, required: Number of the capítulo, e.g. "3.1". Null on annexes, which hang off a chapter rather than sitting in one.
      - `chapter_name` string, nullable, required: Name of the capítulo, or of the annex group.
      - `heading` string, nullable, required: The provision's own official title, where the instrument publishes one: the description the annex index gives an anexo, or the entry the documentation index gives a documento.
      - `source_circular` string, nullable, required: For a `transitoria`, the Circular Modificatoria that introduced it (e.g. "3/26"), or `original` for the provisions issued with the instrument itself. Null on every other kind.
      - `external_url` string, nullable, required: For a `documento`, the address the instrument points to for it. Null on every other kind.
      - `text` string, nullable, required: Full text of the provision, including its fracciones and incisos. Null on the few annexes the source publishes only as an image and on a chapter it has repealed outright.
      - `amendment_note` 'nuevo' | 'modificado' | 'derogado', nullable, required: What the source flags about the containing chapter or annex: `nuevo`, `modificado` or `derogado`. Null when it flags nothing.
      - `last_amended_at` string, nullable, required: `yyyy-mm-dd` the containing chapter or annex was last amended in the DOF. Null when the source flags no amendment, which means it has not changed since the instrument was issued.
      - `position` number, required: Reading order within the instrument, so provisions sort the way they are printed rather than alphabetically.
      - `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)