---
title: "Obter Composição da Carteira"
method: GET
path: "/api/v2/fii/portfolio"
tags: ["Fundos Imobiliários"]
---

# Obter Composição da Carteira

`GET /api/v2/fii/portfolio`

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)

## Query parameters

- `symbols` string, required — Símbolos separados por vírgula (máximo 20). Exemplo: HGLG11,MXRF11
- `referenceDate` string — Data de referência trimestral no formato YYYY-MM-DD. Se omitida, retorna o trimestre mais recente por FII.
- `include` string — Listas separadas por vírgula: allocations, properties, financialAssets, fundHoldings, lands, rights. summary sempre é retornado. Se omitido, retorna todas as listas.
- `allVersions` 'true' | 'false' — Incluir todas as versões do trimestre retornado (padrão: false, retorna apenas a mais recente)

## Response `200`

Carteira detalhada dos FIIs retornada com sucesso.

- FiiPortfolioResponse
  - `fiis` FiiPortfolio[], required
    - `symbol` string, nullable, required
    - `cnpj` string, required
    - `referenceDate` string, required
    - `version` number, required
    - `summary` FiiPortfolioSummary, required
      - `totalItems` number, required
      - `declaredValue` number, nullable, required
      - `properties` FiiPropertySummary, required
        - `count` number, required
        - `totalArea` number, nullable, required
        - `vacancyRate` number, nullable, required
        - `averageVacancyRate` number, nullable, required
        - `propertiesWithVacancy` number, required
      - `financialAssets` object, required
        - `count` number, required
        - `declaredValue` number, nullable, required
      - `lands` object, required
        - `count` number, required
        - `totalArea` number, nullable, required
      - `rights` object, required
        - `count` number, required
        - `declaredValue` number, nullable, required
    - `allocations` FiiPortfolioAllocation[], required
      - `assetClass` string, required
      - `count` number, required
      - `value` number, nullable, required
    - `properties` FiiProperty[], required
      - `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
    - `financialAssets` FiiFinancialAsset[], required
      - `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
    - `fundHoldings` FiiFinancialAsset[], required
      - `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
    - `lands` FiiLand[], required
      - `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
    - `rights` FiiRight[], required
      - `name` string, required
      - `identifier` string, nullable, required
      - `value` number, nullable, required
      - `description` string, nullable, required
      - `confidential` 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
- `404` — Não encontrado
- `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)