# Carteira de FIIs
URL: /docs/fiis/carteira.mdx

Consulte a composição normalizada da carteira dos FIIs: CRIs, cotas de outros FIIs, imóveis, direitos e terrenos.

***

title: Carteira de FIIs
description: >-
Consulte a composição normalizada da carteira dos FIIs: CRIs, cotas de outros
FIIs, imóveis, direitos e terrenos.
full: true
keywords: brapi, api, fii, carteira, portfolio, fof, cri, cotas de fii, cvm
openGraph:
title: Carteira de FIIs
description: Carteira normalizada de FIIs para FoFs, FIIs de papel e análise de composição.
type: website
locale: pt\_BR
lastUpdated: '2026-05-30T12:00:00.000Z'
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/fii/portfolio
structuredData:
headings: \[]
contents:

* content: >-
  Retorna a composição normalizada da carteira de FIIs agrupada por fundo.

***

import { Callout } from 'fumadocs-ui/components/callout';

Use este endpoint para responder “o que este FII possui?”. A resposta vem
agrupada por FII, com `summary`, `allocations`, `financialAssets`,
`fundHoldings`, `properties`, `lands` e `rights`.

<Callout type="info">
  Para imóveis físicos e vacância, prefira [`/api/v2/fii/properties`](/docs/fiis/imoveis).
  Este endpoint é melhor para FoFs, FIIs de papel, CRIs e composição geral.
</Callout>

<Callout type="info">
  Sandbox sem token: `symbols=HGLG11` e `symbols=MXRF11`. Para todos os FIIs,
  use um token Pro.
</Callout>

## Quando usar

* **FoFs:** use `fundHoldings` para ver cotas de outros FIIs.
* **FIIs de papel:** use `financialAssets` para CRIs, emissores e valores.
* **Carteiras híbridas:** use `allocations` para entender a composição.
* **Auditoria:** use `referenceDate` para travar um trimestre específico.
* **Evolução trimestral:** use [`/api/v2/fii/portfolio/history`](/docs/fiis/carteira-historico).





## Swagger Documentation

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

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

## Base URLs

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

## GET /api/v2/fii/portfolio

**Summary:** Obter Composição da Carteira


Retorna a composição normalizada da carteira dos FIIs a partir dos informes trimestrais da CVM. Use para entender o que um FII possui: CRIs, cotas de outros FIIs, imóveis, direitos e terrenos.

### Funcionalidades:
*   **Resposta agrupada por FII:** Cada fundo vem com resumo, alocações e listas por tipo de ativo.
*   **Múltiplos FIIs:** Consulte até 20 FIIs em uma única requisição.
*   **Filtro por trimestre:** Use `referenceDate=YYYY-MM-DD`. Sem esse parâmetro, retorna o trimestre mais recente disponível por FII.
*   **Versionamento:** Informes podem ter retificações. Por padrão, retorna apenas a versão mais recente do trimestre retornado. Use `allVersions=true` para todas as versões do trimestre consultado.
*   **Payload sob controle:** `summary` sempre vem. Use `include=allocations`, `include=financialAssets`, `include=fundHoldings`, `include=properties`, `include=lands` ou `include=rights` para escolher listas.

### Campos da Resposta:
*   **summary** — Totais por FII, valor declarado e vacância consolidada dos imóveis.
*   **allocations** — Contagem e valor por classe de ativo.
*   **financialAssets** — CRIs, cotas, SPEs e outros ativos financeiros.
*   **fundHoldings** — Cotas de outros FIIs, útil para FoFs.
*   **properties** — Imóveis físicos com área, endereço, vacância e participação na receita.

### 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
# Carteira mais recente do HGLG11
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/portfolio?symbols=HGLG11"

# Carteira em um trimestre específico
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/portfolio?symbols=HGLG11&referenceDate=2025-03-31"

# Apenas resumo e alocações
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/portfolio?symbols=HGLG11&include=allocations"
```

### Fonte dos Dados:
CVM (Informe Trimestral FII)

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


**Tags:** Fundos Imobiliários

### Parameters

- **symbols** (query) *required*
- **referenceDate** (query)
- **include** (query)
- **allVersions** (query)

### Responses

#### 200

Carteira detalhada dos FIIs retornada com sucesso.

#### 400

Requisição inválida

#### 401

Não autorizado

#### 403

Acesso negado

#### 404

Não encontrado

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


### FiiFinancialAsset

**Properties:**

- **assetClass** (string) *(required)*

- **name** (string) *(required)*

- **issuer** (string) *(nullable)* *(required)*

- **issuerCnpj** (string) *(nullable)* *(required)*

- **identifier** (string) *(nullable)* *(required)*

- **quantity** (number) *(nullable)* *(required)*

- **value** (number) *(nullable)* *(required)*

- **issue** (string) *(nullable)* *(required)*

- **series** (string) *(nullable)* *(required)*

- **ticker** (string) *(nullable)* *(required)*

- **maturityDate** (string) *(nullable)* *(required)*

- **confidential** (boolean) *(required)*


### FiiLand

**Properties:**

- **name** (string) *(required)*

- **identifier** (string) *(nullable)* *(required)*

- **address** (string) *(nullable)* *(required)*

- **area** (number) *(nullable)* *(required)*

- **investedShare** (number) *(nullable)* *(required)*

- **equityShare** (number) *(nullable)* *(required)*

- **confidential** (boolean) *(required)*


### FiiPortfolio

**Properties:**

- **symbol** (string) *(nullable)* *(required)*

- **cnpj** (string) *(required)*

- **referenceDate** (string) *(required)*

- **version** (number) *(required)*

- **summary** *(required)*
  Reference to: **FiiPortfolioSummary**

- **allocations** (array) *(required)*
  Array items:
    Reference to: **FiiPortfolioAllocation**

- **properties** (array) *(required)*
  Array items:
    Reference to: **FiiProperty**

- **financialAssets** (array) *(required)*
  Array items:
    Reference to: **FiiFinancialAsset**

- **fundHoldings** (array) *(required)*
  Array items:
    Reference to: **FiiFinancialAsset**

- **lands** (array) *(required)*
  Array items:
    Reference to: **FiiLand**

- **rights** (array) *(required)*
  Array items:
    Reference to: **FiiRight**


### FiiPortfolioAllocation

**Properties:**

- **assetClass** (string) *(required)*

- **count** (number) *(required)*

- **value** (number) *(nullable)* *(required)*


### FiiPortfolioResponse

**Properties:**

- **fiis** (array) *(required)*
  Array items:
    Reference to: **FiiPortfolio**

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

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


### FiiPortfolioSummary

**Properties:**

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

- **declaredValue** (number) *(nullable)* *(required)*

- **properties** *(required)*
  Reference to: **FiiPropertySummary**

- **financialAssets** (object) *(required)*
  **Properties:**

  - **count** (number) *(required)*

  - **declaredValue** (number) *(nullable)* *(required)*


- **lands** (object) *(required)*
  **Properties:**

  - **count** (number) *(required)*

  - **totalArea** (number) *(nullable)* *(required)*


- **rights** (object) *(required)*
  **Properties:**

  - **count** (number) *(required)*

  - **declaredValue** (number) *(nullable)* *(required)*



### FiiProperty

**Properties:**

- **name** (string) *(required)*

- **identifier** (string) *(nullable)* *(required)*

- **address** (string) *(nullable)* *(required)*

- **propertyClass** (string) *(nullable)* *(required)*

- **area** (number) *(nullable)* *(required)*

- **unitCount** (number) *(nullable)* *(required)*

- **vacancyRate** (number) *(nullable)* *(required)*

- **delinquencyRate** (number) *(nullable)* *(required)*

- **revenueShare** (number) *(nullable)* *(required)*

- **leasedRate** (number) *(nullable)* *(required)*

- **soldRate** (number) *(nullable)* *(required)*

- **constructionProgressActual** (number) *(nullable)* *(required)*

- **constructionProgressExpected** (number) *(nullable)* *(required)*

- **constructionCostActual** (number) *(nullable)* *(required)*

- **constructionCostExpected** (number) *(nullable)* *(required)*

- **investedShare** (number) *(nullable)* *(required)*

- **confidential** (boolean) *(required)*


### FiiPropertySummary

**Properties:**

- **count** (number) *(required)*

- **totalArea** (number) *(nullable)* *(required)*

- **vacancyRate** (number) *(nullable)* *(required)*

- **averageVacancyRate** (number) *(nullable)* *(required)*

- **propertiesWithVacancy** (number) *(required)*


### FiiRight

**Properties:**

- **name** (string) *(required)*

- **identifier** (string) *(nullable)* *(required)*

- **value** (number) *(nullable)* *(required)*

- **description** (string) *(nullable)* *(required)*

- **confidential** (boolean) *(required)*