---
title: "Retorna a lista de estados dos imóveis vagos/disponíveis do Imoview CRM para pesquisa em APP/Site"
method: POST
path: "/Imovel/RetornarEstadosDisponiveis"
tags: ["Imóveis"]
---

# Retorna a lista de estados dos imóveis vagos/disponíveis do Imoview CRM para pesquisa em APP/Site

`POST /Imovel/RetornarEstadosDisponiveis`

## Request

- Base URL: `https://api.imoview.com.br`
- URL: `https://api.imoview.com.br/Imovel/RetornarEstadosDisponiveis`
- Auth: API key in header `chave`

Retorno JSON da lista de estados de imóveis vagos/disponíveis do imoview CRM para pesquisa em APP/Site

## Request body

- object
  - `finalidade` integer
  - `codigoTipo` integer
  - `opcaoImovel` integer

## Response `200`

Retornado com sucesso

- unknown[]
  - unknown

## Other responses

- `401`: Header 'chave' ausente ou inválido, ou chave/usuário sem permissão para a operação
- `403`: Regra de negócio violada ou limite de paginação excedido
- `404`: Parâmetro obrigatório ausente ou inválido, registro não encontrado ou consulta sem resultado
- `429`: Limite de requisições da chave excedido
- `500`: Falha interna não prevista

## Changes

- **2026-10-09** `d7f65bff1506`: 3 breaking, 5 info
  - the `codigoTipo` request property format changed from `Int64` to `int64`
  - the `finalidade` request property format changed from `Int64` to `int64`
  - the `opcaoImovel` request property format changed from `Int64` to `int64`
  - added the non-success response with the status `401`
  - …4 more

[Operation history](https://skmtc.dev/imoview/apis/imoview-api/changes/Imovel/RetornarEstadosDisponiveis/post.md)

---

[API](https://skmtc.dev/imoview/apis/imoview-api.md) - [All operations](https://skmtc.dev/imoview/apis/imoview-api/llms.txt) - [OpenAPI document](https://skmtc.dev/imoview/apis/imoview-api/revisions/436e609983d0?raw)