Users

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

get/v1/businesses/{client_id}/users

Request

Path parameters

client_idinteger required
Example:123

The ID of the business.

Query parameters

offsetinteger
Example:50

Offset to retrieve items from.

limitinteger
Example:50

Number of items per page.

Response

OK

countinteger

The total number of users that match the query.

nextstring

The URL to the next page of users.

previousstring

The URL to the previous page of users.

Example response

{
  "count": 100,
  "next": "offset=50&limit=50",
  "previous": "offset=0&limit=50",
  "results": [
    {
      "id": 123,
      "first_name": "John",
      "last_name": "Doe",
      "name": "John Doe",
      "email": "john.doe@example.com",
      "role": "Team Member",
      "role_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "created": "2024-01-01T00:00:00Z",
      "updated": "2024-01-01T00:00:00Z",
      "payment_types": [
        "cards"
      ],
      "out_of_office_mode": true,
      "out_of_office_start_date": "2026-06-01",
      "out_of_office_end_date": "2026-06-15",
      "delegate_approver": 789,
      "expense_delegate": [
        456,
        789
      ]
    }
  ]
}

Changes

    • warning

      added the new external_expenses enum value to the /// response property for the response status