# Get Roles

> GET /v1/roles

`GET https://app.untetherlabs.com/api/v1/roles`

Fetch Roles

This endpoint is paginated. See /using-the-api/pagination.

## Request

```bash
curl -X GET 'https://app.untetherlabs.com/api/v1/roles' \
  -H 'Authorization: Bearer $UNTETHER_API_KEY'
```

## Query parameters

- `team` (uuid)
- `pageSize` (number, default 20, min 1, max 200)
- `cursor` (string)

## Response 200

- `items` (Role[], required)
  - `createdAt` (string, required, example "2024-11-20T07:43:34+0000")
  - `name` (string, required, example "Care Coordinator")
  - `team` (uuid, required)
  - `teamName` (string, required)
  - `hexColor` (string, required, example "#6941c6")
- `cursor` (string)

## Errors

- `validation` (400) — Input validation failed.