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

# Relatórios mensais de FIIs

`GET /api/v2/fii/reports`

## Request

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

Informe mensal que cada FII entrega à CVM: patrimônio, cotas, valor patrimonial por cota, taxa de administração, retorno e yield do mês, cotistas, e a composição do ativo e do passivo.

Use para ver a composição do patrimônio, acompanhar taxas e comparar o retorno mensal entre fundos.

O ativo separa caixa, títulos públicos e privados, fundos de renda fixa, imóveis, CRI, LCI, cotas de outros FIIs e recebíveis. O passivo separa distribuições a pagar, taxas a pagar e obrigações imobiliárias.

Sem `startDate` e `endDate`, retorna os últimos 12 meses. O padrão retorna a versão mais recente de cada mês, e `allVersions=true` inclui as versões retificadas. `sortBy` aceita `referenceDate` (padrão), `symbol`, `totalAssets`, `equity`, `navPerShare`, `monthlyReturn`, `monthlyDividendYield`, `totalInvestors` e `version`.

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.
- `page` integer: Número da página, a partir de 1.
- `limit` integer: Itens por página. Não há limite máximo.
- `allVersions` 'true' | 'false': true inclui todas as versões de cada mês. false retorna só a mais recente.

## Response `200`

Relatórios mensais paginados.

- FiiReportsResponse
  - `reports` FiiMonthlyReport[], required
    - `symbol` string, nullable, required
    - `name` string, nullable, required
    - `cnpj` string, required
    - `administratorName` string, nullable, required
    - `administratorCnpj` string, nullable, required
    - `administratorAddress` string, nullable, required
    - `administratorAddressNumber` string, nullable, required
    - `administratorAddressComplement` string, nullable, required
    - `administratorDistrict` string, nullable, required
    - `administratorCity` string, nullable, required
    - `administratorState` string, nullable, required
    - `administratorZipCode` string, nullable, required
    - `administratorPhone1` string, nullable, required
    - `administratorPhone2` string, nullable, required
    - `administratorPhone3` string, nullable, required
    - `administratorWebsite` string, nullable, required
    - `administratorEmail` string, nullable, required
    - `referenceDate` string, required
    - `version` number, required
    - `totalAssets` number, nullable, required
    - `equity` number, nullable, required
    - `sharesOutstanding` number, nullable, required
    - `navPerShare` number, nullable, required
    - `adminFeeRate` number, nullable, required
    - `monthlyReturn` number, nullable, required
    - `monthlyPatrimonialReturn` number, nullable, required
    - `monthlyDividendYield` number, nullable, required
    - `amortizationRate` number, nullable, required
    - `totalInvestors` number, nullable, required
    - `cash` number, nullable, required
    - `liquidityNeeds` number, nullable, required
    - `governmentBonds` number, nullable, required
    - `privateBonds` number, nullable, required
    - `fixedIncomeFunds` number, nullable, required
    - `totalInvested` number, nullable, required
    - `realEstateAssets` number, nullable, required
    - `realEstateCompanyShares` number, nullable, required
    - `realEstateCompanyUnits` number, nullable, required
    - `cri` number, nullable, required
    - `lci` number, nullable, required
    - `fiiHoldings` number, nullable, required
    - `receivables` number, nullable, required
    - `rentalReceivables` number, nullable, required
    - `otherReceivables` number, nullable, required
    - `distributionsPayable` number, nullable, required
    - `adminFeesPayable` number, nullable, required
    - `realEstateObligations` number, nullable, required
    - `totalLiabilities` number, 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 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-05-22** `c9743d203cb0`: 4 info
  - added the required property `reports/items/liquidityNeeds` to the response with the `200` status
  - added the required property `reports/items/otherReceivables` to the response with the `200` status
  - added the required property `reports/items/realEstateCompanyShares` to the response with the `200` status
  - added the required property `reports/items/realEstateCompanyUnits` to the response with the `200` status
- **2026-04-26** `3ae1b2752c0b`: 14 info
  - added the required property `reports/items/administratorAddress` to the response with the `200` status
  - added the required property `reports/items/administratorAddressComplement` to the response with the `200` status
  - added the required property `reports/items/administratorAddressNumber` to the response with the `200` status
  - added the required property `reports/items/administratorCity` to the response with the `200` status
  - …10 more
- **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/reports/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)