Série trimestral de imóveis e vacância de FIIs: um ponto por fundo, trimestre e versão do informe, com vacância, área total e quantidade de imóveis em summary.
Use para gráficos de vacância e para acompanhar o tamanho da carteira física no tempo.
A resposta não traz a lista de imóveis. Para os imóveis de um trimestre, use imóveis de FIIs com referenceDate.
Sem startDate e endDate, retorna os últimos 12 meses. sortBy aceita referenceDate (padrão), symbol, version, count, totalArea, vacancyRate, averageVacancyRate e propertiesWithVacancy. allVersions=true inclui as versões retificadas.
Plano Pro. Sem token, aceita só symbols com MXRF11 e HGLG11.
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Tickers de FIIs separados por vírgula, até 20. Ex.: HGLG11,MXRF11.
Data inicial no formato YYYY-MM-DD.
Data final no formato YYYY-MM-DD.
Campo de ordenação.
Direção da ordenação.
"desc"Value in
true inclui todas as versões de cada trimestre. false retorna só 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}