---
title: "Listing all Roles"
method: GET
path: "/v1/roles"
tags: ["Roles"]
---

# Listing all Roles

`GET /v1/roles`

Currently, there are no paging or filtering options, so listing `Role`s will get you every Role in the system, every time. There are no authorization restrictions upon this endpoint: anybody is allowed to list all Role information at any time.

## 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 `Listing all Roles` removed and replaced with `listAllRoles`
- **2025-03-13** `e8c2858fd4eb` — 1 info
  - api operation id `listAllRoles` removed and replaced with `Listing all Roles`

[Change history](https://skmtc.dev/getodk/apis/odk-central-api/changes/v1/roles/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)