---
title: "List role assignments"
method: GET
path: "/cloud/v1/users/assignments"
tags: ["User Role Assignments"]
---

# List role assignments

`GET /cloud/v1/users/assignments`

List all role assignments in the specified scope.

## Query parameters

- `limit` integer — Limit the number of returned items. Falls back to default of 1000 if not specified. Limited by max limit value of 1000
- `offset` integer — Offset value is used to exclude the first set of records from the result
- `project_id` integer — Project ID
- `user_id` integer — User ID for filtering

## Response `200`

OK

- RoleAssignmentCollectionSerializer
  - `count` integer, required — Number of objects
  - `results` RoleAssignmentSerializer[], required — Objects
    - `assigned_by` integer, nullable, required
    - `client_id` integer, required — Client ID
    - `created_at` string, date-time, required — Created timestamp
    - `id` integer, required — Assignment ID
    - `project_id` integer, nullable, required — Project ID
    - `role` 'ClientAdministrator' | 'InternalNetworkOnlyUser' | 'Observer' | 'ProjectAdministrator' | 'User', required
    - `updated_at` string, date-time, nullable, required — Updated timestamp
    - `user_id` integer, required — User ID

---

[API](https://skmtc.dev/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.dev/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)