---
title: "Get a specific role"
method: GET
path: "/roles/{role_id}"
tags: ["Roles"]
---

# Get a specific role

`GET /roles/{role_id}`

## Request

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

Returns a single role by ID if they belong to your organisation.

## Path parameters

- `role_id` integer, required

## Response `200`

Role fetched successfully.

- Role: A role that is performed within your organisation
  - `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)