---
title: "List the network's roles"
type: reference
method: GET
path: /rest-api/roles.do
tag: "Users"
---

# List the network's roles

`GET https://YOUR-NETWORK-DOMAIN/rest-api/roles.do`

Every role the caller may see, as the console's roles pages list them: its id, the static role it is built on (which decides the permissions it can hold at all), the admin console pages it opens, and whether the caller may change it and hand it to an account. A role built on ADMIN is listed only to a caller who may edit admin roles. 'identity' is how this role is addressed in another role's permission matrix, where the rights one role holds over another live. How many accounts hold a role is answered by system-users/search.do with that role. Requires the Admin Roles & Permissions or User Roles & Permissions console permission.

## Responses

- `200` — {success, adminRolesVisible, roles:[{id, name, staticRole, identity, adminPages, manageable}], staticRoles:[{id, name}]}
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error
- `403` — The caller holds neither roles-and-permissions console permission

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/roles.do' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/users/get-roles