---
title: "Carteira de FIIs"
method: GET
path: "/api/v2/fii/portfolio"
tags: ["Fundos Imobiliários"]
---

# Carteira de FIIs

`GET /api/v2/fii/portfolio`

## Request

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

Composição da carteira de FIIs pelo informe trimestral da CVM: imóveis, CRIs e outros ativos financeiros, cotas de outros FIIs, terrenos e direitos, com totais em `summary`.

Use para analisar FIIs de papel e fundos de fundos, ver os CRIs de um fundo ou somar a exposição por classe de ativo.

`include` escolhe as listas. Sem `include`, retorna todas. `summary` sempre vem.

Em fundos de fundos, `fundHoldings` lista as cotas de outros FIIs. Em FIIs de papel, `financialAssets` lista os CRIs com emissor e valor. `allocations` resume a carteira por classe de ativo.

Sem `referenceDate`, retorna o trimestre mais recente de cada fundo. Informes podem ser retificados. O padrão retorna a versão mais recente, e `allVersions=true` retorna todas.

Para imóveis e vacância, use [imóveis de FIIs](https://brapi.dev/docs/fiis/imoveis). Para a série no tempo, use o [histórico da carteira](https://brapi.dev/docs/fiis/carteira-historico).

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.
- `referenceDate` string: Fim do trimestre no formato YYYY-MM-DD. Sem valor, retorna o trimestre mais recente de cada FII.
- `include` string: Listas a retornar, separadas por vírgula: allocations, properties, financialAssets, fundHoldings, lands, rights. summary sempre vem. Sem valor, retorna todas.
- `allVersions` 'true' | 'false': true inclui todas as versões do trimestre. false retorna só a mais recente.

## Response `200`

Carteira dos FIIs.

- 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 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.
- `404`: Nenhum dado encontrado para o pedido.
- `500`: Erro interno do servidor.

## Changes

- **2026-06-01** `1b9fbb8c8f26`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/fii/portfolio/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)