---
title: "List roles"
method: GET
path: "/v1/businesses/{client_id}/roles"
tags: ["Roles"]
---

# List roles

`GET /v1/businesses/{client_id}/roles`

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

## Path parameters

- `client_id` integer, required

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

OK

- RoleListResponse
  - `count` integer — The total number of roles for the business.
  - `next` string — The URL to the next page of roles.
  - `previous` string — The URL to the previous page of roles.
  - `results` Role[]
    - `id` string, uuid, required — The ID of the role.
    - `name` string, required — The name of the role.
    - `is_deletable` boolean, required — Whether the role can be deleted.
    - `permissions` Permission[], required
      - `resource` string, required — The resource the action applies to.
      - `action` 'create' | 'read' | 'update' | 'delete', required — The action permitted on the resource.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/letsweel/apis/weel-openapi.md) · [All operations](https://skmtc.net/letsweel/apis/weel-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/letsweel/weel-openapi/revisions/5a8ffd533c9c/schema)