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

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

---

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": 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": []
  }
]

Quando não há usuários que atendam ao filtro, retorna [].