---
title: "Get a role and its permissions"
method: GET
path: "/organization/{organizationId}/v2/roles/{roleId}"
tags: ["Roles (V2)"]
---

# Get a role and its permissions

`GET /organization/{organizationId}/v2/roles/{roleId}`

## Request

- Base URL: `https://api.gamebeast.gg`
- URL: `https://api.gamebeast.gg/organization/{organizationId}/v2/roles/{roleId}`
- Auth: HTTP bearer

## Path parameters

- `organizationId` number, required
- `roleId` number, required

## Response `200`

Default Response

- object
  - `id` number, required
  - `organizationId` number, nullable, required
  - `name` string, required
  - `slug` string, required
  - `description` string, nullable, required
  - `kind` 'built-in' | 'custom' | 'migrated', required
  - `permissions` string[], required

## Changes

- **2026-09-26** `8541dcfed596`: 4 breaking, 4 info
  - the response property `description` became nullable for the status `200`
  - the response property `organizationId` became nullable for the status `200`
  - the `description` response's property type changed from no type to `string, null` for status `200`
  - the `organizationId` response's property type changed from no type to `number, null` for status `200`
  - …4 more
- **2026-09-25** `6038ecabdc8b`: 2 info
  - the endpoint scheme security `cookieAuth` was added to the API
  - the endpoint scheme security `personalAccessTokenAuth` was added to the API
- **2026-09-18** `0a843e01e73b`: 1 breaking, 1 info
  - removed the required property `isBuiltIn` from the response with the `200` status
  - added the required property `kind` to the response with the `200` status

[Operation history](https://skmtc.dev/gamebeast/apis/gamebeast-api/changes/organization/:organizationId/v2/roles/:roleId/get.md)

---

[API](https://skmtc.dev/gamebeast/apis/gamebeast-api.md) - [All operations](https://skmtc.dev/gamebeast/apis/gamebeast-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gamebeast/apis/gamebeast-api/revisions/24605f243ed0?raw)