---
title: "Lists all available user roles."
method: GET
path: "/accessmanagement/userroles"
tags: ["accessmanagement - user roles"]
---

# Lists all available user roles.

`GET /accessmanagement/userroles`

## Request

- Base URL: `https://manager.digicertdns.com/v1`
- URL: `https://manager.digicertdns.com/v1/accessmanagement/userroles`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/digicert/apis/digicert-dns/docs/accessmanagement/userroles/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint lists all available user roles, helping users manage and review the roles available within the system.</br></br>Key features include:</br></br>- **Clear success messaging:** Returns a `200` success code with a confirmation message indicating the successful completion of the requested action.</br>- **Comprehensive data retrieval:** Returns a comprehensive list of all user roles, providing a complete and accurate overview for seamless management and analysis.</br>- **Controlled data limits:** The `pageSize` parameter allows users to define the maximum number of user roles to display per page, optimizing data retrieval for specific use cases.</br>- **Customizable pagination:** The `pageNumber` parameter allows users to specify the page of results they wish to retrieve, ensuring targeted access to data.

## Query parameters

- `pageSize` integer
- `pageNumber` integer

## Response `200`

User roles listed successfully.

- UserRolePaginated
  - `data` UserRole[]
    - `id` integer
    - `name` string
    - `roleType` string
    - `description` string
    - `isSystemRole` boolean
    - `canDelete` boolean
    - `canRename` boolean
    - `resourceGroupCount` number
    - `userCount` number
    - `created_ts` string
    - `modified_ts` string
  - `total` integer
  - `count` integer
  - `perPage` integer
  - `currentPage` integer
  - `totalPages` integer

## Other responses

- `404`: User Role not found.

---

[API](https://skmtc.dev/digicert/apis/digicert-dns.md) - [All operations](https://skmtc.dev/digicert/apis/digicert-dns/llms.txt) - [OpenAPI document](https://skmtc.dev/digicert/apis/digicert-dns/revisions/c74fc728cff8?raw)