# Relatórios mensais de FIIs
URL: /docs/fiis/relatorios.mdx

Informes mensais de FIIs entregues à CVM: patrimônio, cotas, taxas, retorno e composição do ativo e passivo.





## Swagger Documentation

# brapi - API do Mercado Financeiro Brasileiro - /api/v2/fii/reports

Single endpoint documentation for /api/v2/fii/reports

## Base URLs

- `https://brapi.dev` - Servidor principal da API brapi
- `http://localhost:3001` - Servidor local para desenvolvimento

## GET /api/v2/fii/reports

**Summary:** Relatórios mensais de FIIs


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.


**Tags:** Fundos Imobiliários

### Parameters

- **symbols** (query) *required*
- **startDate** (query)
- **endDate** (query)
- **sortBy** (query)
- **sortOrder** (query)
- **page** (query)
- **limit** (query)
- **allVersions** (query)

### Responses

#### 200

Relatórios mensais paginados.

#### 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.

## Schemas

The following schemas are used by this endpoint:

### ErrorResponse

Erro interno do servidor.

**Properties:**

- **error** (boolean) - Options: `true` *(required)*

- **message** (string) *(required)*

- **code** (string)


### FiiMonthlyReport

**Properties:**

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


### FiiReportsResponse

**Properties:**

- **reports** (array) *(required)*
  Array items:
    Reference to: **FiiMonthlyReport**

- **pagination** *(required)*
  Reference to: **PaginationMeta**

- **requestedAt** (string, date-time) *(required)*
  Data e hora da requisição em ISO 8601.

- **took** (integer) *(required)*
  Tempo de processamento, em milissegundos.


### PaginationMeta

**Properties:**

- **page** (number) *(required)*

- **limit** (number) *(required)*

- **totalItems** (number) *(required)*

- **totalPages** (number) *(required)*

- **hasNextPage** (boolean) *(required)*