Skip to main content
GET
/
client-roles
List client roles
curl --request GET \
  --url https://www.ruddr.io/api/workspace/client-roles \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "id": "7a2f9c34-b618-4d85-a1e7-3c0d8f5b92a6",
      "name": "Senior Developer",
      "isBillable": true,
      "rate": 175,
      "currency": "USD",
      "createdAt": "2025-11-03T14:28:41.372Z",
      "client": {
        "id": "d4e1b7a3-8c52-4f90-b6d3-1a9e0c7f45b8",
        "name": "Acme Corporation"
      },
      "discipline": {
        "id": "5b8e2a1c-3d47-4f09-a6e3-8c0d2f1b47a9",
        "name": "Software Engineering"
      },
      "practice": {
        "id": "c9a3d5b7-1e48-4f63-b7d0-a2e1c8f92d56",
        "name": "Web Development"
      },
      "location": {
        "id": "e2b4c6a8-7f19-4d30-a5e1-9c3b0d8f62a7",
        "name": "New York"
      },
      "workspaceRole": {
        "id": "f1a5d8b3-2c67-4e91-b4d0-7a3e9c1f05b8",
        "name": "Senior Developer"
      }
    }
  ],
  "hasMore": false
}
A role defining billing terms for work performed for a specific client. Client roles can be created independently or linked to a workspace role, which overrides the role’s name, billing, and classification fields.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
startingAfter
string

A cursor ID (uuid) used to request the next page of results. If not provided, defaults to the first page of results.

​
endingBefore
string

A cursor ID (uuid) used to request the previous page of results. Is mutually exclusive with startingAfter.

​
limit
integer

The maximum number of results to be returned. Can be any number from 1 to 100. Defaults to 10, if not provided.

​
clientId
string

Filter by client uuid.

Response

200

​
results
object[]

The list of results for the current page.

​
hasMore
boolean

Whether there are more results available after this page.