---
title: "Retrieve a role with specific ID"
method: GET
path: "/api/2.0/roles/{objectId}"
tags: ["Role Management API"]
---

# Retrieve a role with specific ID

`GET /api/2.0/roles/{objectId}`

## Path parameters

- `objectId` integer, required

## Response `200`

Success

- Role — User role information
  - `createdDate` integer — Created date in milliseconds
  - `lastModDate` integer — Last modified date
  - `id` integer — Role id
  - `name` string — Role name
  - `jsonConfig` string — Role JSON config (viz settings, etc.)

## Other responses

- `401` — User is not authenticated
- `403` — User is not allowed to access this resource
- `500` — Error during processing

---

[API](https://skmtc.net/knowi/apis/user-management-api.md) · [All operations](https://skmtc.net/knowi/apis/user-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/knowi/user-management-api/revisions/6e6982573ba6/schema)