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

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

`POST /Imovel/RetornarRegioesDisponiveis`

## Request

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

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

## Request body

- object
  - `finalidade` string, String
  - `codigoTipo` string, String
  - `codigoCidade` string, String
  - `codigoUnidade` string, String
  - `opcaoImovel` string, String

## Response `200`

Retornado com sucesso

- object
  - `quantidade` integer
  - `lista` object[]
    - `codigo` integer
    - `nome` string, string

## 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`: 2 breaking, 5 info
  - the `lista/items/codigo` response's property format changed from `Int64` to `int64` for status `200`
  - the `quantidade` response's property format changed from `Int64` to `int64` for status `200`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - …3 more

[Operation history](https://skmtc.dev/imoview/apis/imoview-api/changes/Imovel/RetornarRegioesDisponiveis/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)