---
title: "Getting Role Details"
method: GET
path: "/v1/roles/{id}"
tags: ["Roles"]
---

# Getting Role Details

`GET /v1/roles/{id}`

Getting an individual Role does not reveal any additional information over listing all Roles. It is, however, useful for direct lookup of a specific role:

The `id` parameter for Roles here and elsewhere will accept the numeric ID associated with that Role, _or_ a `system` name if there is one associated with the Role. Thus, you may request `/v1/roles/admin` on any ODK Central server and receive information about the Administrator role.

As with Role listing, there are no authorization restrictions upon this endpoint: anybody is allowed to get information about any Role at any time.

## Path parameters

- `id` string, required

## Response `200`

OK

- Role
  - `id` number — The numerical ID of the Role.
  - `name` string — The human-readable name for the Role.
  - `system` string — The system name of the Role. Roles that have system names may not be modified.
  - `verbs` string[] — The array of string verbs this Role confers.
  - `createdAt` string — ISO date format
  - `updatedAt` string — ISO date format

---

[API](https://skmtc.net/getodk/apis/odk-central-api.md) · [All operations](https://skmtc.net/getodk/apis/odk-central-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getodk/odk-central-api/versions/d8f5a0886a8b/schema)