Cole no ChatGPT/Claude e peça para resumir/gerar SDK.

Relatórios padronizados

GET

/companies/[companyIdentifier]/reports

Retorna relatórios financeiros padronizados da empresa (ex.: Balanço, DRE, DFC e DVA), quando disponíveis.
Os campos em data usam IDs estáveis para facilitar integração, comparação e histórico.

Modelos de reporte

Existem diferentes modelos de reporte (ex.: indústria, seguros, financeiro).
A quantidade de relatórios disponíveis depende do modelo usado pela companhia.

Como usar

Para listar tudo: chame o endpoint apenas com [companyIdentifier].
Para recortar um conjunto específico: combine section, aggregation, frequency e/ou reference_date.
Para paginação incremental: use publish_date e/ou retrieval_date como “cursor” (maior que a data informada).
Para evitar duplicidade por data: use latest_by_reference_date=true.

Parâmetros de requisição

Parâmetro	Local	Descrição	Obrigatório
`[companyIdentifier]`	URL	Identificador da empresa.	Obrigatório
`section`	Query	Seção do relatório (ver abaixo).	Opcional
`aggregation`	Query	Tipo de agregação (ver abaixo).	Opcional
`frequency`	Query	Frequência (ver abaixo).	Opcional
`reference_date`	Query	Data de referência (`YYYY-MM-DD`).	Opcional
`publish_date`	Query	Retorna apenas relatórios com `publish_date` maior que o valor informado (ISO 8601).	Opcional
`retrieval_date`	Query	Retorna apenas relatórios com `retrieval_date` maior que o valor informado (ISO 8601).	Opcional
`latest_by_reference_date`	Query	Mantém apenas o último relatório publicado por combinação seção/agregação/frequência em cada `reference_date`.	Opcional

Valores aceitos

Seções (`section`)

BALANCE_SHEET: ativos, passivos e patrimônio líquido
CASH_FLOW_STATEMENT: fluxo de caixa
INCOME_STATEMENT: demonstração de resultado
VALUE_ADDED_STATEMENT: demonstração de valor adicionado

Tipo de agregação (`aggregation`)

INDIVIDUAL: apenas a controladora (sem subsidiárias)
CONSOLIDATED: controladora + subsidiárias

Frequência (`frequency`)

ANNUAL: anual
QUARTERLY: trimestral
TTM: últimos 12 meses
YTD: ano corrente até a data

Estrutura da resposta

Cada item do array representa um “relatório” para uma combinação de: section + aggregation + frequency + reference_date.

data: objeto com os campos padronizados (IDs estáveis).
sources: lista de fontes usadas para compor o relatório (links e carimbos de data).

IDs padronizados (campos em `data`)

Campos dentro de data são padronizados e possuem IDs únicos (quando reportados pela companhia).

Tabela de IDs: https://docs.google.com/spreadsheets/d/1-wfWd9CH6MeCi8e-bioDUDGxlEwL_wJ9SVl9QN2Xzy8/edit#gid=0

Valores nulos

Valores null podem ocorrer por divisão por zero ou ausência de dados no relatório fonte.

Respostas

Código	Descrição
200	Retorna os relatórios padronizados.
404	Empresa não encontrada.
400	Parâmetros ausentes ou inválidos.
401	Não autorizado.

Formato da resposta

A resposta é uma lista de objetos com os campos abaixo:

Campo	Tipo	Descrição
`section`	string	Seção do relatório (`BALANCE_SHEET`, `CASH_FLOW_STATEMENT`, `INCOME_STATEMENT`, `VALUE_ADDED_STATEMENT`).
`aggregation`	string	Tipo de agregação (`INDIVIDUAL` ou `CONSOLIDATED`).
`frequency`	string	Frequência do relatório (`ANNUAL`, `QUARTERLY`, `TTM`, `YTD`).
`reference_date`	string (ISO 8601)	Data de referência do período reportado.
`start_date`	string (ISO 8601)	Data inicial do período (quando aplicável).
`end_date`	string (ISO 8601)	Data final do período (quando aplicável).
`publish_date`	string (ISO 8601)	Data de publicação do relatório na fonte.
`retrieval_date`	string (ISO 8601)	Data/hora de coleta do relatório pela Partnr.
`data`	object	Objeto no formato `ID: value` (campos padronizados por identificador).
`sources`	array	Lista de fontes usadas para compor o relatório.

Exemplo

[
  {
    "section": "INCOME_STATEMENT",
    "aggregation": "INDIVIDUAL",
    "frequency": "ANNUAL",
    "reference_date": "2025-12-31T00:00:00.000Z",
    "start_date": "2025-01-01T00:00:00.000Z",
    "end_date": "2025-12-31T00:00:00.000Z",
    "publish_date": "2026-02-04T09:19:00.000Z",
    "retrieval_date": "2026-02-04T10:26:28.715Z",
    "data": {
      "NET_REVENUE": 146340671000,
      "COSTS": -121927861000,
      "NET_INCOME": 15463827000,
      "...": "..."
    },
    "sources": [
      {
        "visualization_url": "https://www.rad.cvm.gov.br/ENET/frmGerenciaPaginaFRE.aspx?NumeroSequencialDocumento=154583&CodigoTipoInstituicao=1",
        "published_at": "2026-02-04T09:19:00.000Z",
        "retrieved_at": "2026-02-04T10:17:53.755Z"
      },
      {
        "visualization_url": "",
        "published_at": "2026-01-06T03:00:00.000Z",
        "retrieved_at": null
      }
    ]
  },
  {
    "section": "BALANCE_SHEET",
    "aggregation": "INDIVIDUAL",
    "frequency": "TTM",
    "reference_date": "2021-09-30T00:00:00.000Z",
    "start_date": "2021-07-01T00:00:00.000Z",
    "end_date": "2021-09-30T00:00:00.000Z",
    "publish_date": "2021-10-27T13:24:00.000Z",
    "retrieval_date": "2025-10-30T06:57:13.534Z",
    "data": {
      "TOTAL_ASSETS": 977096018000,
      "CASH": 149719210000,
      "SHAREHOLDERS_EQUITY": 79061548000,
      "...": "..."
    },
    "sources": [
      {
        "visualization_url": "https://www.rad.cvm.gov.br/ENET/frmGerenciaPaginaFRE.aspx?NumeroSequencialDocumento=97879&CodigoTipoInstituicao=1",
        "published_at": "2020-10-27T09:54:00.000Z",
        "retrieved_at": "2022-11-03T13:06:22.689Z"
      },
      {
        "visualization_url": "https://www.rad.cvm.gov.br/ENET/frmGerenciaPaginaFRE.aspx?NumeroSequencialDocumento=109239&CodigoTipoInstituicao=1",
        "published_at": "2021-10-27T13:24:00.000Z",
        "retrieved_at": "2022-11-03T13:06:22.712Z"
      },
      {
        "visualization_url": "",
        "published_at": "2021-10-05T03:00:00.000Z",
        "retrieved_at": null
      }
    ]
  },
  {
    "section": "CASH_FLOW_STATEMENT",
    "aggregation": "CONSOLIDATED",
    "frequency": "TTM",
    "reference_date": "2019-09-30T00:00:00.000Z",
    "start_date": "2019-07-01T00:00:00.000Z",
    "end_date": "2019-09-30T00:00:00.000Z",
    "publish_date": "2019-10-30T21:02:00.000Z",
    "retrieval_date": "2023-03-03T06:53:41.147Z",
    "data": {
      "FINAL_CASH_BALANCE": 85037762000,
      "INCREASE_OR_DECREASE_IN_CASH": -14179495000,
      "FINANCING_CASH_FLOW": -39433216000,
      "...": "..."
    },
    "sources": [
      {
        "visualization_url": "https://www.rad.cvm.gov.br/ENET/frmGerenciaPaginaFRE.aspx?NumeroSequencialDocumento=85514&CodigoTipoInstituicao=1",
        "published_at": "2019-07-23T10:03:00.000Z",
        "retrieved_at": "2022-11-03T13:06:22.665Z"
      },
      {
        "visualization_url": "https://www.rad.cvm.gov.br/ENET/frmGerenciaPaginaFRE.aspx?NumeroSequencialDocumento=82500&CodigoTipoInstituicao=1",
        "published_at": "2019-04-30T10:20:00.000Z",
        "retrieved_at": "2022-11-03T13:06:22.660Z"
      },
      {
        "visualization_url": "https://www.rad.cvm.gov.br/ENET/frmGerenciaPaginaFRE.aspx?NumeroSequencialDocumento=55279&CodigoTipoInstituicao=1",
        "published_at": "2016-04-27T09:37:00.000Z",
        "retrieved_at": "2022-11-03T13:06:22.576Z"
      },
      {
        "visualization_url": "https://www.rad.cvm.gov.br/ENET/frmGerenciaPaginaFRE.aspx?NumeroSequencialDocumento=88898&CodigoTipoInstituicao=1",
        "published_at": "2019-10-30T21:02:00.000Z",
        "retrieved_at": "2022-11-03T13:06:22.670Z"
      },
      {
        "visualization_url": "https://www.rad.cvm.gov.br/ENET/frmGerenciaPaginaFRE.aspx?NumeroSequencialDocumento=76555&CodigoTipoInstituicao=1",
        "published_at": "2018-07-30T19:07:00.000Z",
        "retrieved_at": "2022-11-03T13:06:22.645Z"
      }
    ]
  },
  {
    "section": "VALUE_ADDED_STATEMENT",
    "aggregation": "INDIVIDUAL",
    "frequency": "YTD",
    "reference_date": "2021-06-30T00:00:00.000Z",
    "start_date": "2021-04-01T00:00:00.000Z",
    "end_date": "2021-06-30T00:00:00.000Z",
    "publish_date": "2021-07-28T06:00:00.000Z",
    "retrieval_date": "2023-03-03T00:56:45.366Z",
    "data": {
      "REVENUE": 94346538000,
      "GROSS_ADDED_VALUE": 12387387000,
      "ADDED_VALUE_TO_DISTRIBUTE": 11984999000,
      "...": "..."
    },
    "sources": [
      {
        "visualization_url": "https://www.rad.cvm.gov.br/ENET/frmGerenciaPaginaFRE.aspx?NumeroSequencialDocumento=103127&CodigoTipoInstituicao=1",
        "published_at": "2021-04-28T19:06:00.000Z",
        "retrieved_at": "2022-11-03T13:06:22.700Z"
      },
      {
        "visualization_url": "https://www.rad.cvm.gov.br/ENET/frmGerenciaPaginaFRE.aspx?NumeroSequencialDocumento=92541&CodigoTipoInstituicao=1",
        "published_at": "2020-04-28T09:52:00.000Z",
        "retrieved_at": "2022-11-03T13:06:22.679Z"
      }
    ]
  }
]

Como usar​

Parâmetros de requisição​

Valores aceitos​

Seções (section)​

Tipo de agregação (aggregation)​

Frequência (frequency)​

Estrutura da resposta​

IDs padronizados (campos em data)​

Respostas​

Formato da resposta​

Exemplo​