Imóveis e Vacância de FIIs
Use este endpoint para analisar FIIs de tijolo. A vacância aparece em primeiro
plano: summary.vacancyRate é ponderada por área quando possível, e cada imóvel
vem em properties[] com area, address, propertyClass, unitCount,
vacancyRate, delinquencyRate e revenueShare.
Campos de taxa como vacancyRate, delinquencyRate e revenueShare são
razões decimais. Exemplo: 0.0328 significa 3,28%.
Sandbox sem token: symbols=HGLG11 e symbols=MXRF11. Para todos os FIIs,
use um token Pro.
Quando usar
- Vacância: use
summary.vacancyRatepara a taxa consolidada. - Concentração física: compare
properties[].area. - Risco operacional: combine
vacancyRate,delinquencyRateerevenueShare. - Trimestre específico: use
referenceDate=YYYY-MM-DD. - Evolução trimestral: use
/api/v2/fii/properties/history. - Ordenação: use
sortBy=revenueShare|area|vacancyRate|nameesortOrder=asc|desc.
Authorization
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Query Parameters
Símbolos separados por vírgula (máximo 20). Exemplo: HGLG11,MXRF11
Data de referência trimestral no formato YYYY-MM-DD. Se omitida, retorna o trimestre mais recente por FII.
Campo para ordenar os imóveis. Padrão: revenueShare.
"revenueShare""revenueShare" | "area" | "vacancyRate" | "name"Direção da ordenação dos imóveis.
"desc""asc" | "desc"Incluir todas as versões do trimestre retornado (padrão: false, retorna apenas a mais recente)
"false""true" | "false"Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://brapi.dev/api/v2/fii/properties?symbols=HGLG11%2CMXRF11"{
"fiis": [
{
"symbol": "HGLG11",
"cnpj": "11728688000147",
"referenceDate": "2026-03-31",
"version": 2,
"summary": {
"count": 37,
"totalArea": 2066028.32,
"vacancyRate": 0.032785,
"averageVacancyRate": 0.03787,
"propertiesWithVacancy": 37
},
"properties": [
{
"name": "São José dos Campos",
"identifier": "322fab9c7769a894ed2736a77d73d9d1",
"address": "Rua Ambrósio Molina, 1090/1100, São José dos Campos, SP",
"propertyClass": "Imóveis para renda acabados",
"area": 72487.36,
"unitCount": 1,
"vacancyRate": 0.248282735086503,
"delinquencyRate": 0,
"revenueShare": 0.0241721159147739,
"leasedRate": null,
"soldRate": null,
"constructionProgressActual": null,
"constructionProgressExpected": null,
"constructionCostActual": null,
"constructionCostExpected": null,
"investedShare": null,
"confidential": false
}
]
}
],
"requestedAt": "2026-02-08T16:25:24.456Z",
"took": 8
}{
"error": true,
"message": "Parâmetros inválidos",
"code": "BAD_REQUEST"
}{
"error": true,
"message": "Token de autenticação inválido ou ausente",
"code": "UNAUTHORIZED"
}{
"error": true,
"message": "Você não tem permissão para acessar este recurso",
"code": "FORBIDDEN"
}{
"error": true,
"message": "Recurso não encontrado",
"code": "NOT_FOUND"
}{
"error": true,
"message": "Erro interno do servidor",
"code": "INTERNAL_SERVER_ERROR"
}