---
title: "Retorna a lista de sub-regiões do Imoview CRM para pesquisa em APP/Site"
method: GET
path: "/Imovel/App_PesquisarSubRegiao"
tags: ["Imóveis"]
---

# Retorna a lista de sub-regiões do Imoview CRM para pesquisa em APP/Site

`GET /Imovel/App_PesquisarSubRegiao`

## Request

- Base URL: `https://api.imoview.com.br`
- URL: `https://api.imoview.com.br/Imovel/App_PesquisarSubRegiao`
- Auth: one of:
  - API key in header `chave`
  - API key in header `codigoacesso`

Retorno JSON da lista de bairros do imoview CRM para pesquisa (autocomplete) em APP/Site (máximo 100 registros)

## Query parameters

- `codigoUsuario` integer, required
- `codigoCidade` string, string
- `codigoRegiao` string, string
- `textoPesquisa` string, string, required

## Response `200`

Retornado com sucesso

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

## Other responses

- `401`: Header 'chave' ou 'codigoacesso' ausente ou inválido, ou 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
  - for the `query` request parameter `codigoUsuario`, the format changed from `Int64` to `int64`
  - 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/App_PesquisarSubRegiao/get.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)