---
title: "Fetches a role by its ID"
method: GET
path: "/authorization/roles/{role_id}"
tags: ["Roles"]
---

# Fetches a role by its ID

`GET /authorization/roles/{role_id}`

This endpoint can be used to view a specific role.

This endpoint requires the permission "authorization.rbac.read".

## Path parameters

- `role_id` string, required

## Headers

- `Authorization` string, required
- `SplinterProtocolVersion` integer

## Response `200`

Successfully retrieved the requested role

- object
  - `data` Role
    - `role_id` string — Unique identifier for the role
    - `display_name` string — A human readable name of the role.
    - `permissions` string[] — An array of permissions included with this role.

## Other responses

- `401` — The client is unauthorized
- `404` — The requested role was not found
- `500` — An internal server error occurred

---

[API](https://skmtc.dev/cargill/apis/splinterd-api.md) · [All operations](https://skmtc.dev/cargill/apis/splinterd-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cargill/splinterd-api/revisions/38a272c24bd9/schema)