Skip to main content

GET Buscar Usuário por ID

Retorna os dados de um usuário específico da conta.

Autenticação necessária

Esta rota requer o header Authorization: Bearer {accessToken}

Permissão necessária

Exige a permissão read_users.

Endpoint​

GET https://api-dev.imagemais.com.br/api/users/{id}

Parâmetros de Rota​

NomeTipoObrigatórioDescrição
idnumber✅ID interno do usuário

Requisição​

curl -X 'GET' \
  'https://api-dev.imagemais.com.br/api/users/12' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {accessToken}'

Respostas​

200 Sucesso​

{
  "id": 12,
  "accountId": 3,
  "name": "João da Silva",
  "email": "joao.silva@example.com",
  "phone": "(81) 98888-7777",
  "statusId": 1,
  "isCollector": false,
  "lastLogin": null,
  "pictureId": null,
  "createdAt": "2026-07-01T13:20:00.000Z",
  "updatedAt": "2026-07-10T09:15:00.000Z",
  "status": { "id": 1, "name": "active" },
  "council": { "id": 4, "type": "CRM", "code": "12345", "uf": "PE" },
  "doctors": []
}

200 Usuário inexistente​

Se o id não existir na conta, o corpo é null (a rota não retorna 404).

null