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

# Obter Relatórios Gerenciais

`GET /api/v2/fii/reports`

Retorna os relatórios gerenciais mensais publicados na CVM, com composição patrimonial detalhada. Analise a alocação de ativos, estrutura de passivos e evolução do patrimônio dos FIIs.

### Funcionalidades:
*   **Relatórios mensais:** Um relatório por mês para cada FII
*   **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)
*   **Versionamento:** Relatórios podem ter múltiplas versões (retificações). Por padrão, retorna apenas a mais recente. Use `allVersions=true` para todas as versões.
*   **Paginação:** Controle o número de resultados por página
*   **Ordenação:** Ordene por qualquer campo (referenceDate, totalAssets, equity, etc.)

### KPIs Inclusos:
*   **Ativo Total** — Patrimônio total do fundo (R$)
*   **Patrimônio Líquido** — Equity (R$)
*   **Cotas** — Número de cotas emitidas
*   **VP/Cota** — Valor Patrimonial por Cota (R$)
*   **Taxa de Administração** — Taxa anual (%)
*   **Retorno Mensal** — Retorno do mês (%)
*   **Dividend Yield Mensal** — DY do mês (%)
*   **Total de Investidores** — Número de cotistas

### Composição de Ativos:
*   **Caixa** — Disponibilidades (R$)
*   **Títulos Públicos** — Tesouro Direto, LTN, etc. (R$)
*   **Títulos Privados** — Debêntures, CDB, etc. (R$)
*   **Fundos RF** — Fundos de Renda Fixa (R$)
*   **Imóveis** — Propriedades físicas (R$)
*   **CRI** — Certificados de Recebíveis Imobiliários (R$)
*   **LCI** — Letras de Crédito Imobiliário (R$)
*   **Cotas de FIIs** — Investimentos em outros FIIs (R$)
*   **Recebíveis** — Aluguéis, rendas a receber (R$)

### Composição de Passivos:
*   **Distribuições a Pagar** — Proventos não pagos (R$)
*   **Taxas Admin a Pagar** — Taxas de administração (R$)
*   **Obrigações Imobiliárias** — Financiamentos, empréstimos (R$)
*   **Total de Passivos** — Soma de todas as obrigações (R$)

### Administrador:
*   **administratorName** — Nome da instituição administradora
*   **administratorCnpj** — CNPJ da instituição administradora
*   **administratorAddress**, **administratorAddressNumber**, **administratorAddressComplement** — Endereço informado à CVM
*   **administratorDistrict**, **administratorCity**, **administratorState**, **administratorZipCode** — Localização do administrador
*   **administratorPhone1**, **administratorPhone2**, **administratorPhone3** — Telefones de contato
*   **administratorWebsite**, **administratorEmail** — Site e email de contato

### 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
# Relatórios dos últimos 12 meses (apenas versão mais recente)
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/reports?symbols=HGLG11"

# Relatórios em período específico com paginação
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/reports?symbols=MXRF11,KNCR11&startDate=2024-01-01&endDate=2024-12-31&page=1&limit=10"

# Todas as versões dos relatórios (incluindo retificações)
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/reports?symbols=XPLG11&allVersions=true&sortBy=referenceDate&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
- `page` integer — Página (começa em 1)
- `limit` integer — Itens por página (sem limite rígido; valores altos como 10000 são aceitos)
- `allVersions` 'true' | 'false' — Incluir todas as versões dos relatórios (padrão: false, retorna apenas a mais recente)

## Response `200`

Relatórios mensais paginados dos FIIs retornados com sucesso.

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