---
title: "Retorna os usuários ativos para a Área do Cliente/APP"
method: GET
path: "/Usuario/App_RetornarUsuarios"
tags: ["Usuario"]
---

# Retorna os usuários ativos para a Área do Cliente/APP

`GET /Usuario/App_RetornarUsuarios`

## Request

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

Retorno JSON da lista de usuários ativos para área do cliente/APP do imoview ADM

## Query parameters

- `codigoUsuario` integer, required
- `finalidade` integer
- `codigoUnidade` integer

## Response `200`

Retornado com sucesso

- object
  - `quantidade` integer
  - `lista` object[]
    - `codigo` integer
    - `codigoauxiliar` string, string
    - `foto` string, string
    - `nome` string, string
    - `email` string, string
    - `telefone` string, string
    - `endereco` string, string
    - `empresarazao` string, string
    - `empresafantasia` string, string
    - `telefoneempresa` string, string
    - `emailempresa` string, string
    - `enderecoempresa` string, string
    - `logoempresa` string, string
    - `situacao` string, string
    - `cargo` string, string
    - `perfil` string, string
    - `setor` string, string
    - `creci` string, string
    - `ultimoacesso` 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`: 5 breaking, 5 info
  - for the `query` request parameter `codigoUnidade`, the format changed from `Int64` to `int64`
  - for the `query` request parameter `codigoUsuario`, the format changed from `Int64` to `int64`
  - for the `query` request parameter `finalidade`, the format changed from `Int64` to `int64`
  - the `lista/items/codigo` response's property format changed from `Int64` to `int64` for status `200`
  - …6 more

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