# List users

This endpoint allows you to retrieve a list of users for a given business.

Endpoint: GET /v1/businesses/{client_id}/users
Version: v1
Security: BearerAuth

## Query parameters:

  - `offset` (integer)
    Offset to retrieve items from.
    Example: 50

  - `limit` (integer)
    Number of items per page.
    Example: 50

## Path parameters:

  - `client_id` (integer, required)
    The ID of the business.
    Example: 123

## Response 200 fields (application/json):

  - `count` (integer)
    The total number of users that match the query.
    Example: 100

  - `next` (string)
    The URL to the next page of users.
    Example: "offset=50&limit=50"

  - `previous` (string)
    The URL to the previous page of users.
    Example: "offset=0&limit=50"

  - `results` (array)

  - `results.id` (integer)
    The ID of the user.
    Example: 123

  - `results.first_name` (string)
    The first name of the user.
    Example: "John"

  - `results.last_name` (string)
    The last name of the user.
    Example: "Doe"

  - `results.name` (string)
    The full name of the user or the display name if the user has set one.
    Example: "John Doe"

  - `results.email` (string)
    The email of the user.
    Example: "john.doe@example.com"

  - `results.role` (string)
    The role of the user.
    Example: "Team Member"

  - `results.is_deleted` (boolean)
    Whether the user is deleted.

  - `results.created` (string)
    The date and time when the user was created in UTC.
    Example: "2024-01-01T00:00:00Z"

  - `results.updated` (string)
    The date and time when the user was last updated in UTC.
    Example: "2024-01-01T00:00:00Z"


## Response 401 fields

## Response 403 fields
