Cole no ChatGPT/Claude e peça para resumir/gerar SDK.
Relatórios brutos
GET
/companies/[companyIdentifier]/raw-reports
Retorna relatórios brutos (raw) conforme reportados ao órgão regulador (ex.: CVM), sem padronização de IDs.
- Ideal para quem quer consumir o dado como veio da fonte (ex.: conciliações, auditoria, comparações entre versões).
- Como é um payload raw, os nomes/chaves podem variar ao longo do tempo e entre empresas.
Parâmetros de requisição
| Parâmetro | Local | Descrição | Obrigatório |
|---|---|---|---|
[companyIdentifier] | URL | Identificador da empresa. | Obrigatório |
report_type | Query | Tipo de relatório (ver abaixo). | Opcional |
aggregation | Query | Tipo de agregação (INDIVIDUAL/CONSOLIDATED). | Opcional |
reference_date | Query | Data de referência (YYYY-MM-DD). | Opcional |
flat | Query | Formato da resposta: true (flat) ou false (tree). Padrão: false. | Opcional |
publish_date | Query | Filtra por publish_date maior que o valor (ISO 8601). | Opcional |
retrieval_date | Query | Filtra por retrieval_date maior que o valor (ISO 8601). | Opcional |
latest_by_reference_date | Query | Mantém apenas o último raw report publicado (por tipo e agregação) em cada reference_date. | Opcional |
Dica rápida
- Quer apenas o último report de cada
reference_date? Uselatest_by_reference_date=true. - Quer resposta mais leve? Use
flat=true(sem árvore).
Tipo de relatório (report_type)
O report_type é um acrônimo que varia por país.
Brasil
| Tipo | Descrição |
|---|---|
BPA | Balanço Patrimonial Ativo |
BPP | Balanço Patrimonial Passivo |
DRE | Demonstração do Resultado do Exercício |
DFC_MI | Demonstração do Fluxo de Caixa (Método Indireto) |
DFC_MD | Demonstração do Fluxo de Caixa (Método Direto) |
DVA | Demonstração do Valor Adicionado |
Resposta
| Código | Descrição |
|---|---|
| 200 | Retorna a lista de relatórios brutos. |
| 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 |
|---|---|---|
report_type.name | string | Nome do tipo de balanço/relatório (ex.: Demonstração do Resultado). |
report_type.acronym | string | Acrônimo/tipo do balanço (DRE, BPA, BPP, DFC_MI, DFC_MD, DVA). |
report_type.aggregation | string | Agregação do relatório (INDIVIDUAL ou CONSOLIDATED). |
reference_date | string (ISO 8601) | Data de referência do período reportado. |
start_date | string (ISO 8601) | null | Data inicial do período reportado (quando aplicável). |
end_date | string (ISO 8601) | null | Data final do período reportado (quando aplicável). |
publish_date | string (ISO 8601) | Data de publicação do relatório na CVM. |
retrieval_date | string (ISO 8601) | Data/hora em que a Partnr coletou o relatório. |
version | integer | Versão do documento na CVM. |
data | object | Estrutura flat do relatório (chaves concatenadas com |), usada quando flat=true. |
tree_data | object | Estrutura hierárquica do relatório, usada quando flat=false (padrão). |
sources | array | Fontes do documento na CVM, com links e datas de publicação/coleta. |
Estrutura de tree_data (nó)
| Campo | Tipo | Descrição |
|---|---|---|
name | string | Nome da conta/linha contábil. |
code | integer | string | Código da conta na CVM. |
value | number | null | Valor da conta no período (pode ser null em nós agregadores). |
children | array | Subcontas (filhos) do nó, no mesmo formato. |
Sobre flat
flat é um parâmetro de query que define o formato retornado:
flat=true: prioriza a estrutura emdata(objeto flat).flat=false(padrão): prioriza a estrutura emtree_data(árvore).
Exemplo (resumido)
[
{
"report_type": {
"name": "Demonstração do Resultado",
"acronym": "DRE",
"aggregation": "CONSOLIDATED"
},
"reference_date": "2025-09-30T00:00:00.000Z",
"start_date": "2025-07-01T00:00:00.000Z",
"end_date": "2025-09-30T00:00:00.000Z",
"publish_date": "2025-11-06T23:18:00.000Z",
"retrieval_date": "2025-11-07T13:32:59.872Z",
"version": 1,
"data": {
"Demonstração do Resultado": null,
"Demonstração do Resultado | Receita de Venda de Bens e/ou Serviços": 127906000000,
"Demonstração do Resultado | Custo dos Bens e/ou Serviços Vendidos": -66789000000,
...
},
"tree_data": {
"name": "Demonstração do Resultado",
"code": 3,
"value": null,
"children": [
{ "name": "Receita de Venda de Bens e/ou Serviços", "code": 1, "value": 127906000000, "children": [] },
{ "name": "Custo dos Bens e/ou Serviços Vendidos", "code": 2, "value": -66789000000, "children": [] },
{ "name": "Resultado Bruto", "code": 3, "value": 61117000000, "children": [] },
...
]
},
"sources": [
{
"visualization_url": "https://www.rad.cvm.gov.br/ENET/frmGerenciaPaginaFRE.aspx?NumeroSequencialDocumento=152792&CodigoTipoInstituicao=1",
"published_at": "2025-11-06T23:18:00.000Z",
"retrieved_at": "2025-11-07T13:32:59.872Z"
}
]
},
{
"report_type": {
"name": "Balanço Patrimonial Ativo",
"acronym": "BPA",
"aggregation": "CONSOLIDATED"
},
"reference_date": "2025-09-30T00:00:00.000Z",
"start_date": "2025-07-01T00:00:00.000Z",
"end_date": "2025-09-30T00:00:00.000Z",
"publish_date": "2025-11-06T23:18:00.000Z",
"retrieval_date": "2025-11-07T13:32:59.872Z",
"version": 1,
"data": {
"Ativo Total": 1212038000000,
"Ativo Total | Ativo Circulante": 149361000000,
"Ativo Total | Ativo Circulante | Caixa e Equivalentes de Caixa": 47675000000,
...
},
"tree_data": {
"name": "Ativo Total",
"code": 1,
"value": 1212038000000,
"children": [
{ "name": "Ativo Circulante", "code": 1, "value": 149361000000, "children": [...] },
{ "name": "Ativo Não Circulante", "code": 2, "value": 1062677000000, "children": [...] },
{ "name": "Imobilizado", "code": 3, "value": 912442000000, "children": [...] },
...
]
},
"sources": [
{
"visualization_url": "https://www.rad.cvm.gov.br/ENET/frmGerenciaPaginaFRE.aspx?NumeroSequencialDocumento=152792&CodigoTipoInstituicao=1",
"published_at": "2025-11-06T23:18:00.000Z",
"retrieved_at": "2025-11-07T13:32:59.872Z"
}
]
},
{
"report_type": {
"name": "Balanço Patrimonial Passivo",
"acronym": "BPP",
"aggregation": "CONSOLIDATED"
},
"reference_date": "2025-09-30T00:00:00.000Z",
"start_date": "2025-07-01T00:00:00.000Z",
"end_date": "2025-09-30T00:00:00.000Z",
"publish_date": "2025-11-06T23:18:00.000Z",
"retrieval_date": "2025-11-07T13:32:59.872Z",
"version": 1,
"data": {
"Passivo Total": 1212038000000,
"Passivo Total | Passivo Circulante": 182367000000,
"Passivo Total | Passivo Não Circulante": 604710000000,
...
},
"tree_data": {
"name": "Passivo Total",
"code": 2,
"value": 1212038000000,
"children": [
{ "name": "Passivo Circulante", "code": 1, "value": 182367000000, "children": [...] },
{ "name": "Passivo Não Circulante", "code": 2, "value": 604710000000, "children": [...] },
{ "name": "Patrimônio Líquido Consolidado", "code": 3, "value": 424961000000, "children": [...] },
...
]
},
"sources": [
{
"visualization_url": "https://www.rad.cvm.gov.br/ENET/frmGerenciaPaginaFRE.aspx?NumeroSequencialDocumento=152792&CodigoTipoInstituicao=1",
"published_at": "2025-11-06T23:18:00.000Z",
"retrieved_at": "2025-11-07T13:32:59.872Z"
}
]
},
{
"report_type": {
"name": "Demonstração do Fluxo de Caixa (Método Indireto)",
"acronym": "DFC_MI",
"aggregation": "CONSOLIDATED"
},
"reference_date": "2025-09-30T00:00:00.000Z",
"start_date": "2025-07-01T00:00:00.000Z",
"end_date": "2025-09-30T00:00:00.000Z",
"publish_date": "2025-11-06T23:18:00.000Z",
"retrieval_date": "2025-11-07T13:32:59.872Z",
"version": 1,
"data": {
"Demonstração do Fluxo de Caixa (Método Indireto)": null,
"Demonstração do Fluxo de Caixa (Método Indireto) | Caixa Líquido Atividades Operacionais": 53655000000,
"Demonstração do Fluxo de Caixa (Método Indireto) | Caixa Líquido Atividades de Investimento": -25937000000,
...
},
"tree_data": {
"name": "Demonstração do Fluxo de Caixa (Método Indireto)",
"value": null,
"code": 6,
"children": [
{ "name": "Caixa Líquido Atividades Operacionais", "value": 53655000000, "code": 1, "children": [...] },
{ "name": "Caixa Líquido Atividades de Investimento", "value": -25937000000, "code": 2, "children": [...] },
{ "name": "Caixa Líquido Atividades de Financiamento", "value": -17595000000, "code": 3, "children": [...] },
...
]
},
"sources": [
{
"visualization_url": "https://www.rad.cvm.gov.br/ENET/frmGerenciaPaginaFRE.aspx?NumeroSequencialDocumento=152792&CodigoTipoInstituicao=1",
"published_at": "2025-11-06T23:18:00.000Z",
"retrieved_at": "2025-11-07T13:32:59.872Z"
},
{
"visualization_url": "https://www.rad.cvm.gov.br/ENET/frmGerenciaPaginaFRE.aspx?NumeroSequencialDocumento=150784&CodigoTipoInstituicao=1",
"published_at": "2025-08-08T02:00:00.000Z",
"retrieved_at": "2025-08-12T05:24:33.898Z"
}
]
},
{
"report_type": {
"name": "Demonstração de Valor Adicionado",
"acronym": "DVA",
"aggregation": "CONSOLIDATED"
},
"reference_date": "2025-09-30T00:00:00.000Z",
"start_date": "2025-07-01T00:00:00.000Z",
"end_date": "2025-09-30T00:00:00.000Z",
"publish_date": "2025-11-06T23:18:00.000Z",
"retrieval_date": "2025-11-07T13:32:59.872Z",
"version": 1,
"data": {
"Demonstração de Valor Adicionado": null,
"Demonstração de Valor Adicionado | Receitas": 197877000000,
"Demonstração de Valor Adicionado | Insumos Adquiridos de Terceiros": -73790000000,
...
},
"tree_data": {
"name": "Demonstração de Valor Adicionado",
"value": null,
"code": 7,
"children": [
{ "name": "Receitas", "value": 197877000000, "code": 1, "children": [...] },
{ "name": "Insumos Adquiridos de Terceiros", "value": -73790000000, "code": 2, "children": [...] },
{ "name": "Distribuição do Valor Adicionado", "value": 105383000000, "code": 8, "children": [...] },
...
]
},
"sources": [
{
"visualization_url": "https://www.rad.cvm.gov.br/ENET/frmGerenciaPaginaFRE.aspx?NumeroSequencialDocumento=152792&CodigoTipoInstituicao=1",
"published_at": "2025-11-06T23:18:00.000Z",
"retrieved_at": "2025-11-07T13:32:59.872Z"
},
{
"visualization_url": "https://www.rad.cvm.gov.br/ENET/frmGerenciaPaginaFRE.aspx?NumeroSequencialDocumento=150784&CodigoTipoInstituicao=1",
"published_at": "2025-08-08T02:00:00.000Z",
"retrieved_at": "2025-08-12T05:24:33.898Z"
}
]
}
]