Listagem de Usuários

Descrição

Retorna uma lista paginada de usuários cadastrados no sistema, com informações básicas como nome, e-mail, papel (role) e data de criação.

Verbo

GET

URL Base

https://api.soargi.com

Endpoint

/users

Cabeçalhos

Parâmetro Valor
Authorization Bearer Token

Parâmetros de Consulta

Parâmetro Tipo Obrigatório Descrição
page integer Não Número da página. Padrão: 1.
limit integer Não Quantidade de registros por página. Padrão: 10.

Respostas

Sucesso - 200

{
  "success": true,
  "message": "Users retrieved successfully.",
  "page": 1,
  "limit": 10,
  "total": 2,
  "data": [
    {
      "user_id": "1",
      "first_name": "John",
      "middle_name": "",
      "last_name": "Doe",
      "email": "john.doe@example.com",
      "phone_number": "11999999999",
      "language": "en-US",
      "country": "USA",
      "state": "CA",
      "city": "San Francisco",
      "address": "123 Market St",
      "postal_code": "94103",
      "sms_notification": "1",
      "avatarUrl": null,
      "practitioner_name": "Antonio Andrade",
      "created_at": "2025-04-23 18:19:22",
      "updated_at": "2025-04-23 18:19:22",
      "role": {
        "role_id": "3",
        "role_name": "Individual"
      }
    },
    {
      "user_id": "2",
      "first_name": "Maria",
      "middle_name": "Clara",
      "last_name": "Fernandes",
      "email": "maria.fernandes@example.com",
      "phone_number": "61988888888",
      "language": "pt-br",
      "country": "Brasil",
      "state": "SP",
      "city": "São Paulo",
      "address": "Rua das Flores, 456",
      "postal_code": "01310-000",
      "sms_notification": "0",
      "avatarUrl": null,
      "practitioner_name": "",
      "created_at": "2025-04-23 10:45:00",
      "updated_at": "2025-04-23 10:45:00",
      "role": {
        "role_id": "3",
        "role_name": "Individual"
      }
    }
  ]
}

Erro - 404 (Nenhum usuário encontrado)

{
  "success": false,
  "message": "No users found."
}

Códigos de Resposta

  • 200 - Lista de usuários retornada com sucesso
  • 404 - Nenhum usuário encontrado