Skip to main content

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​

NomeTipoObrigatórioDescrição
limitnumber❌Itens por página (0–100). Padrão: 100
offsetnumber❌Página atual (base 0). Padrão: 0
namestring❌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 [].