---
title: "GET /roleAssignments"
method: GET
path: "/roleAssignments"
tags: ["RoleAssignments"]
---

# GET /roleAssignments

`GET /roleAssignments`

List role assignments.

## Query parameters

- `api-version` string, required
- `roleId` string
- `principalId` string
- `scope` string

## Headers

- `x-ms-continuation` string

## Response `200`

Success response.

- RoleAssignmentDetailsList — Role Assignment response details
  - `count` integer — Number of role assignments
  - `value` RoleAssignmentDetails[] — A list of role assignments
    - `id` string — Role Assignment ID
    - `roleDefinitionId` string, uuid — Role ID of the Synapse Built-In Role
    - `principalId` string, uuid — Object ID of the AAD principal or security-group
    - `scope` string — Scope at the role assignment is created
    - `principalType` string — Type of the principal Id: User, Group or ServicePrincipal

## Other responses

- `default` — Error response describing why the operation failed.

---

[API](https://skmtc.dev/azuresynapse/apis/accesscontrolclient.md) · [All operations](https://skmtc.dev/azuresynapse/apis/accesscontrolclient/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azuresynapse/accesscontrolclient/revisions/3b2b8121ce98/schema)