---
title: "Get an individual role"
method: GET
path: "/authorization/roles/{roleId}"
tags: ["Authorization"]
---

# Get an individual role

`GET /authorization/roles/{roleId}`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/authorization/roles/{roleId}`
- Auth: none declared

Returns an individual role.

## Path parameters

- `roleId` string, required

## Response `200`

The individual role document.

- IapRolesSchema: This is the schema for an IAP role stored in Mongo
  - `provenance` string, required
  - `name` string, required
  - `description` string, required
  - `allowedMethods` IapRolesSchemaAllowedMethodsItems[], required
    - `name` string
    - `provenance` string
  - `allowedViews` IapRolesSchemaAllowedViewsItems[], required
    - `path` string
    - `provenance` string
  - `_meta` IapRolesSchemaMeta
    - `created` string
    - `updated` string

## Other responses

- `500`: Error response from API

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)