---
title: "Listar Fundos Imobiliários"
method: GET
path: "/api/v2/fii/list"
tags: ["Fundos Imobiliários"]
---

# Listar Fundos Imobiliários

`GET /api/v2/fii/list`

Retorna a lista paginada de todos os Fundos de Investimento Imobiliário (FIIs) registrados, com dados do instrumento e indicadores atuais. Ideal para descobrir novos FIIs, comparar rentabilidades e construir carteiras diversificadas.

### Funcionalidades:
*   **Filtro por símbolos:** Consulte FIIs específicos com `symbols=HGLG11,MXRF11`
*   **Filtro por CNPJs:** Consulte FIIs específicos com `cnpjs=11728688000147`
*   **Busca por nome ou símbolo:** Encontre FIIs rapidamente por texto (ex: "hglg" retorna HGLG11)
*   **Filtros por segmento:** Papel (Títulos/CRI), Tijolo (Imóveis físicos), Híbrido (Misto), FOF (Fundo de Fundos)
*   **Filtros por setor:** Logística, Shoppings, Escritórios, Lajes Corporativas, Títulos e Val. Mob., Residencial, Hospital, Hotel, Educacional, Híbrido, Multicategoria, Varejo, Outros
*   **Filtros por mandato:** Renda, Híbrido, Títulos e Valores Mobiliários, etc.
*   **Filtros por tipo de gestão:** Ativa, Definida
*   **Dados do administrador:** Nome, CNPJ, endereço, telefones, site e email informados pela CVM
*   **Ordenação flexível:** Ordene por qualquer campo (DY, P/VP, Preço, Total de Investidores, etc.)
*   **Paginação:** Controle o número de resultados por página

### Autenticação:
Este endpoint lista o universo de FIIs e requer um token de API válido. Para testar sem token, filtre por símbolos sandbox com **MXRF11** ou **HGLG11**.

### Exemplos de Requisição:
```bash
# Listar todos os FIIs (primeiros 20)
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/list"

# Buscar FIIs específicos por símbolo
curl "https://brapi.dev/api/v2/fii/list?symbols=HGLG11,MXRF11"

# Buscar FII por CNPJ
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/list?cnpjs=11728688000147"

# Buscar FIIs por nome (ex: HGLG)
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/list?search=hglg"

# Filtrar por setor (Logística) e ordenar por Dividend Yield decrescente
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/list?segmentoAtuacao=Logística&sortBy=dividendYield12m&sortOrder=desc&limit=10"

# Filtrar por tipo de segmento (Tijolo) e tipo de gestão (Ativa)
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/list?segmentType=tijolo&tipoGestao=Ativa&page=1&limit=20"
```

### FIIs Populares:
MXRF11 (Multisegmento), HGLG11 (Logística), KNCR11 (Logística), XPLG11 (Logística), XPML11 (Logística), KNRI11 (Renda), BTLG11 (Logística), VISC11 (Varejo)

### Fonte dos Dados:
CVM (Comissão de Valores Mobiliários)

**Plano Mínimo:** Pro
**Autenticação:** Necessária para listagem completa

## Query parameters

- `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)
- `sortBy` string — Campo para ordenação
- `sortOrder` 'asc' | 'desc' — Direção da ordenação
- `symbols` string — Lista de símbolos de FIIs separados por vírgula. Máximo de 20 símbolos.
- `cnpjs` string — Lista de CNPJs de FIIs separados por vírgula, com ou sem formatação. Máximo de 20 CNPJs.
- `search` string — Buscar por nome, símbolo ou CNPJ
- `segmentType` 'papel' | 'tijolo' | 'hibrido' | 'fof' — Tipo de segmento do indicador
- `segmentoAtuacao` string — Segmento de atuação (Logística, Shoppings, Escritórios, etc.)
- `mandate` string — Mandato (Renda, Híbrido, Títulos e Valores Mobiliários, etc.)
- `tipoGestao` string — Tipo de gestão (Ativa, Definida)

## Response `200`

Lista paginada de FIIs com indicadores retornada com sucesso.

- FiiListResponse
  - `fiis` FiiListItem[], required
    - `symbol` string, nullable, required
    - `name` string, nullable, required
    - `cnpj` string, nullable, required
    - `mandate` string, nullable, required
    - `segmentoAtuacao` string, nullable, required
    - `tipoGestao` string, nullable, 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
    - `price` number, nullable, required
    - `navPerShare` number, nullable, required
    - `priceToNav` number, nullable, required
    - `dividendYield12m` number, nullable, required
    - `totalInvestors` number, nullable, required
    - `segmentType` string, 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

- `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/versions/f275d46193ea/schema)