---
title: "Conta a conta dos relatórios do portal IF.data numa data-base"
method: GET
path: "/v1/bcb/instituicoes/{chave}/relatorios"
tags: ["BCB"]
---

# Conta a conta dos relatórios do portal IF.data numa data-base

`GET /v1/bcb/instituicoes/{chave}/relatorios`

## Request

- Base URL: `https://api.balancos.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.balancos.ai/v1/bcb/instituicoes/{chave}/relatorios`
- Auth: HTTP bearer

## Path parameters

- `chave` string, required

## Query parameters

- `nivel` string: `individual`, `financeiro` ou `prudencial`; padrão: o nível padrão da instituição na última data-base.
- `data_base` string: Data-base `AAAAMM` (mês 03, 06, 09 ou 12); padrão: a última do nível.
- `relatorio` integer, nullable: Id do relatório (ver /bcb/data-bases/{data_base}/relatorios); opcional.

## Response `200`

Os relatórios do nível (demonstrações, capital, carteira de crédito, segmentação) como árvore, com o valor na mesma data-base do ano anterior quando a era é a mesma.

- EnvelopeRelatorios
  - `dados` Relatorios, required
    - `instituicao` InstituicaoResumo, required
      - `codinst` string, required
      - `nome` string, nullable, required
      - `cnpj` string, nullable, required
      - `cnpj_raiz` string, nullable, required
      - `tipo` Codigo, required
        - `codigo` string, required
        - `nome` string, nullable, required
      - `consolidado_bancario` Codigo, required
        - `codigo` string, required
        - `nome` string, nullable, required
      - `segmento_prudencial` string, nullable, required
      - `sede` Sede, required
        - `uf` string, nullable, required
        - `municipio` string, nullable, required
      - `conglomerados` Conglomerados, required
        - `financeiro` string, nullable, required
        - `prudencial` string, nullable, required
      - `primeira_data_base` string, required
      - `ultima_data_base` string, required
      - `n_data_bases` integer, required
      - `empresa` EmpresaResumo, required: `{razao_social, slug, link}` — o ponteiro leve usado dentro de balanços, DREs e documentos.
        - `razao_social` string, required
        - `slug` string, required
        - `link` string, required
    - `nivel` NivelResumo, required
      - `nivel` string, required
      - `codinst` string, required
      - `nome` string, nullable, required
      - `padrao` boolean, required
    - `data_base` string, required
    - `data_referencia` string, required
    - `era` string, required
    - `data_base_anterior` string, nullable, required
    - `comparavel` boolean, required
    - `relatorios` Relatorio[], required
      - `id` integer, required
      - `nome` string, required
      - `grupo` string, required
      - `cabecalho` string, nullable, required
      - `linhas` Linha[], required
        - `id` integer, required
        - `lid` integer, required
        - `nome` string, required
        - `descricao` string, nullable, required
        - `profundidade` integer, required
        - `grupo` boolean, required
        - `formato` string, required
        - `valor` union, required
          - integer
          - number
        - `valor_ano_anterior` union, required
          - integer
          - number
  - `meta` Meta, required
    - `versao` string
    - `release` string
    - `dados_atualizados_em` string, nullable, required
    - `requisicao_id` string, required

## Other responses

- `400`: `chave_instituicao_invalida`, `parametro_invalido` (nível, período, data-base) ou `requisicao_invalida` (parâmetro desconhecido).
- `401`: `chave_invalida` — Bearer ausente, malformado, inexistente ou revogado.
- `404`: `instituicao_nao_encontrada`, `nivel_nao_encontrado` (a instituição não tem o nível) ou `data_base_nao_encontrada`.
- `429`: `limite_excedido` (cota da conta) ou `limite_ip` (piso por IP).
- `503`: `indisponivel` — gold ou Supabase fora, ou falha ao concluir a medição.

---

[API](https://skmtc.dev/balancos/apis/balancos-ai-api-publica.md) · [All operations](https://skmtc.dev/balancos/apis/balancos-ai-api-publica/llms.txt) · [OpenAPI document](https://skmtc.dev/balancos/apis/balancos-ai-api-publica/revisions/389d7f383cb5?raw)