BRbrapi-dev
Fundos Imobiliários

Imóveis e vacância de FIIs

Changed on

Imóveis físicos de FIIs pelo informe trimestral da CVM, com área, endereço, classe, unidades, vacância, inadimplência e participação na receita de cada imóvel.

Use para analisar FIIs de tijolo, medir a vacância de um fundo e ver quanto da receita depende de cada imóvel.

summary.vacancyRate é a vacância do fundo, ponderada pela área quando o informe traz a área de cada imóvel. vacancyRate, delinquencyRate e revenueShare são frações decimais: 0.0328 é 3,28%.

Leia vacancyRate junto com revenueShare. Um imóvel vago com 2% da receita pesa menos que um com 30%.

Sem referenceDate, retorna o trimestre mais recente de cada fundo. O padrão retorna a versão mais recente do informe, e allVersions=true retorna todas. Para a série no tempo, use o histórico de imóveis.

Plano Pro. Sem token, aceita só symbols com MXRF11 e HGLG11.

get/api/v2/fii/properties

Request

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

Query parameters

symbolsstring required

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

Example:HGLG11,MXRF11
referenceDatestring

Fim do trimestre no formato YYYY-MM-DD. Sem valor, retorna o trimestre mais recente de cada FII.

Example:2026-03-31
sortBy'revenueShare' | 'area' | 'vacancyRate' | 'name'

Campo de ordenação dos imóveis.

Example:revenueShare
sortOrder'asc' | 'desc'

Direção da ordenação dos imóveis.

Example:desc
allVersions'true' | 'false'

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

Example:false

Response

Imóveis e vacância dos FIIs.

requestedAtstring date-time required

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

tookinteger required

Tempo de processamento, em milissegundos.

Example response

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

Changes