> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nlbs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Regulação

> Versões do manifesto regulatório (COAF/SUSEP)

Expõe o histórico versionado do catálogo regulatório usado para gerar os [relatórios](/concepts/reports) COAF/SUSEP. Cada versão é imutável — uma vez publicada, seu conteúdo nunca muda.

**Escopo (todos os endpoints abaixo):** `rules:read`

<Note>
  Não existe um escopo `regulatory:read` separado — a leitura de manifestos regulatórios e do catálogo de regras de risco compartilham o mesmo escopo `rules:read`.
</Note>

## `GET /regulatory/versions`

Lista os manifestos de todas as versões publicadas do catálogo regulatório.

```json theme={null}
[
  {
    "version": "0.1.0",
    "published_at": "2026-06-23T00:00:00Z",
    "catalog_hash": "sha256:example",
    "document_count": 12,
    "reference_count": 80
  }
]
```

## `GET /regulatory/versions/{version}`

Recupera uma versão específica do manifesto, incluindo o catálogo completo.

### Erros

| Status | Quando                                 |
| ------ | -------------------------------------- |
| `404`  | A versão informada não foi encontrada. |
| `422`  | Parâmetro de versão inválido.          |

## `GET /regulatory/current`

Recupera a versão vigente (mais recente) do manifesto.

### Erros

| Status | Quando                                 |
| ------ | -------------------------------------- |
| `404`  | Nenhuma versão vigente foi encontrada. |

Os dois endpoints acima retornam `RegulatoryVersionSnapshotResponse`: os mesmos campos de manifesto listados acima, mais `catalog` — o conteúdo completo do catálogo regulatório congelado naquela versão (objeto livre).
