---
title: "Dividendos v2 de ações"
method: GET
path: "/api/v2/stocks/dividends"
tags: ["Ações"]
---

# Dividendos v2 de ações

`GET /api/v2/stocks/dividends`

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.

## Query parameters

- `symbols` string, required — Tickers separados por vírgula. Ex.: PETR4,VALE3. Tickers antigos são resolvidos para o ticker atual quando houver renome conhecido.
- `startDate` string — Data inicial em YYYY-MM-DD. Filtra por paymentDate/ex-date.
- `endDate` string — Data final em YYYY-MM-DD. Filtra por paymentDate/ex-date.
- `sortBy` 'paymentDate' | 'lastDatePrior' | 'approvedOn' | 'rate' — Campo usado para ordenar eventos.
- `sortOrder` 'asc' | 'desc' — Ordenação dos eventos.

## Response `200`

Dividendos recuperados com sucesso.

- StockDividendsResponse
  - `results` StockDividendsSeries[], required
    - `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` DividendsData, required — Dados de dividendos (quando dividends=true)
      - `cashDividends` object[], required — Histórico de dividendos e JCP em dinheiro
        - `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` object[], required — Histórico de bonificações e desdobramentos
        - `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` unknown[], required — Histórico de subscrições
        - unknown
  - `requestedAt` string, date-time, required — Data e hora da requisição em formato ISO 8601
  - `took` integer, required — Tempo de processamento em milissegundos

## Other responses

- `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

---

[API](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) · [All operations](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brapi-dev/brapi-api-do-mercado-financeiro-brasileiro/revisions/f275d46193ea/schema)