---
title: "Retorna a lista de detalhess de imóveis vagos/disponíveis do Imoview CRM para APP"
method: GET
path: "/Imovel/App_RetornarDetalhesImovel"
tags: ["Imóveis"]
---

# Retorna a lista de detalhess de imóveis vagos/disponíveis do Imoview CRM para APP

`GET /Imovel/App_RetornarDetalhesImovel`

## Request

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

Retorno JSON de imóvel do imoview CRM para APP

## Query parameters

- `codigoImovel` integer, required
- `codigoUsuario` integer, required

## Response `200`

Retornado com sucesso

- object
  - `quantidade` integer
  - `menorvalor` integer
  - `maiorvalor` integer
  - `menorarea` integer
  - `maiorarea` integer
  - `lista` object[]
    - `codigo` integer
    - `codigomae` integer
    - `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
      - `descricao` string, String
      - `nome` 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' 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`: 34 breaking, 5 info
  - for the `query` request parameter `codigoImovel`, the format changed from `Int64` to `int64`
  - for the `query` request parameter `codigoUsuario`, the format changed from `Int64` to `int64`
  - the `lista/items/anexos/items/codigo` response's property format changed from `Int64` to `int64` for status `200`
  - the `lista/items/anexos/items/ordem` response's property format changed from `Int64` to `int64` for status `200`
  - …35 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/App_RetornarDetalhesImovel/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)
