v20

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-07-2176162684.2 KB

Fundos Imobiliários

Obter Imóveis e Vacância

Retorna os imóveis físicos dos FIIs com vacância em primeiro plano. Use este endpoint para análise de FIIs de tijolo, galpões, lajes, shoppings e qualquer carteira imobiliária física.

Funcionalidades:

Vacância consolidada: summary.vacancyRate é ponderada por área quando possível.
Imóveis item a item: Nome, endereço, área, unidades, vacância, inadimplência e participação na receita.
Múltiplos FIIs: Consulte até 20 FIIs em uma única requisição.
Filtro por trimestre: Use referenceDate=YYYY-MM-DD. Sem esse parâmetro, retorna o trimestre mais recente disponível por FII.

Exemplos de Requisição:

curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/properties?symbols=HGLG11"
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/properties?symbols=HGLG11,MXRF11&referenceDate=2026-03-31"

Fonte dos Dados:

CVM (Informe Trimestral FII)

Plano Mínimo: Pro Autenticação: Necessária (exceto MXRF11 e HGLG11)

get/api/v2/fii/properties

Query parameters

symbolsstring required

Símbolos separados por vírgula (máximo 20). Exemplo: HGLG11,MXRF11

Example:HGLG11,MXRF11

referenceDatestring

Data de referência trimestral no formato YYYY-MM-DD. Se omitida, retorna o trimestre mais recente por FII.

Example:2026-03-31

sortBy'revenueShare' | 'area' | 'vacancyRate' | 'name'

Campo para ordenar os imóveis. Padrão: revenueShare.

Example:revenueShare

sortOrder'asc' | 'desc'

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

Example:desc

allVersions'true' | 'false'

Incluir todas as versões do trimestre retornado (padrão: false, retorna apenas a mais recente)

Example:false

Response

Imóveis e vacância dos FIIs retornados com sucesso.

requestedAtstring date-time required

Data e hora da requisição em formato 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
}