---
title: "Relatórios financeiros DFIN de FIIs"
method: GET
path: "/api/v2/fii/financials"
tags: ["Fundos Imobiliários"]
---

# Relatórios financeiros DFIN de FIIs

`GET /api/v2/fii/financials`

Consulta dados financeiros estruturados de FIIs provenientes dos documentos DFIN oficiais da CVM. Aceita símbolo ou CNPJ.

## Query parameters

- `symbols` string — Símbolos de FIIs separados por vírgula (máximo 20)
- `cnpjs` string — CNPJs separados por vírgula, com ou sem formatação
- `year` integer, nullable — Ano do documento
- `startDate` string — Data inicial em YYYY-MM-DD
- `endDate` string — Data final em YYYY-MM-DD
- `sortBy` string — Campo de ordenação: referenceDate, symbol, cnpj, year
- `sortOrder` 'asc' | 'desc'
- `page` integer
- `limit` integer

## Response `200`

Relatórios financeiros

- object
  - `financials` FiiFinancialReport[], required
    - `symbol` string, nullable, required
    - `cnpj` string, required
    - `year` number, required
    - `referenceDate` string, required
    - `documentType` string, required
    - `fields` object, nullable, required
  - `pagination` PaginationMeta, required
    - `page` number, required
    - `limit` number, required
    - `totalItems` number, required
    - `totalPages` number, required
    - `hasNextPage` boolean, 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/versions/f275d46193ea/schema)