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

Proventos em dinheiro

GET

/companies/[companyIdentifier]/cash-corporate-actions

Retorna eventos corporativos em dinheiro (ex.: dividendos, JCP, restituições, amortizações) para uma empresa específica.

Também pode retornar proventos de BDRs.

Esse endpoint é ideal para:

telas de detalhe do ativo/empresa (timeline de proventos)
alertas para investidores (ex.: anunciou / data-ex / pagamento)
automações de carteira e conciliação de eventos com fonte rastreável

Quando usar

Construir um calendário/timeline de proventos de uma empresa (ex.: PETR)
Filtrar por classe (ON/PN/UNIT) com stock_type
Consumir proventos já “prontos para UI” (ex.: parcelas em installments quando existirem)
Consultar proventos em dinheiro de BDRs quando houver eventos disponíveis

Parâmetros de requisição

Parâmetro	Local	Descrição	Obrigatório
`[companyIdentifier]`	URL	Identificador da empresa (`symbol`, `ticker` ou `company_id`, que pode ser CNPJ ou código CVM).	Obrigatório
`current`	Query	Se `true`, retorna apenas a versão atual do evento. Padrão: `true`.	Opcional
`start_date`	Query	ISO 8601. Filtra por `payment_date` a partir desta data.	Opcional
`end_date`	Query	ISO 8601. Filtra por `payment_date` até esta data.	Opcional
`stock_type`	Query	Filtra por tipo (CS, PS, PSA, PSB, PSC, PSD, UNIT, BDR).	Opcional

Boas práticas

Para montar uma timeline “limpa”, use current=true e filtre por janela de datas quando necessário.
payment_date pode ser null quando o pagamento ainda não foi definido; use approval_date, publish_date e prior_ex_date como marcos do evento.
Um mesmo evento pode ter parcelas; quando existir installments, ele descreve pagamentos em múltiplas datas.

Se você usar ticker

Quando o identificador é um ticker, a resposta é filtrada para o tipo de ação correspondente.
Ex.: PETR4 tende a retornar apenas eventos para stock_type=PS e PETR3 tende a retornar eventos para stock_type=CS.

BDRs neste endpoint

Esse endpoint também cobre proventos em dinheiro de BDRs.
Você pode consultar por ticker/symbol/company_id da empresa do BDR e receber os eventos quando houver dados disponíveis.

Resposta

Código	Descrição
200	Retorna os eventos corporativos em dinheiro.
400	Parâmetros ausentes ou inválidos.
401	Não autorizado.
404	Empresa não encontrada.

Formato da resposta

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

Campo	Tipo	Descrição
`approval_date`	string (ISO 8601) \| null	Data de aprovação do provento.
`created_at`	string (ISO 8601)	Data/hora de criação do registro na base da Partnr.
`prior_ex_date`	string (ISO 8601) \| null	Data com, usada para elegibilidade ao provento.
`protocol`	string	Protocolo do provento na CVM.
`publish_date`	string (ISO 8601)	Data de publicação do evento.
`id`	string	ID único do provento na base da Partnr.
`payment_date`	string (ISO 8601) \| null	Data de pagamento do provento (quando definida).
`stock_type`	string	Tipo de ação (`CS`, `PS`, `PSA`, `PSB`, `PSC`, `PSD`, `UNIT`).
`isin_code`	string	ISIN da classe de ativo associada ao provento.
`declared_value`	number	Valor original do provento declarado pela companhia, sem correção monetária.
`monetary_correction`	number	Correção monetária deliberada pela companhia (ex.: SELIC, IPCA). `0` quando não aplicável.
`monetary_correction_start_date`	string (ISO 8601) \| null	Início do período de incidência da correção monetária. `null` quando não aplicável.
`monetary_correction_end_date`	string (ISO 8601) \| null	Fim do período de incidência da correção monetária. `null` quando não aplicável.
`value`	number	Valor bruto total do provento por ação (`declared_value` + `monetary_correction`).
`net_value`	number	Valor líquido efetivamente recebido pelo investidor, já descontados os impostos sobre a correção monetária e sobre o provento (ex.: 15% retidos na fonte em JCP).
`name`	string	Nome/tipo do provento (ex.: `Dividendo`, `Juros sobre capital próprio`).
`code`	string	Código do provento na CVM.
`installments`	array	Lista de parcelas quando o pagamento é dividido em múltiplas datas.
`adjusted_declared_value`	number	`declared_value` ajustado historicamente por eventos corporativos.
`adjusted_monetary_correction`	number	`monetary_correction` ajustada historicamente por eventos corporativos.
`adjusted_value`	number	`value` ajustado historicamente por eventos corporativos.
`adjusted_net_value`	number	`net_value` ajustado historicamente por eventos corporativos.
`adjustment_factor`	number	Fator de ajuste corporativo usado para converter valores históricos para base comparável atual.
`currency`	string	Moeda do valor retornado (ex.: `BRL`).
`source`	object	Metadados e links da fonte oficial do documento.

Estrutura de `installments[]`

Campo	Tipo	Descrição
`declared_value`	number	Valor declarado da parcela, sem correção monetária.
`monetary_correction`	number	Correção monetária da parcela.
`value`	number	Valor bruto da parcela (`declared_value` + `monetary_correction`).
`net_value`	number \| null	Valor líquido da parcela (após retenções, quando aplicável).
`adjusted_declared_value`	number \| null	`declared_value` da parcela ajustado por eventos corporativos.
`adjusted_monetary_correction`	number \| null	`monetary_correction` da parcela ajustada por eventos corporativos.
`adjusted_value`	number \| null	`value` da parcela ajustado por eventos corporativos.
`adjusted_net_value`	number \| null	`net_value` da parcela ajustado por eventos corporativos.
`currency`	string	Moeda da parcela.
`payment_date`	string (ISO 8601) \| null	Data de pagamento da parcela.

Sobre campos ajustados (adjusted_*)

Tudo que é adjusted é ajustado historicamente por eventos corporativos (como desdobramentos e grupamentos) para que o valor possa ser comparado de forma consistente com o preço atual da ação.

Exemplo

[
  {
    "approval_date": "2025-05-12T00:00:00.000Z",
    "created_at": "2026-04-01T19:48:11.424Z",
    "prior_ex_date": "2025-06-02T22:00:00.000Z",
    "protocol": "1376455",
    "publish_date": "2025-05-12T00:00:00.000Z",
    "id": "69cda0c3429753f6de4d0be0",
    "payment_date": "2025-08-20T13:00:00.000Z",
    "stock_type": "PS",
    "isin_code": "BRPETRACNPR6",
    "declared_value": 0.4545831,
    "monetary_correction": 0,
    "monetary_correction_start_date": null,
    "monetary_correction_end_date": null,
    "value": 0.4545831,
    "net_value": 0.386395635,
    "name": "Juros sobre capital próprio",
    "code": "56804",
    "adjusted_declared_value": 0.4545831,
    "adjusted_monetary_correction": 0,
    "adjusted_value": 0.4545831,
    "adjusted_net_value": 0.386395635,
    "adjustment_factor": 1,
    "currency": "BRL",
    "source": {
      "visualization_url": "https://www.rad.cvm.gov.br/ENET/frmExibirArquivoIPEExterno.aspx?NumeroProtocoloEntrega=1376455",
      "download_url": "https://www.rad.cvm.gov.br/ENET/frmExibirArquivoIPEExterno.aspx?NumeroProtocoloEntrega=1376455",
      "published_at": "2025-05-12T00:00:00.000Z",
      "retrieved_at": "2026-04-01T19:48:11.424Z",
      "name": "Juros sobre capital próprio (56804 - R$ 0.4545831)"
    }
  },
  {
    "approval_date": "2025-02-26T00:00:00.000Z",
    "created_at": "2026-04-01T19:48:11.424Z",
    "prior_ex_date": "2025-04-16T22:00:00.000Z",
    "protocol": "1377546",
    "publish_date": "2025-06-13T00:00:00.000Z",
    "id": "69cda0c3429753f6de4d0c37",
    "payment_date": null,
    "stock_type": "PS",
    "isin_code": "BRPETRACNPR6",
    "declared_value": 0.70954522,
    "monetary_correction": 0.0385848,
    "monetary_correction_start_date": null,
    "monetary_correction_end_date": null,
    "value": 0.73539415,
    "net_value": 0.72957814075,
    "name": "Dividendo",
    "code": "57535",
    "installments": [
      {
        "declared_value": 0.35477261,
        "monetary_correction": 0.01706013,
        "value": 0.37183274,
        "net_value": 0.36799421075,
        "adjusted_declared_value": 0.35477261,
        "adjusted_monetary_correction": 0.01706013,
        "adjusted_value": 0.37183274,
        "adjusted_net_value": 0.36799421075,
        "currency": "BRL",
        "payment_date": "2025-05-20T00:00:00.000Z"
      },
      {
        "declared_value": 0.35477261,
        "monetary_correction": 0.02152467,
        "value": 0.37629728,
        "net_value": 0.37145422925,
        "adjusted_declared_value": 0.35477261,
        "adjusted_monetary_correction": 0.02152467,
        "adjusted_value": 0.37629728,
        "adjusted_net_value": 0.37145422925,
        "currency": "BRL",
        "payment_date": "2025-06-20T00:00:00.000Z"
      }
    ],
    "adjusted_declared_value": 0.70954522,
    "adjusted_monetary_correction": 0.0385848,
    "adjusted_value": 0.73539415,
    "adjusted_net_value": 0.72957814075,
    "adjustment_factor": 1,
    "currency": "BRL",
    "source": {
      "visualization_url": "https://www.rad.cvm.gov.br/ENET/frmExibirArquivoIPEExterno.aspx?NumeroProtocoloEntrega=1377546",
      "download_url": "https://www.rad.cvm.gov.br/ENET/frmExibirArquivoIPEExterno.aspx?NumeroProtocoloEntrega=1377546",
      "published_at": "2025-06-13T00:00:00.000Z",
      "retrieved_at": "2026-04-01T19:48:11.424Z",
      "name": "Dividendo (57535 - R$ 0.73539415)"
    }
  }
]

Quando usar​

Parâmetros de requisição​

Resposta​

Formato da resposta​

Estrutura de installments[]​

Exemplo​