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

# CNSF

> Busque o marco de seguros e fianças do México: a LISF e a Circular Única, disposição por disposição, e as reformas por trás delas.

As regras que as seguradoras e afiançadoras mexicanas precisam cumprir,
vigentes e completas: a Ley de Instituciones de Seguros y de Fianzas e a Circular
Única de Seguros y de Fianzas (a circular que a implementa, com seus anexos).
Busque nas duas de uma vez ou consulte um artículo, disposición ou anexo pelo seu
número. Um segundo endpoint acompanha cada Circular Modificatoria desde 2014: o
que mudou e a publicação do Diario Oficial por trás dela.

## Buscar disposições

`POST /mx/cnsf/provisions-search/v1` Uma única busca sobre a lei e a circular ao mesmo tempo, algo que o site da Comissão não oferece.

| Campo             | Tipo    | Notas                                                                                                                                                             |
| ----------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`           | string  | Palavras opcionais a buscar no texto da disposição e nos nomes de seu capítulo e título.                                                                          |
| `instrument`      | enum    | `LISF` para a lei, `CUSF` para a circular ou `any` para ambas. Por padrão `any`.                                                                                  |
| `kind`            | enum    | `articulo` (LISF), `disposicion` ou `anexo` (CUSF), ou `any`. Por padrão `any`.                                                                                   |
| `number`          | string  | Número exato opcional, como o ordenamento o escreve: `41`, `3.1.2`, `14.2.1-a`.                                                                                   |
| `chapter_number`  | string  | Capítulo opcional, p. ex. `6.3`. Os anexos pendem de um capítulo em vez de estarem dentro dele e não têm número de capítulo.                                      |
| `source_circular` | string  | Opcional, para disposições transitórias: a Circular Modificatoria que as incorporou (p. ex. `3/2026`), ou `original` para as expedidas com o próprio ordenamento. |
| `amended_from`    | string  | Opcional: só disposições cujo capítulo foi reformado nesta data ou depois, `yyyy-mm-dd`.                                                                          |
| `amended_to`      | string  | Opcional: só disposições cujo capítulo foi reformado nesta data ou antes, `yyyy-mm-dd`.                                                                           |
| `page`            | integer | Número da página, começa em 1. Por padrão `1`.                                                                                                                    |
| `per_page`        | integer | Resultados por página (1-25). Cada resultado inclui o texto completo. Por padrão `10`.                                                                            |

```bash theme={"dark"}
curl https://api.croma.run/mx/cnsf/provisions-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "requerimiento de capital", "instrument": "CUSF" }'
```

<Note>
  A Croma atende este endpoint a partir da sua própria infraestrutura, então a resposta chega rápido e sempre igual. Cada resposta traz `as_of`: o quão atuais são os dados.
</Note>

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total`
(correspondências em todas as páginas), `page`, `per_page`, `total_pages`,
`count` e `results[]` em ordem de leitura. Cada resultado traz `id`, `instrument` (`LISF` ou `CUSF`), `kind`, `number`
como o ordenamento o escreve, `title_number` e `title_name`, `chapter_number` e
`chapter_name`, `heading` (o título oficial, em anexos e documentos referidos),
`text` (a disposição completa, com frações e incisos), `source_circular` (em
disposições transitórias, a Circular Modificatoria que as incorporou),
`external_url` (em documentos referidos), `amendment_note` e `last_amended_at`,
`position` (ordem de leitura dentro do ordenamento) e `official_url`.

`kind` é `articulo` (LISF), `disposicion`, `anexo`, `anexo_transitorio` ou
`documento` (CUSF), `transitoria` (qualquer um dos dois) ou `capitulo` para um
capítulo revogado por inteiro, que carrega o aviso de revogação e nenhuma
disposição numerada.

<Note>
  Respondido a partir da cópia da Croma de ambos os ordenamentos, atualizada
  semanalmente. `last_amended_at` é null quando a fonte não sinaliza nenhuma
  reforma no capítulo, o que significa que ele não mudou desde que o ordenamento
  foi expedido.
</Note>

## Uma disposição

`POST /mx/cnsf/provision/v1`

| Campo          | Tipo   | Notas                                                              |
| -------------- | ------ | ------------------------------------------------------------------ |
| `provision_id` | string | **Obrigatório.** O `id` de uma disposição dos resultados de busca. |

```bash theme={"dark"}
curl https://api.croma.run/mx/cnsf/provision/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "provision_id": "cusf:disp:3.1.2" }'
```

<Note>
  A Croma atende este endpoint a partir da sua própria infraestrutura, então a resposta chega rápido e sempre igual. Cada resposta traz `as_of`: o quão atuais são os dados.
</Note>

Retorna `as_of`, `found`, `provision_id` e `provision`. Cada resultado traz `id`, `instrument` (`LISF` ou `CUSF`), `kind`, `number`
como o ordenamento o escreve, `title_number` e `title_name`, `chapter_number` e
`chapter_name`, `heading` (o título oficial, em anexos e documentos referidos),
`text` (a disposição completa, com frações e incisos), `source_circular` (em
disposições transitórias, a Circular Modificatoria que as incorporou),
`external_url` (em documentos referidos), `amendment_note` e `last_amended_at`,
`position` (ordem de leitura dentro do ordenamento) e `official_url`.

`kind` é `articulo` (LISF), `disposicion`, `anexo`, `anexo_transitorio` ou
`documento` (CUSF), `transitoria` (qualquer um dos dois) ou `capitulo` para um
capítulo revogado por inteiro, que carrega o aviso de revogação e nenhuma
disposição numerada.

## Reformas

`POST /mx/cnsf/amendments/v1` O que mudou na circular, quando, e onde ler a publicação oficial.

| Campo            | Tipo    | Notas                                                                                                             |
| ---------------- | ------- | ----------------------------------------------------------------------------------------------------------------- |
| `query`          | string  | Palavras opcionais a buscar no título da reforma e no que ela descreve ter mudado.                                |
| `chapter_number` | string  | Opcional: só reformas que tocaram este capítulo, p. ex. `6.3`.                                                    |
| `published_from` | string  | Data de publicação mínima opcional, `yyyy-mm-dd`. As reformas sem data declarada nunca correspondem a uma janela. |
| `published_to`   | string  | Data de publicação máxima opcional, `yyyy-mm-dd`.                                                                 |
| `page`           | integer | Número da página, começa em 1. Por padrão `1`.                                                                    |
| `per_page`       | integer | Resultados por página (1-25). Por padrão `10`.                                                                    |

```bash theme={"dark"}
curl https://api.croma.run/mx/cnsf/amendments/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "chapter_number": "6.3" }'
```

<Note>
  A Croma atende este endpoint a partir da sua própria infraestrutura, então a resposta chega rápido e sempre igual. Cada resposta traz `as_of`: o quão atuais são os dados.
</Note>

Retorna `as_of`, os filtros aplicados, `total`, `page`, `per_page`,
`total_pages`, `count` e `results[]`, da mais recente à mais antiga. Cada
reforma traz `title` (`CIRCULAR Modificatoria 3/26`), `circular_number`,
`published_at`, `dof_document_id` e `dof_url` (a publicação do DOF por trás
dela), `changes[]` (o que fez, como a Comissão descreve), `affected_chapters[]`,
`affected_annexes[]` e `affected_urls[]`.

<Note>
  `published_at` é null nas reformas em que a Comissão não indica a data exata.
  Nunca é deduzido do ano no número da circular, que discorda do DOF em cerca de
  uma reforma em cada dez.
</Note>

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