# Histórico de Imóveis e Vacância
URL: /docs/fiis/imoveis-historico.mdx

Acompanhe a evolução trimestral de imóveis, área e vacância consolidada dos FIIs.

***

title: Histórico de Imóveis e Vacância
description: >-
Acompanhe a evolução trimestral de imóveis, área e vacância consolidada dos
FIIs.
full: true
keywords: brapi, api, fii, imóveis, vacância, histórico, trimestral
openGraph:
title: Histórico de Imóveis e Vacância
description: Série trimestral compacta de imóveis, área 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/history
structuredData:
headings: \[]
contents:

* content: >-
  Retorna a série trimestral de resumos de imóveis e vacância dos FIIs.

***

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

Use este endpoint para montar gráficos de vacância, área total e quantidade de
imóveis ao longo dos trimestres. A resposta é compacta: cada item em `history[]`
traz `symbol`, `referenceDate`, `version` e `summary`, sem a lista completa de
imóveis.

Para inspecionar os imóveis de um trimestre específico, use
[`/api/v2/fii/properties`](/docs/fiis/imoveis) com `referenceDate`.

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

## Quando usar

* **Gráfico de vacância:** use `history[].summary.vacancyRate`.
* **Evolução de área:** use `history[].summary.totalArea`.
* **Mudança de carteira física:** compare `history[].summary.count`.
* **Retificações:** use `allVersions=true` para ver versões anteriores do informe.





## Swagger Documentation

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

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

## Base URLs

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

## GET /api/v2/fii/properties/history

**Summary:** Histórico de Imóveis e Vacância


Retorna a série trimestral compacta dos imóveis e da vacância dos FIIs. Use este endpoint para gráficos e comparações de vacância, área total e quantidade de imóveis ao longo do tempo.

### Funcionalidades:
*   **Série trimestral:** Um ponto por FII, trimestre e versão do informe.
*   **Resumo compacto:** Retorna apenas `summary` por trimestre, sem a lista completa de imóveis.
*   **Múltiplos FIIs:** Consulte até 20 FIIs em uma única requisição.
*   **Filtro por período:** Use `startDate=YYYY-MM-DD` e `endDate=YYYY-MM-DD`. O padrão são os últimos 12 meses.
*   **Versionamento:** Por padrão retorna a versão mais recente de cada trimestre. Use `allVersions=true` para incluir retificações.

### Exemplos de Requisição:
```bash
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/properties/history?symbols=HGLG11"
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/properties/history?symbols=HGLG11,XPLG11&startDate=2024-01-01&endDate=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*
- **startDate** (query)
- **endDate** (query)
- **sortBy** (query)
- **sortOrder** (query)
- **allVersions** (query)

### Responses

#### 200

Histórico trimestral de imóveis e vacância retornado 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)


### FiiPropertiesHistoryEntry

**Properties:**

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

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

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

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

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


### FiiPropertiesHistoryResponse

**Properties:**

- **history** (array) *(required)*
  Array items:
    Reference to: **FiiPropertiesHistoryEntry**

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

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


### FiiPropertySummary

**Properties:**

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

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

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

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

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