# Imóveis e Vacância de FIIs
URL: /docs/fiis/imoveis.mdx

Consulte imóveis físicos de FIIs com área, endereço, vacância, inadimplência e participação na receita.

***

title: Imóveis e Vacância de FIIs
description: >-
Consulte imóveis físicos de FIIs com área, endereço, vacância, inadimplência e
participação na receita.
full: true
keywords: brapi, api, fii, imóveis, vacância, tijolo, galpões, shoppings
openGraph:
title: Imóveis e Vacância de FIIs
description: Endpoint simples para analisar imóveis físicos e vacância de FIIs.
type: website
locale: pt\_BR
lastUpdated: '2026-05-30T12:00:00.000Z'
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/fii/properties
structuredData:
headings: \[]
contents:

* content: >-
  Retorna imóveis físicos de FIIs com vacância consolidada e item a item.

***

import { Callout } from 'fumadocs-ui/components/callout';

Use este endpoint para analisar FIIs de tijolo. A vacância aparece em primeiro
plano: `summary.vacancyRate` é ponderada por área quando possível, e cada imóvel
vem em `properties[]` com `area`, `address`, `propertyClass`, `unitCount`,
`vacancyRate`, `delinquencyRate` e `revenueShare`.

Campos de taxa como `vacancyRate`, `delinquencyRate` e `revenueShare` são
razões decimais. Exemplo: `0.0328` significa `3,28%`.

<Callout type="info">
  Sandbox sem token: `symbols=HGLG11` e `symbols=MXRF11`. Para todos os FIIs,
  use um token Pro.
</Callout>

## Quando usar

* **Vacância:** use `summary.vacancyRate` para a taxa consolidada.
* **Concentração física:** compare `properties[].area`.
* **Risco operacional:** combine `vacancyRate`, `delinquencyRate` e `revenueShare`.
* **Trimestre específico:** use `referenceDate=YYYY-MM-DD`.
* **Evolução trimestral:** use [`/api/v2/fii/properties/history`](/docs/fiis/imoveis-historico).
* **Ordenação:** use `sortBy=revenueShare|area|vacancyRate|name` e `sortOrder=asc|desc`.





## Swagger Documentation

# brapi - API do Mercado Financeiro Brasileiro - /api/v2/fii/properties

Single endpoint documentation for /api/v2/fii/properties

## Base URLs

- `https://brapi.dev` - Servidor principal da API brapi
- `http://localhost:3001` - Servidor local para desenvolvimento

## GET /api/v2/fii/properties

**Summary:** 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:
```bash
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)


**Tags:** Fundos Imobiliários

### Parameters

- **symbols** (query) *required*
- **referenceDate** (query)
- **sortBy** (query)
- **sortOrder** (query)
- **allVersions** (query)

### Responses

#### 200

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

#### 400

Requisição inválida

#### 401

Não autorizado

#### 403

Acesso negado

#### 404

Não encontrado

#### 500

Erro interno do servidor

## Schemas

The following schemas are used by this endpoint:

### ErrorResponse

Erro interno do servidor

**Properties:**

- **error** (boolean) - Options: `true` *(required)*

- **message** (string) *(required)*

- **code** (string)


### FiiPropertiesResponse

**Properties:**

- **fiis** (array) *(required)*
  Array items:
    Reference to: **FiiPropertiesResult**

- **requestedAt** (string, date-time) *(required)*
  Data e hora da requisição em formato ISO 8601

- **took** (integer) *(required)*
  Tempo de processamento em milissegundos


### FiiPropertiesResult

**Properties:**

- **symbol** (string) *(nullable)* *(required)*

- **cnpj** (string) *(required)*

- **referenceDate** (string) *(required)*

- **version** (number) *(required)*

- **summary** *(required)*
  Reference to: **FiiPropertySummary**

- **properties** (array) *(required)*
  Array items:
    Reference to: **FiiProperty**


### FiiProperty

**Properties:**

- **name** (string) *(required)*

- **identifier** (string) *(nullable)* *(required)*

- **address** (string) *(nullable)* *(required)*

- **propertyClass** (string) *(nullable)* *(required)*

- **area** (number) *(nullable)* *(required)*

- **unitCount** (number) *(nullable)* *(required)*

- **vacancyRate** (number) *(nullable)* *(required)*

- **delinquencyRate** (number) *(nullable)* *(required)*

- **revenueShare** (number) *(nullable)* *(required)*

- **leasedRate** (number) *(nullable)* *(required)*

- **soldRate** (number) *(nullable)* *(required)*

- **constructionProgressActual** (number) *(nullable)* *(required)*

- **constructionProgressExpected** (number) *(nullable)* *(required)*

- **constructionCostActual** (number) *(nullable)* *(required)*

- **constructionCostExpected** (number) *(nullable)* *(required)*

- **investedShare** (number) *(nullable)* *(required)*

- **confidential** (boolean) *(required)*


### FiiPropertySummary

**Properties:**

- **count** (number) *(required)*

- **totalArea** (number) *(nullable)* *(required)*

- **vacancyRate** (number) *(nullable)* *(required)*

- **averageVacancyRate** (number) *(nullable)* *(required)*

- **propertiesWithVacancy** (number) *(required)*