---
schema_version: "1"
id: 2cabb3c453949d6fc161648c62ae17ba71b1ad02dcb0259847647b29ce2aa0b3
title: GET /hub/v1/approvals-v2/{id}/roles
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/getApprovalRoles.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_approvals/getApprovalRoles.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: e89df4ee295498bef2b8446133fd838f16ad6b6f54c7e0641c9793fdd77af7fe
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# GET /hub/v1/approvals-v2/{id}/roles

## Overview

Retrieves a list of roles for a given approval item as well as the users assigned to those roles.

## URL Parameters

| Name | Type   |          | Description      |
| ---- | ------ | -------- | ---------------- |
| id   | string | Required | Approval item ID |

## Responses

| Status  | Name                             | Type   | Description                                                                                             |
| ------- | -------------------------------- | ------ | ------------------------------------------------------------------------------------------------------- |
| **200** |                             |   | **Response includes details about the roles, and users assigned to those roles, for an approval item.** |
|    | workflowRoleInstanceId           | string | ID of workflowRoleInstance record                                                                       |
|    | workflowRoleDefinitionId         | string | ID of WorkflowRoleDefinition record                                                                     |
|    | RoleId                           | string | Unique ID of the role                                                                                   |
|    | key                              | string | Unique key for the role                                                                                 |
|    | users                            | array  | List of users for a specific role                                                                       |
|    | users.workflowRoleInstanceUserId | string | ID of the workflowRoleInstanceUser record                                                               |
|    | users.workflowItemId             | string | ID of the workflow item                                                                                 |
|    | users.workflowRoleInstanceId     | string | ID of the workflowRoleInstance record                                                                   |
|    | users.userId                     | string | ID of the user                                                                                          |
|    | users.userName                   | string | Name of the user                                                                                        |
|    | users.memberId                   | string | Member ID (MID)                                                                                         |
|    | users.enterpriseId               | string | Enterprise ID (EID)                                                                                     |
|    | users.isActive                   | string | Indicates if user is active                                                                             |