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

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

`POST /Imovel/RetornarImoveisDisponiveis`

## Request

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

Retorno JSON da lista de imóveis vagos/disponíveis do imoview CRM para pesquisa em APP/Site <br><br> Tokens disponíveis: <br>finalidade: OBRIGATÓRIO - Enviar 1 para ALUGUEL ou 2 para VENDA<br>destinacao: OPCIONAL - Enviar 1 para Residencial, 2 para Comercial, 3 para Residencial e comercial, 4 para industrial, 5 para rural, 6 para temporada, 7 para corporativa, 8 para comercial e industrial ou 0 para todos<br>codigounidade: OPCIONAL - Enviar código da unidade, para mais de uma unidade, separar por vírgula (,) ou vazio para todos<br>codigocondominio: OPCIONAL - Enviar o código do condomínio (lista de condomínios em Imovel/RetornarCondominiosDisponiveis) ou 0 para todos<br>codigoproprietario: OPCIONAL - Enviar o código do proprietário (lista autocomplete de pessoas em Cliente/App_PesquisarCliente) ou 0 para todos<br>codigocaptador: OPCIONAL - Enviar o código do captador (lista autocomplete de usuários em Usuario/App_RetornarUsuarios) ou 0 para todos<br>codigosimoveis: OPCIONAL - Enviar os códigos dos imóveis separados por vírgula (,) ou vazio para todos<br>codigoTipo: OPCIONAL - Enviar o código do tipo de imóvel selecionado de acordo com a lista existente (RetornarTiposImoveisDisponiveis), para mais de um tipo, separar por vírgula (,) ou vazio para todos<br>estado: OPCIONAL - Enviar a sigla do estado selecionado de acordo com a lista existente (RetornarEstadosDisponiveis) ou vazio para todos<br>codigocidade: OPCIONAL - Enviar o código da cidade selecionada de acordo com a lista existente (RetornarCidadesDisponiveis) ou 0 para todos<br>codigoregiao: OPCIONAL - Enviar o código da região selecionada de acordo com a lista existente (RetornarRegioesDisponiveis) ou 0 para todos<br>codigosubregiao: OPCIONAL - Enviar o código da sub-região selecionada de acordo com a lista existente (RetornarSubRegioesDisponiveis) ou 0 para todos<br>codigosbairros: OPCIONAL - Enviar os códigos dos bairros selecionados de acordo com a lista existente (RetornarBairrosDisponiveis) separados por vírgula (,) ou vazio para todos<br>endereco: OPCIONAL - Enviar parte do logradouro do endereço ou vazio para todos<br>edificio: OPCIONAL - Enviar parte do edifício/torre ou vazio para todos<br>numeroquartos: OPCIONAL - Enviar nº de quartos a partir, 0 para todos ou negativo para exato<br>numerovagas: OPCIONAL - Enviar nº de vagas a partir, 0 para todos ou negativo para exato<br>numerobanhos: OPCIONAL - Enviar nº de banheiros a partir, 0 para todos ou negativo para exato<br>numerosuite: OPCIONAL - Enviar nº de suítes a partir, 0 para todos ou negativo para exato<br>numerovaranda: OPCIONAL - Enviar nº de varandas a partir, 0 para todos<br>numeroelevador: OPCIONAL - Enviar nº de elevadores a partir, 0 para todos<br>valorde: OPCIONAL - Enviar valor a partir, 0 para todos<br>valorate: OPCIONAL - Enviar valor até, 0 para todos<br>valortotalde: OPCIONAL - Usado para finalidade aluguel, enviar valor total (valor + iptu + condomínio) a partir, 0 para todos<br>valortotalate: OPCIONAL - Usado para finalidade aluguel, enviar valor total (valor + iptu + condomínio) até, 0 para todos<br>areaprincipalde: OPCIONAL - Enviar área principal a partir, 0 para todos<br>areaprincipalate: OPCIONAL - Enviar área principal até, 0 para todos<br>areade: OPCIONAL - Enviar área interna a partir, 0 para todos<br>areaate: OPCIONAL - Enviar área interna até, 0 para todos<br>areaexternade: OPCIONAL - Enviar área externa a partir, 0 para todos<br>areaexternaate: OPCIONAL - Enviar área externa até, 0 para todos<br>extras: OPCIONAL - Enviar código gerado no CRM para o campo extra, separados por vírgula (,) ou vazio para não filtrar<br>academia: OPCIONAL - Enviar true ou false<br>aceitafinanciamento: OPCIONAL - Enviar true ou false<br>aceitapermuta: OPCIONAL - Enviar true ou false<br>alarme: OPCIONAL - Enviar true ou false<br>arealazer: OPCIONAL - Enviar true ou false<br>areaprivativa: OPCIONAL - Enviar true ou false<br>areaservico: OPCIONAL - Enviar true ou false<br>boxbanheiro: OPCIONAL - Enviar true ou false<br>boxDespejo: OPCIONAL - Enviar true ou false<br>churrasqueira: OPCIONAL - Enviar true ou false<br>circuitotv: OPCIONAL - Enviar true ou false<br>closet: OPCIONAL - Enviar true ou false<br>dce: OPCIONAL - Enviar true ou false<br>exclusivo: OPCIONAL - Enviar true ou false<br>interfone: OPCIONAL - Enviar true ou false<br>jardim: OPCIONAL - Enviar true ou false<br>lavabo: OPCIONAL - Enviar true ou false<br>mobiliado: OPCIONAL - Enviar true ou false<br>naplanta: OPCIONAL - Enviar true ou false<br>piscina: OPCIONAL - Enviar true ou false<br>playground: OPCIONAL - Enviar true ou false<br>portaoeletronico: OPCIONAL - Enviar true ou false<br>portaria24h: OPCIONAL - Enviar true ou false<br>quadraesportiva: OPCIONAL - Enviar true ou false<br>quadratenis salaofestas: OPCIONAL - Enviar true ou false<br>salaojogos: OPCIONAL - Enviar true ou false<br>sauna: OPCIONAL - Enviar true ou false<br>varanda: OPCIONAL - Enviar true ou false<br>wifi: OPCIONAL - Enviar true ou false<br>ocupado: OPCIONAL - Enviar true para imóveis ocupados, ou false para desocupado ou vazio para todos<br>alugado: OPCIONAL - Enviar true ou false<br>quartoqtdeexata: OPCIONAL - Enviar true ou false<br>vagaqtdexata: OPCIONAL - Enviar true ou false<br>datacadastroinicio: OPCIONAL - Enviar data no formato dd/mm/yyyy<br>datacadastrofim: OPCIONAL - Enviar data no formato dd/mm/yyyy<br>dataultimaalteracaoinicio: OPCIONAL - Enviar data no formato dd/mm/yyyy hh:mm:ss<br>dataultimaalteracaofim: OPCIONAL - Enviar data no formato dd/mm/yyyy hh:mm:ss<br>datavagodesdeinicio: OPCIONAL - Enviar data no formato dd/mm/yyyy<br>datavagodesdefim: OPCIONAL - Enviar data no formato dd/mm/yyyy<br>destaque: OPCIONAL - Enviar 1 para simples, 2 para destaque ou 3 para super destaque, 0 para todos<br>opcaoimovel: OPCIONAL - Enviar 1 para somente avulsos, 2 para somente lançamentos, 3 para unidades de lançamentos, 4 para avulsos e lançamentos mãe, 0 para todos (avulsos e lançamentos por tipo e m²)<br>retornomapa: OPCIONAL - Enviar true ou false, usado para exibir os imóveis no mapa (retorno com até 100 registros e JSON reduzido)<br>retornomapaapp: OPCIONAL - Enviar true ou false, usado para exibir os imóveis no mapa (retorno com até 1000 registros e JSON reduzido)<br>naoexibirtitulo: OPCIONAL - Enviar true ou false (se retornomapa, retornomapaapp ou retornodestaque = true))<br>naoexibirlatitude: OPCIONAL - Enviar true ou false (se retornomapaapp))<br>numeropagina: OBRIGATÓRIO - Usado para paginação, enviar o nº da página atual<br>numeroregistros: OBRIGATÓRIO - Nº de registros para retorno, máximo 20<br>ordenacao: OPCIONAL - Tipo de ordenação, codigoasc, codigodesc, valorasc, valordesc, dataatualizacaoasc, dataatualizacaodesc, datainclusaoasc, datainclusaodesc, datavagodesdeasc, datavagodesdedesc, destaque, areainternaasc, areainternadesc, areaexternaasc, areaexternadesc, arealoteasc, arealotedesc ou vazio para assumir destaque decrescente<br>exibircaptadores: OPCIONAL - Enviar true ou false<br>exibiranexos: OPCIONAL - Enviar true ou false<br>somentecomurlpublica: OPCIONAL - Enviar true ou false<br>somentecomvideo: OPCIONAL - Enviar true ou false<br>espacogourmet: OPCIONAL - Enviar true ou false<br>varandagourmet: OPCIONAL - Enviar true ou false<br>identificador: OPCIONAL - Identificador do imóvel<br>identificadorchave: OPCIONAL - Identificador de chaves<br>exibirproposta: OPCIONAL - Envia true para retornar se tem proposta/reserva e data final reserva<br>armariobanheiro: OPCIONAL - Enviar true ou false<br>armariocozinha: OPCIONAL - Enviar true ou false<br>armarioquarto: OPCIONAL - Enviar true ou false<br/>naoconsiderarmeusite: OPCIONAL - Enviar true para NÃO considerar 'Exibir meu site', 'Publicação na internet' e 'Situação'. Caso queira filtrar a situação, enviar o parâmetro 'situacao' com as opções (0 - Todos, 1 - Vago/Disponível, 2 - Alugado, 3 - Vendido, 4 - Em reforma, 5 - Em moderação, 6 - Desativado, 7 - Em desocupação)<br>codigoRedeAdmin: OPCIONAL - Usar quando for admin de rede, enviar 9999 para meus imóveis, código da rede negativo para somente meus imóveis da rede ou código da rede para imóveis da rede<br>codigoRedeAssociado: OPCIONAL - Usar quando for associado de rede, enviar 9999 para meus imóveis, código da rede negativo para somente meus imóveis da rede ou código da rede para imóveis da rede<br>novosultimos7dias: OPCIONAL, enviar true para filtrar vago desde a 7 dias<br/>vistamar: OPCIONAL - Enviar true ou false<br/>vistamontanha: OPCIONAL - Enviar true ou false<br/>vistalago: OPCIONAL - Enviar true ou false

## Request body

- Imoveis
  - `finalidade` integer
  - `numeroPagina` integer
  - `numeroRegistros` integer

## Response `200`

Retornado com sucesso

- object
  - `quantidade` integer
  - `menorvalor` integer
  - `maiorvalor` integer
  - `menorarea` integer
  - `maiorarea` integer
  - `lista` object[]
    - `codigo` integer
    - `codigomae` integer
    - `emdesocupacao` boolean
    - `empreendimento` boolean
    - `empreendimentofilho` boolean
    - `nomeempreendimento` string, String
    - `siteempreendimento` string, String
    - `statusobracodigo` integer
    - `statusobranome` string, String
    - `tipolancamentocodigo` integer
    - `tipolancamentonome` string, String
    - `codigocondominio` integer
    - `nomecondominio` string, String
    - `titulo` string, String
    - `metadescription` string, String
    - `codigoauxiliar` string, String
    - `unidade` integer
    - `nomeunidade` string, String
    - `telefoneunidade` string, String
    - `emaileunidade` string, String
    - `finalidade` string, String
    - `codigodestinacao` integer
    - `destinacao` string, String
    - `codigotipo` integer
    - `tipo` string, String
    - `codigotipo2` integer
    - `tipo2` string, String
    - `situacao` string, String
    - `valor` string, String
    - `valoranterior` string, String
    - `valorm2` string, String
    - `valorminimo` string, String
    - `valormaximo` string, String
    - `taxaadm` string, String
    - `taxacomissao` string, String
    - `rentabilidade` string, String
    - `valorcondominio` string, String
    - `valormaiscondominio` string, String
    - `valormaiscondominiomaisiptu` string, String
    - `indiceiptu` string, String
    - `valoriptu` string, String
    - `valoriptuanual` string, String
    - `valorspu` string, String
    - `valortaxaresiduo` string, String
    - `valorseguroincendio` string, String
    - `valorparcelaseguroincendio` string, String
    - `valoritbi` string, String
    - `percentualitbi` string, String
    - `valorregistro` string, String
    - `percentualregistro` string, String
    - `valoravaliacao` string, String
    - `codigobairro` integer
    - `bairro` string, String
    - `codigobairro2` integer
    - `bairro2` string, String
    - `codigocidade` integer
    - `cidade` string, String
    - `estado` string, String
    - `codigoregiao` integer
    - `regiao` string, string
    - `codigosubregiao` integer
    - `subregiao` string, string
    - `codigocidade2` integer
    - `cidade2` string, String
    - `estado2` string, String
    - `cep` string, String
    - `endereco` string, String
    - `numero` string, String
    - `complemento` string, String
    - `bloco` string, String
    - `pontoreferencia` string, String
    - `melhoracesso` string, String
    - `edificio` string, String
    - `construtora` string, String
    - `localchave` string, String
    - `identificador` string, String
    - `identificadorchave` string, String
    - `aceitafinanciamento` boolean
    - `aceitapermuta` boolean
    - `anoconstrucao` integer
    - `numerochave` integer
    - `numeroquartos` string, String
    - `numerosalas` string, String
    - `numerobanhos` string, String
    - `numerovagas` string, String
    - `tipovagas` string, String
    - `numerosuites` string, String
    - `numerovarandas` string, String
    - `numeroelevador` string, String
    - `numeroandar` integer
    - `unidadesporandar` integer
    - `numeroandares` integer
    - `totalunidades` integer
    - `destaque` string, String
    - `tipomedida` string, String
    - `areaprincipal` string, String
    - `areainterna` string, String
    - `areaexterna` string, String
    - `arealote` string, String
    - `metragemfrente` string, String
    - `metragemfundo` string, String
    - `metragemladodireito` string, String
    - `metragemladoesquerdo` string, String
    - `latitude` string, String
    - `longitude` string, String
    - `descricao` string, String
    - `anotacoes` string, String
    - `confrontacaofrente` string, String
    - `confrontacaofundo` string, String
    - `confrontacaoladodireito` string, String
    - `confrontacaoladoesquerdo` string, String
    - `cartorio` string, String
    - `matriculacartorio` string, String
    - `livrocartorio` string, String
    - `folhacartorio` string, String
    - `exclusivo` boolean
    - `imovelocupado` boolean
    - `imovelalugado` boolean
    - `naplanta` boolean
    - `placa` boolean
    - `placafaixa` string, String
    - `posicao` string, String
    - `arcondicionado` boolean
    - `areaservico` boolean
    - `areaprivativa` boolean
    - `armariobanheiro` boolean
    - `armariocozinha` boolean
    - `armarioquarto` boolean
    - `box` boolean
    - `closet` boolean
    - `dce` boolean
    - `despensa` boolean
    - `escritorio` boolean
    - `lavabo` boolean
    - `mobiliado` boolean
    - `rouparia` boolean
    - `aguaindividual` boolean
    - `alarme` boolean
    - `aquecedorgas` boolean
    - `aquecedoreletrico` boolean
    - `aquecedorsolar` boolean
    - `boxdespejo` boolean
    - `cercaeletrica` boolean
    - `circuitotv` boolean
    - `gascanalizado` boolean
    - `interfone` boolean
    - `jardim` boolean
    - `lavanderia` boolean
    - `portaoeletronico` boolean
    - `portaria24horas` boolean
    - `seguranca24horas` boolean
    - `quintal` boolean
    - `gramado` boolean
    - `academia` boolean
    - `churrasqueira` boolean
    - `hidromassagem` boolean
    - `homecinema` boolean
    - `piscina` boolean
    - `playground` boolean
    - `quadraesportiva` boolean
    - `quadratenis` boolean
    - `salamassagem` boolean
    - `salaofestas` boolean
    - `salaojogos` boolean
    - `sauna` boolean
    - `wifi` boolean
    - `espacogourmet` boolean
    - `garageband` boolean
    - `quadrasquash` boolean
    - `beachtenis` boolean
    - `solmanha` boolean
    - `vistamar` boolean
    - `varandagourmet` boolean
    - `lareira` boolean
    - `cabeamentoestruturado` boolean
    - `tvacabo` boolean
    - `conexaointernet` boolean
    - `vistamontanha` boolean
    - `vistalago` boolean
    - `permiteanimais` boolean
    - `datahoracadastro` string, String
    - `datahoraultimaalteracao` string, String
    - `datahoraultimavalidacao` string, String
    - `datahoraultimasituacao` string, String
    - `datahoravagodesde` string, String
    - `urlfotoprincipal` string, String
    - `descricaoFotoPrincipal` string, String
    - `urlfotoprincipalm` string, String
    - `urlfotoprincipalp` string, String
    - `urlfotoprincipalpp` string, String
    - `urlvideo` string, String
    - `urlpublica` string, String
    - `descricaoempreendimento` string, String
    - `areapatio` string, String
    - `areaarmazenagem` string, String
    - `pedireito` string, String
    - `cargapisointerno` string, String
    - `cargapisoexterno` string, String
    - `forcainstalada` string, String
    - `alturaportao` string, String
    - `numerodoca` integer
    - `temproposta` boolean
    - `temreserva` boolean
    - `anexos` object[]
      - `codigo` integer
      - `ordem` integer
      - `visibilidade` string, String
      - `descricao` string, String
      - `url` string, String
    - `proprietarios` object[]
      - `codigo` integer
      - `nome` string, String
      - `email` string, String
      - `telefone` string, String
      - `percentual` integer
    - `captadores` object[]
      - `nome` string, String
      - `email` string, String
      - `telefone` string, String
      - `principal` boolean
      - `percentual` integer
      - `foto` string, String
      - `creci` string, String
    - `fotos` object[]
      - `descricao` string, String
      - `empreendimento` boolean
      - `condominio` boolean
      - `datahoraalteracao` string, String
      - `url` string, String
      - `urlm` string, String
      - `urlp` string, String
      - `urlpp` string, String
    - `fotos360` object[]
      - `descricao` string, String
      - `empreendimento` boolean
      - `datahoraalteracao` string, String
      - `url` string, String
      - `urlm` string, String
      - `urlp` string, String
      - `urlpp` string, String
    - `extras` object[]
      - `Acesso para deficiente` string, String
    - `extras2` object[]
      - `Acesso para deficiente` string, String
    - `chaveiros` object[]
      - `codigo` integer
      - `situacao` string, String
      - `situacaocodigo` integer
      - `unidade` string, String
      - `unidadecodigo` integer
      - `numerolacre` string, String
      - `quadro` string, String
      - `quadrocodigo` integer
      - `posicao` string, String
      - `posicaocodigo` integer
      - `chaves` object[]
        - `codigo` integer
        - `tipo` string, String
        - `tipocodigo` integer
        - `quantidade` integer
        - `observacao` string, String
    - `ehimovelrede` boolean
    - `redecaptador` object
      - `codigorede` integer
      - `nomerede` string, String
      - `codigoassociado` integer
      - `nome` string, String
      - `email` string, String
      - `telefone` string, String
      - `urllogo` string, String
      - `codigoimovelnarede` string, String
    - `ehimovelcaptadorrede` boolean
    - `redes` object[]
      - `codigorede` integer
      - `nomerede` string, String
      - `codigoimovelnarede` string, String
      - `situacao` string, String
      - `datahorainclusao` string, String
      - `datahoraalteracao` 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`: 35 breaking, 5 info
  - the `finalidade` request property format changed from `Int64` to `int64`
  - the `numeroPagina` request property format changed from `Int64` to `int64`
  - the `numeroRegistros` request property format changed from `Int64` to `int64`
  - the `lista/items/anexos/items/codigo` response's property format changed from `Int64` to `int64` for status `200`
  - …36 more
- **2026-09-15** `08a78caea274`: 4 info
  - added the optional property `lista/items/statusobracodigo` to the response with the `200` status
  - added the optional property `lista/items/statusobranome` to the response with the `200` status
  - added the optional property `lista/items/tipolancamentocodigo` to the response with the `200` status
  - added the optional property `lista/items/tipolancamentonome` to the response with the `200` status

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