---
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

## Changes

- **2025-12-20** `022694254f0d` — 1 info
  - api operation id `Getting Role Details` removed and replaced with `getRoleDetails`
- **2025-03-13** `e8c2858fd4eb` — 1 info
  - api operation id `getRoleDetails` removed and replaced with `Getting Role Details`

[Change history](https://skmtc.dev/getodk/apis/odk-central-api/changes/v1/roles/:id/get.md)

---

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