---
title: "List your organisation's roles"
method: GET
path: "/roles"
tags: ["Roles"]
---

# List your organisation's roles

`GET /roles`

## Request

- Base URL: `https://api.streamtime.net/v2`
- URL: `https://api.streamtime.net/v2/roles`
- Auth: HTTP bearer

Returns all roles associated with your organisation.

## Query parameters

- `include_archived` boolean

## Response `200`

Roles fetched successfully.

- Role[]
  - `id` integer: The ID of the role
  - `name` string: The name of the role.
  - `active` boolean: Whether the role is active or archived.

---

[API](https://skmtc.dev/streamtime/apis/public-api.md) · [All operations](https://skmtc.dev/streamtime/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/streamtime/apis/public-api/revisions/cda8d1405534?raw)