# Dividendos de Ações
URL: /docs/acoes/dividendos.mdx

Dividendos, JCP e eventos de ações para ativos B3 stock-like no padrão composável /api/v2/stocks.

***

title: Dividendos de Ações
description: >-
Dividendos, JCP e eventos de ações para ativos B3 stock-like no padrão
composável /api/v2/stocks.
full: true
keywords: brapi, api, ações, dividendos, jcp, proventos, stocks, v2, b3
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/stocks/dividends
-------------------------------

Endpoint para buscar dividendos, JCP e eventos de ações de um ou mais
tickers B3 stock-like. Use quando você precisa apenas de proventos, sem
carregar cotação, histórico ou módulos financeiros.

Este endpoint é para ações e instrumentos stock-like. Rendimentos de FIIs
continuam no endpoint dedicado `/api/v2/fii/dividends`, que tem fonte e
semântica próprias para FIIs.

Tickers antigos são resolvidos para o ticker atual quando houver renome
conhecido, e a resposta inclui `requestedSymbol`, `symbol` e `changed`.





## Swagger Documentation

# brapi - API do Mercado Financeiro Brasileiro - /api/v2/stocks/dividends

Single endpoint documentation for /api/v2/stocks/dividends

## Base URLs

- `https://brapi.dev` - Servidor principal da API brapi
- `http://localhost:3001` - Servidor local para desenvolvimento

## GET /api/v2/stocks/dividends

**Summary:** Dividendos v2 de ações


Retorna dividendos, JCP e eventos de ações para tickers B3 stock-like.

Este endpoint substitui o uso de `/api/quote/{tickers}?dividends=true` para
novas integrações que precisam apenas de proventos de ações. Para rendimentos
de FIIs, use `/api/v2/fii/dividends`, que possui uma fonte e semântica
específicas para FIIs.


**Tags:** Ações

### Parameters

- **symbols** (query) *required*
- **startDate** (query)
- **endDate** (query)
- **sortBy** (query)
- **sortOrder** (query)

### Responses

#### 200

Dividendos recuperados com sucesso.

#### 400

Requisição inválida

#### 401

Não autorizado

#### 403

Acesso negado

#### 404

Não encontrado

#### 429

Limite de requisições excedido

#### 500

Erro interno do servidor

## Schemas

The following schemas are used by this endpoint:

### DividendsData

Dados de dividendos (quando dividends=true)

**Properties:**

- **cashDividends** (array) *(required)*
  Histórico de dividendos e JCP em dinheiro
  Array items:
    **Properties:**

    - **assetIssued** (string) *(required)*
      Código ISIN do ativo emissor

    - **paymentDate** (string) *(nullable)* *(required)*
      Data de pagamento

    - **rate** (number) *(required)*
      Valor por ação

    - **relatedTo** (string) *(required)*
      Período de referência

    - **approvedOn** (string) *(nullable)* *(required)*
      Data de aprovação

    - **isinCode** (string) *(required)*
      Código ISIN

    - **label** (string) *(required)*
      Tipo (DIVIDENDO, JCP)

    - **lastDatePrior** (string) *(nullable)* *(required)*
      Data-com (último dia antes da data ex)

    - **remarks** (string) *(required)*
      Observações


- **stockDividends** (array) *(required)*
  Histórico de bonificações e desdobramentos
  Array items:
    **Properties:**

    - **assetIssued** (string) *(required)*
      Código ISIN do ativo emissor

    - **factor** (number) *(required)*
      Fator do desdobramento/grupamento

    - **completeFactor** (string) *(required)*
      Fator completo (ex: 2 para 1)

    - **approvedOn** (string) *(nullable)* *(required)*
      Data de aprovação

    - **isinCode** (string) *(required)*
      Código ISIN

    - **label** (string) *(required)*
      Tipo (DESDOBRAMENTO, GRUPAMENTO)

    - **lastDatePrior** (string) *(nullable)* *(required)*
      Data de corte

    - **remarks** (string) *(required)*
      Observações


- **subscriptions** (array) *(required)*
  Histórico de subscrições
  Array items:


### ErrorResponse

Erro interno do servidor

**Properties:**

- **error** (boolean) - Options: `true` *(required)*

- **message** (string) *(required)*

- **code** (string)


### StockDividendsResponse

**Properties:**

- **results** (array) *(required)*
  Array items:
    Reference to: **StockDividendsSeries**

- **requestedAt** (string, date-time) *(required)*
  Data e hora da requisição em formato ISO 8601

- **took** (integer) *(required)*
  Tempo de processamento em milissegundos


### StockDividendsSeries

**Properties:**

- **requestedSymbol** (string) *(required)*
  Ticker informado na requisição.

- **symbol** (string) *(required)*
  Ticker retornado pela brapi após normalização/renome.

- **changed** (boolean) *(required)*
  `true` quando o ticker informado foi resolvido para outro ticker.

- **data** *(required)*
  Reference to: **DividendsData**