Histórico de Imóveis e Vacância
Use este endpoint para montar gráficos de vacância, área total e quantidade de
imóveis ao longo dos trimestres. A resposta é compacta: cada item em history[]
traz symbol, referenceDate, version e summary, sem a lista completa de
imóveis.
Para inspecionar os imóveis de um trimestre específico, use
/api/v2/fii/properties com referenceDate.
Sandbox sem token: symbols=HGLG11 e symbols=MXRF11. Para todos os FIIs,
use um token Pro.
Quando usar
- Gráfico de vacância: use
history[].summary.vacancyRate. - Evolução de área: use
history[].summary.totalArea. - Mudança de carteira física: compare
history[].summary.count. - Retificações: use
allVersions=truepara ver versões anteriores do informe.
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 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""asc" | "desc"Incluir todas as versões de cada trimestre (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/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
}{
"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"
}