---
title: "Obter Histórico de Proventos"
method: GET
path: "/api/v2/fii/dividends"
tags: ["Fundos Imobiliários"]
---

# Obter Histórico de Proventos

`GET /api/v2/fii/dividends`

Retorna o histórico de pagamentos de proventos (Rendimentos, Amortizações) dos FIIs. Analise a rentabilidade histórica e padrões de distribuição de cada fundo.

### Funcionalidades:
*   **Histórico completo:** Rendimentos e amortizações desde a criação do fundo
*   **Múltiplos FIIs:** Consulte até 20 FIIs em uma única requisição
*   **Filtro por período:** Especifique startDate e endDate (padrão: últimos 12 meses)
*   **Ordenação:** Ordene por data de pagamento, taxa, data de aprovação, etc.
*   **Tipos de proventos:** Rendimentos (distribuições mensais) e Amortizações (devolução de capital)

### Campos da Resposta:
*   **symbol** — Ticker do FII
*   **label** — Tipo do provento (RENDIMENTO, AMORTIZAÇÃO)
*   **rate** — Valor por cota distribuído (R$)
*   **paymentDate** — Data efetiva de pagamento quando disponível; quando a data real não estiver disponível, pode usar a data de referência informada pela CVM
*   **lastDatePrior** — Data-com (último dia para ter direito ao provento)
*   **approvedOn** — Data de aprovação do provento
*   **relatedTo** — Período relacionado (quando aplicável)
*   **isinCode** — Código ISIN (quando aplicável)
*   **remarks** — Observações sobre a origem do registro, quando aplicável

### Importante:
Quando disponível, `paymentDate` representa a data efetiva de pagamento. Para alguns fundos e períodos, a CVM informa apenas a data de referência do relatório; nesses casos, `paymentDate` pode coincidir com essa referência.

### Autenticação:
Os FIIs **MXRF11** e **HGLG11** podem ser consultados sem autenticação para testes. Para acessar outros FIIs, é necessário um token de API válido.

### Exemplos de Requisição:
```bash
# Histórico de proventos dos últimos 12 meses
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/dividends?symbols=HGLG11"

# Histórico em período específico, ordenado por data decrescente
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/dividends?symbols=MXRF11,KNCR11&startDate=2023-01-01&endDate=2024-12-31&sortBy=paymentDate&sortOrder=desc"
```

### Fonte dos Dados:
CVM (Comissão de Valores Mobiliários)

**Plano Mínimo:** Pro
**Autenticação:** Necessária (exceto MXRF11 e HGLG11)

## Query parameters

- `symbols` string, required — Símbolos separados por vírgula (máximo 20). Exemplo: HGLG11,MXRF11
- `startDate` string — Data de início no formato YYYY-MM-DD
- `endDate` string — Data de fim no formato YYYY-MM-DD
- `sortBy` string — Campo para ordenação
- `sortOrder` 'asc' | 'desc' — Direção da ordenação

## Response `200`

Histórico de rendimentos dos FIIs retornado com sucesso.

- FiiDividendsResponse
  - `dividends` FiiDividend[], required
    - `symbol` string, required
    - `approvedOn` string, nullable, required
    - `label` string, required
    - `lastDatePrior` string, required
    - `paymentDate` string, required
    - `rate` number, required
    - `relatedTo` string, nullable, required
    - `isinCode` string, nullable, required
    - `remarks` string, nullable, required
  - `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
- `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)