BRbrapi-dev
Fundos Imobiliários

Histórico de imóveis de FIIs

Changed on

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.

get/api/v2/fii/properties/history

Request

  • Base URL
    https://brapi.dev
  • URL
    https://brapi.dev/api/v2/fii/properties/history
  • Auth
    HTTP bearer

Query parameters

symbolsstring required

Tickers de FIIs separados por vírgula, até 20. Ex.: HGLG11,MXRF11.

Example:HGLG11,MXRF11
startDatestring

Data inicial no formato YYYY-MM-DD.

Example:2024-01-01
endDatestring

Data final no formato YYYY-MM-DD.

Example:2025-12-31
sortBystring

Campo de ordenação.

Example:referenceDate
sortOrder'asc' | 'desc'

Direção da ordenação.

Example:desc
allVersions'true' | 'false'

true inclui todas as versões de cada trimestre. false retorna só a mais recente.

Example:false

Response

Série trimestral de imóveis e vacância.

requestedAtstring date-time required

Data e hora da requisição em ISO 8601.

tookinteger required

Tempo de processamento, em milissegundos.

Example response

{
  "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
}

Changes