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

---

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