---
title: "Dividendos de FIIs"
method: GET
path: "/api/v2/fii/dividends"
tags: ["Fundos Imobiliários"]
---

# Dividendos de FIIs

`GET /api/v2/fii/dividends`

## Request

- Base URL: `https://brapi.dev`
- URL: `https://brapi.dev/api/v2/fii/dividends`
- Auth: HTTP bearer

Rendimentos e amortizações pagos por FIIs. Cada evento traz tipo (`label`), valor por cota em reais (`rate` e `rawRate`), data-com (`lastDatePrior`), data de pagamento, data de aprovação e ISIN.

Use para calcular dividend yield, montar calendários de rendimentos e somar a renda de uma carteira.

`rate` está na escala das cotações ajustadas por desdobramentos e grupamentos. Divida por `close` do histórico para ter o yield. `rawRate` é o valor pago na data. Some `rawRate` para calcular a renda recebida.

`label` é RENDIMENTO ou AMORTIZAÇÃO. Amortização devolve capital e reduz o valor patrimonial da cota. Não some as duas para calcular yield.

Os dados vêm dos informes mensais da CVM e de comunicados dos administradores. Quando a fonte não tem as datas reais, `paymentDate` e `lastDatePrior` recebem a data de referência do informe mensal, e `remarks` indica a origem. A data inicial varia por fundo.

`startDate` e `endDate` filtram por `paymentDate`. Sem `startDate`, começa 12 meses atrás. Sem `endDate`, não tem limite final e inclui pagamentos já anunciados com data futura. `sortBy` aceita `paymentDate` (padrão), `lastDatePrior`, `approvedOn`, `rate` e `symbol`.

Plano Pro. Sem token, aceita só `symbols` com MXRF11 e HGLG11.

## Query parameters

- `symbols` string, required: Tickers de FIIs separados por vírgula, até 20. Ex.: HGLG11,MXRF11.
- `startDate` string: Data inicial no formato YYYY-MM-DD.
- `endDate` string: Data final no formato YYYY-MM-DD.
- `sortBy` string: Campo de ordenação.
- `sortOrder` 'asc' | 'desc': Direção da ordenação.

## Response `200`

Rendimentos e amortizações dos FIIs.

- FiiDividendsResponse
  - `dividends` FiiDividend[], required
    - `symbol` string, required
    - `approvedOn` string, nullable, required
    - `label` string, required
    - `lastDatePrior` string, required
    - `exDate` string, nullable, required
    - `paymentDate` string, required
    - `rate` number, required: Valor por cota, em reais, na escala das cotações ajustadas por desdobramentos e grupamentos (`close` do histórico). Um rendimento anterior a um desdobramento de 1 para 10 aparece dividido por 10.
    - `rawRate` number, required: Valor pago por cota na data do rendimento, sem ajuste. Use para somar a renda recebida.
    - `relatedTo` string, nullable, required
    - `isinCode` string, nullable, required
    - `remarks` string, nullable, required
    - `verified` boolean, required: `true` quando o provento foi conferido em um documento publicado pela empresa ou pelo fundo. `false` quando vem de dados históricos que ainda não têm esse documento.
  - `requestedAt` string, date-time, required: Data e hora da requisição em ISO 8601.
  - `took` integer, required: Tempo de processamento, em milissegundos.

## Other responses

- `400`: Requisição inválida. Confira os parâmetros.
- `401`: Token ausente ou inválido.
- `403`: O plano não inclui este recurso ou parâmetro.
- `500`: Erro interno do servidor.

## Changes

- **2026-10-31** `8dd3e799f599`: 1 info
  - added the required property `dividends/items/rawRate` to the response with the `200` status
- **2026-10-16** `62eafb05acb0`: 1 info
  - added the required property `dividends/items/verified` to the response with the `200` status
- **2026-09-04** `623e15020627`: 1 info
  - added the required property `dividends/items/exDate` to the response with the `200` status
- **2026-04-07** `19f807c15a24`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/fii/dividends/get.md)

---

[API](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) - [All operations](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) - [OpenAPI document](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/revisions/7c732d79148a?raw)