Eventos corporativos

GET

/companies/[companyIdentifier]/corporate-actions

Retorna uma lista de eventos corporativos em ações (ex.: desdobramentos, grupamentos, bonificações e outros eventos societários) para uma empresa específica.
Os registros já vêm prontos para uso em UI (timeline), alertas e conciliação com fonte oficial.

Quando usar

• Montar uma timeline/calendário de eventos corporativos de uma empresa
• Criar alertas (ex.: “vai ter grupamento/desdobramento”)
• Fazer automações de carteira (ex.: ajuste de quantidade e preço médio)
• Filtrar por janela de datas usando start_date e end_date

Parâmetros de requisição

Parâmetro	Local	Descrição	Obrigatório
[companyIdentifier]	URL	Identificador da empresa (symbol, company_id ou ticker).	Obrigatório
start_date	Query	ISO 8601. Filtra por prior_ex_date a partir desta data.	Opcional
end_date	Query	ISO 8601. Filtra por prior_ex_date até esta data.	Opcional

Boas práticas

• Para uma timeline “limpa”, aplique uma janela de datas.
• Se você quer apenas um período específico, use start_date e end_date no mesmo request.

Resposta

Código	Descrição
200	Retorna os eventos corporativos em ações.
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
prior_ex_date	string (ISO 8601)	Data-base/data-com usada para ordenação e filtro.
stock_dividend_type	string	Tipo do evento (ex.: DESDOBRAMENTO, GRUPAMENTO, BONIFICACAO).
factor	number	Fator do evento (ex.: 100 em desdobramento 1:100; 0.01 em grupamento 100:1).
isin_code	string	ISIN original associado ao evento.
issued_asset_isin_code	string	ISIN resultante/emitido (quando aplicável).
remarks	string	Observações/texto livre (quando disponível).

Exemplo

[
  {
    "prior_ex_date": "2008-04-25T00:00:00.000Z",
    "stock_dividend_type": "DESDOBRAMENTO",
    "factor": 100,
    "isin_code": "BRPETRACNOR9",
    "issued_asset_isin_code": "BRPETRACNOR9",
    "remarks": ""
  },
  {
    "prior_ex_date": "2000-06-21T00:00:00.000Z",
    "stock_dividend_type": "GRUPAMENTO",
    "factor": 0.01,
    "isin_code": "BRPETRACNPR6",
    "issued_asset_isin_code": "BRPETRACNPR6",
    "remarks": ""
  },
  {
    "prior_ex_date": "1994-03-25T00:00:00.000Z",
    "stock_dividend_type": "BONIFICACAO",
    "factor": 33.333333333,
    "isin_code": "BRPETRACNOR9",
    "issued_asset_isin_code": "BRPETRACNOR9",
    "remarks": ""
  }
]