# Listagem de FIIs URL: /docs/fiis/listagem.mdx Liste e filtre Fundos Imobiliários por símbolos, CNPJs, segmento, setor de atuação, tipo de gestão e mandato, com paginação e ordenação. *** title: Listagem de FIIs description: >- Liste e filtre Fundos Imobiliários por símbolos, CNPJs, segmento, setor de atuação, tipo de gestão e mandato, com paginação e ordenação. full: true keywords: brapi, api, fii, fundos imobiliários, listagem, filtro openGraph: title: Listagem de FIIs description: >- Liste e filtre Fundos Imobiliários com indicadores resumidos. type: website locale: pt\_BR lastUpdated: '2026-04-25T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/fii/list structuredData: headings: \[] contents: * content: >- Retorna uma lista paginada de FIIs com indicadores resumidos, filtros por símbolos, segmento, setor, gestão e mandato, e busca textual. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna uma lista paginada de FIIs com indicadores resumidos. Use filtros para refinar por segmento (`papel`, `tijolo`, `híbrido`, `fof`), setor de atuação, tipo de gestão, mandato, símbolos específicos e CNPJs. Suporta busca textual pelo nome, ticker ou CNPJ. Ideal como ponto de partida para telas de screening ou seleção de FIIs. Veja o fluxo completo em [Fundos Imobiliários](/docs/fiis). Para FIAGRO, FI-Infra/FIF, FIDC e FIP, use a seção [Fundos](/docs/fundos). Por exemplo, `JURO11` é FI-Infra/FIF e deve ser consultado em `/api/v2/funds/list?symbols=JURO11`, não como FII. **Plano mínimo: Pro.** A listagem completa requer token. Para testar sem token, use `symbols=MXRF11` e/ou `symbols=HGLG11`, por exemplo `/api/v2/fii/list?symbols=HGLG11`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/fii/list Single endpoint documentation for /api/v2/fii/list ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/fii/list **Summary:** Listar Fundos Imobiliários 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 **Tags:** Fundos Imobiliários ### Parameters - **page** (query) - **limit** (query) - **sortBy** (query) - **sortOrder** (query) - **symbols** (query) - **cnpjs** (query) - **search** (query) - **segmentType** (query) - **segmentoAtuacao** (query) - **mandate** (query) - **tipoGestao** (query) ### Responses #### 200 Lista paginada de FIIs com indicadores retornada com sucesso. #### 401 Não autorizado #### 403 Acesso negado #### 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) ### FiiListItem **Properties:** - **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)* ### FiiListResponse **Properties:** - **fiis** (array) *(required)* Array items: Reference to: **FiiListItem** - **pagination** *(required)* Reference to: **PaginationMeta** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### PaginationMeta **Properties:** - **page** (number) *(required)* - **limit** (number) *(required)* - **totalItems** (number) *(required)* - **totalPages** (number) *(required)* - **hasNextPage** (boolean) *(required)*