# List roles

Returns the available roles that can be assigned to users within a business.

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

## Path parameters:

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

## Query parameters:

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

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

## Response 200 fields (application/json):

  - `count` (integer)
    The total number of roles for the business.
    Example: 5

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

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

  - `results` (array)

  - `results.id` (string, required)
    The ID of the role.
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

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

  - `results.is_deletable` (boolean, required)
    Whether the role can be deleted.

  - `results.permissions` (array, required)

  - `results.permissions.resource` (string, required)
    The resource the action applies to.
    Example: "transactions"

  - `results.permissions.action` (string, required)
    The action permitted on the resource.
    Enum: "create", "read", "update", "delete"


## Response 401 fields

## Response 403 fields