---
title: "Get ACL role list"
type: reference
method: GET
path: /rest-api/aclrole/list.do
tag: "Users"
---

# Get ACL role list

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

Returns all ACL (Access Control List) roles defined in the system. Each role includes its numeric ID and display name (e.g., 'publisher', 'advertiser'). These role IDs are used when registering new users via the /register-user or /user-sign-up endpoints to assign the appropriate permission set. Requires authentication.

## Responses

- `200` — JSON array of role objects, e.g. [{id: 1, name: 'publisher'}, ...]
- `400` — Bad request — invalid or missing parameters
- `401` — Unauthorized — authentication error
- `403` — Forbidden — insufficient permissions

## Example request

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

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