GET Listar Usuários
Lista os usuários ativos da conta, ordenados do mais recente para o mais antigo. Suporta paginação e busca por nome.
Autenticação necessária
Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.
Permissão necessária
Exige a permissão read_users.
Endpoint
GET https://api-dev.imagemais.com.br/api/users
Parâmetros de Query
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
limit | number | ❌ | Itens por página (0–100). Padrão: 100 |
offset | number | ❌ | Página atual (base 0). Padrão: 0 |
name | string | ❌ | Filtra por nome (busca parcial, case-insensitive) |
Requisição
curl -X 'GET' \
'https://api-dev.imagemais.com.br/api/users?limit=50&offset=0&name=joão' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'
Respostas
200 Sucesso
[
{
"id": 6,
"name": "teste da glr novo",
"email": "usuario@exemplo.com.br",
"pictureId": null,
"phone": "(81) 99999-9999",
"statusId": 1,
"createdAt": "2026-09-10T18:38:22.377Z",
"updatedAt": "2026-09-10T18:38:46.529Z",
"deletedAt": null,
"lastLogin": null,
"accountId": 1,
"auth0Id": "auth0|64f1c2d3e4a5b6c7d8e9f0a1",
"workosUserId": "user_01HXXXXXXXXXXXXXXXXXXXXXXX",
"isCollector": false,
"status": {
"id": 1,
"name": "active"
},
"council": null,
"signature": null,
"doctors": []
}
]
Quando não há usuários que atendam ao filtro, retorna [].