Vacância, área total e quantidade de imóveis por trimestre. Cada item em
history[] traz symbol, referenceDate, version e summary, sem a lista
completa de imóveis.
É o formato certo para gráfico de evolução. Para ver os imóveis de um trimestre,
chame /api/v2/fii/properties com referenceDate.
Sandbox sem token: symbols=HGLG11 e symbols=MXRF11. Para todos os FIIs,
use um token Pro.
history[].summary.vacancyRate é a vacância consolidada do trimestre.
history[].summary.totalArea acompanha o tamanho da carteira física, e
history[].summary.count mostra quantos imóveis o fundo tinha.
Uma queda em totalArea com count estável costuma significar reavaliação, não
venda. Vale conferir os dois juntos.
Informes recebem retificação. Use allVersions=true para ver as versões
anteriores.
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Símbolos separados por vírgula (máximo 20). Exemplo: HGLG11,MXRF11
Data de início no formato YYYY-MM-DD
Data de fim no formato YYYY-MM-DD
Campo para ordenação
Direção da ordenação
"desc"Value in
Incluir todas as versões de cada trimestre (padrão: false, retorna apenas a mais recente)
"false"Value in
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v2/fii/properties/history?symbols=HGLG11%2CMXRF11"{ "history": [ { "symbol": "HGLG11", "cnpj": "11728688000147", "referenceDate": "2026-03-31", "version": 2, "summary": { "count": 37, "totalArea": 2066028.32, "vacancyRate": 0.032785, "averageVacancyRate": 0.03787, "propertiesWithVacancy": 37 } }, { "symbol": "HGLG11", "cnpj": "11728688000147", "referenceDate": "2025-12-31", "version": 2, "summary": { "count": 28, "totalArea": 1628383.15, "vacancyRate": 0.029088, "averageVacancyRate": 0.04282, "propertiesWithVacancy": 28 } } ], "requestedAt": "2026-02-08T16:25:26.456Z", "took": 6}