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

# Listar FIIs

`GET /api/v2/fii/list`

## Request

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

Lista paginada de FIIs com dados cadastrais, dados do administrador e indicadores atuais: preço, valor patrimonial por cota, P/VP, dividend yield de 12 meses e total de cotistas.

Use para montar um screener, filtrar fundos por segmento ou achar o ticker de um CNPJ.

`search` busca no nome, no ticker e no CNPJ. `segmentoAtuacao` aceita valores como Logística, Shoppings, Escritórios, Lajes Corporativas, Títulos e Val. Mob., Residencial, Hospital, Hotel, Educacional, Híbrido, Multicategoria, Varejo e Outros.

`sortBy` aceita `symbol`, `name`, `segmentoAtuacao`, `mandate`, `price`, `navPerShare`, `priceToNav`, `dividendYield12m` e `totalInvestors`. O padrão é `totalInvestors`.

Nem todo ticker terminado em 11 é FII. FI-Infra (como JURO11), FIAGRO, FIDC e FIP ficam em [fundos](https://brapi.dev/docs/fundos).

Plano Pro. Sem token, aceita só `symbols` ou `cnpjs` de MXRF11 e HGLG11.

## Query parameters

- `page` integer: Número da página, a partir de 1.
- `limit` integer: Itens por página. Não há limite máximo.
- `sortBy` string: Campo de ordenação.
- `sortOrder` 'asc' | 'desc': Direção da ordenação.
- `symbols` string: Tickers de FIIs separados por vírgula, até 20.
- `cnpjs` string: CNPJs de FIIs separados por vírgula, até 20. Aceita com ou sem pontuação.
- `search` string: Texto buscado no nome, no ticker ou no CNPJ.
- `segmentType` 'papel' | 'tijolo' | 'hibrido' | 'fof': Tipo do fundo: papel, tijolo, hibrido ou fof.
- `segmentoAtuacao` string: Setor de atuação. Ex.: Logística, Shoppings, Escritórios.
- `mandate` string: Mandato do fundo. Ex.: Renda, Híbrido, Títulos e Valores Mobiliários.
- `tipoGestao` string: Tipo de gestão: Ativa ou Definida.

## Response `200`

Lista paginada de FIIs.

- 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 ISO 8601.
  - `took` integer, required: Tempo de processamento, em milissegundos.

## Other responses

- `401`: Token ausente ou inválido.
- `403`: O plano não inclui este recurso ou parâmetro.
- `500`: Erro interno do servidor.

## Changes

- **2026-06-22** `c05504ccc8be`: 1 breaking, 1 info
  - the response property `fiis/items/cnpj` became nullable for the status `200`
  - added the new optional `query` request parameter `cnpjs`
- **2026-06-01** `1b9fbb8c8f26`: 1 info
  - added the new optional `query` request parameter `symbols`
- **2026-04-26** `3ae1b2752c0b`: 14 info
  - added the required property `fiis/items/administratorAddress` to the response with the `200` status
  - added the required property `fiis/items/administratorAddressComplement` to the response with the `200` status
  - added the required property `fiis/items/administratorAddressNumber` to the response with the `200` status
  - added the required property `fiis/items/administratorCity` to the response with the `200` status
  - …10 more
- **2026-04-07** `19f807c15a24`: 1 info
  - endpoint added

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