---
title: "Dicionário e árvore dos relatórios do portal numa data-base, sem valores"
method: GET
path: "/v1/bcb/data-bases/{data_base}/relatorios"
tags: ["BCB"]
---

# Dicionário e árvore dos relatórios do portal numa data-base, sem valores

`GET /v1/bcb/data-bases/{data_base}/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/data-bases/{data_base}/relatorios`
- Auth: HTTP bearer

## Path parameters

- `data_base` string, required

## Response `200`

Relatórios, os níveis que cada um cobre e a árvore de colunas (id, lid, pai).

- EnvelopeEstrutura
  - `dados` Estrutura, required
    - `data_base` string, required
    - `era` string, required
    - `relatorios` RelatorioEstrutura[], required
      - `id` integer, required
      - `nome` string, required
      - `grupo` string, required
      - `niveis` string[], required
      - `cabecalho` string, nullable, required
      - `notas` string, nullable, required
      - `colunas` ColunaEstrutura[], required
        - `id` integer, required
        - `lid` integer, required
        - `nome` string, required
        - `descricao` string, nullable, required
        - `pai_id` integer, nullable, required
        - `profundidade` integer, required
        - `grupo` boolean, required
        - `formato` string, required
  - `meta` Meta, required
    - `versao` string
    - `release` string
    - `dados_atualizados_em` string, nullable, required
    - `requisicao_id` string, required

## Other responses

- `400`: `parametro_invalido` (data-base mal formada) ou `requisicao_invalida`.
- `401`: `chave_invalida` — Bearer ausente, malformado, inexistente ou revogado.
- `404`: `data_base_nao_encontrada` — AAAAMM sem derivação no silver.
- `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)