---
title: "Retrieve role by id"
method: GET
path: "/roles/{roleID}"
tags: ["Roles"]
---

# Retrieve role by id

`GET /roles/{roleID}`

## Path parameters

- `roleID` integer, required

## Response `200`

role received successful

- object
  - `data` object
    - `id` integer
    - `name` string, required
    - `privileges` ModelsPrivilege[], required
      - `id` integer
      - `name` string, required
      - `role_id` integer
  - `status` string

## Other responses

- `400` — invalid query request data
- `403` — getting role not permitted
- `500` — internal error on getting role

## Changes

- **2026-05-06** `cca1c967ee9e` — 1 breaking, 1 warning
  - added the new path request parameter `roleID`
  - deleted the `path` request parameter `id`
- **2026-03-26** `fe95938acc20` — 1 breaking, 1 warning
  - added the new path request parameter `id`
  - deleted the `path` request parameter `roleID`

[Change history](https://skmtc.dev/vxcontrol/apis/pentagi-swagger-api/changes/roles/:roleID/get.md)

---

[API](https://skmtc.dev/vxcontrol/apis/pentagi-swagger-api.md) · [All operations](https://skmtc.dev/vxcontrol/apis/pentagi-swagger-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vxcontrol/pentagi-swagger-api/revisions/7c1cbf7abaa1/schema)