# List User Roles

```http
GET https://api.synup.com/api/v4/roles
```

This API retrieves a list of all available user roles in the system.

It includes:

- Role names (e.g., Admin, Manager, Viewer)
- Permissions associated with each role
- Role IDs for assignment and management

Source: https://developer.synup.com/api/user-management/list-user-roles

## Example request

```bash
curl -X GET 'https://api.synup.com/api/v4/roles' \
  -H 'Authorization: API YOUR_API_KEY' \
  -H 'Content-Type: application/json'
```

## Responses

| Status | Description |
| --- | --- |
| `200` | Successfully retrieved user roles |
| `401` | Unauthorized - Authentication required |
| `403` | Forbidden - Insufficient permissions |