Imóveis

Listar imóveis

GET /imoveis

Retorna uma lista paginada de imóveis, com suporte a filtros.

Parâmetro	Tipo	Descrição
`situacao[]`	array de string	`disponivel`, `alugado`, `ocupado`
`codigo`	string	Busca por código ou código interno
`nome`	string	Busca parcial pelo nome
`rua`	string	Busca parcial pela rua
`bairro`	string	Busca parcial pelo bairro
`proprietario`	string	ID público encriptado do proprietário

curl "https://api-aberta-prod.useimobia.com.br/api/v1/imoveis?situacao[]=disponivel&bairro=Centro" \
  -H "API-KEY: SUA_CHAVE_AQUI"

Detalhes do imóvel

GET /imoveis/{id}

Exemplo de resposta:

{
  "data": {
    "id": "epz7Z...",
    "codigo": 1,
    "codigoInterno": "12346",
    "tipo": "Casa",
    "descricao": "desc teste",
    "nome": "Imovel 01",
    "empreendimento": null,
    "endereco": {
      "unidade": "1",
      "rua": "rua teste",
      "numero": "123",
      "complemento": "casa",
      "bairro": "teste",
      "cidade": "Corupá",
      "estado": null,
      "cep": "88360000"
    },
    "tiposNegociacao": null,
    "negociacaoLocacao": {
      "valor_locacao": null,
      "porcentagem_comissao": "0.00",
      "valor_comissao": "0.00",
      "porcentagem_primeira_comissao": "0.00",
      "valor_primeira_comissao": "0.00"
    },
    "proprio": false,
    "proprietarios": [
      { "pessoaId": "oJ94MO1O8q" }
    ],
    "status": "locado"
  }
}

📘
Cada pessoaId em proprietarios pode ser consultado em GET /pessoas/{id} para obter os dados completos do proprietário.

💡
Dica: um imóvel pode ter contratos sucessivos ao longo do tempo. Para ver o contrato vigente de um imóvel, use GET /locacoes?imovelId={id}&status[]=Ativa.