# List your organization's user

Returns every user in the authenticated client's organization as a lean summary — id, name, email, role, live-chat role, avatar, and availability — with no credentials or secrets. Use this to populate transfer/assignment pickers and agent lists. The client is taken from your authentication context.

Endpoint: GET /payless4messaging-service/WhatsApp/api/v1/users
Version: 3.0.0
Security: apikeyAuth

## Response 200 fields (application/json):

  - `id` (string)
    Example: "b2c3d4e5-f6a7-8901-b2c3-d4e5f6a78901"

  - `firstName` (string)
    Example: "Alice"

  - `lastName` (string)
    Example: "Smith"

  - `email` (string)
    Example: "alice.smith@example.com"

  - `role` (string)
    Platform authority — for example admin or client.
    Example: "client"

  - `liveChatRole` (string)
    Role within the live-chat team.
    Enum: "Agent", "Supervisor"

  - `avatar` (string)
    URL of the user's avatar image.
    Example: "https://example.com/avatars/alice.png"

  - `availabilityStatus` (string)
    Whether the user is currently available for live-chat assignment.
    Enum: "AVAILABLE", "UNAVAILABLE"

## Response 401 fields (application/json):

  - `status` (string)
    Example: "ERROR"

  - `message` (string)
    Example: "Unauthorized user"

  - `requestId` (string)
    Example: "c3a1f8e2-4b6d-11ee-be56-0242ac120002"

  - `timestamp` (string)
    Example: "2026-01-15T10:30:00Z"