---
title: "Retrieve OrgUser Permissions"
method: GET
path: "/organizations/{orgId}/users/{id}/permissions"
tags: ["OrgUsers"]
---

# Retrieve OrgUser Permissions

`GET /organizations/{orgId}/users/{id}/permissions`

Retrieve the permissions for the OrgUser with the given UUID.

Retrieves a list of all permissions associated with a specific user in an Organization using their UUID. The list can be paginated for easier management.

## Path parameters

- `orgId` string, required
- `id` string, required

## Query parameters

- `pageSize` integer
- `nextToken` string

## Response `200`

Returns a list of Permission Policies.

- PermissionPolicyResponse
  - `id` string, required — The UUID of the entity.
  - `version` integer — The version number: - **Create:** On initial Create to insert a new entity, the version is set at 1 in the response. - **Update:** On successful Update, the version is incremented by 1 in the response.
  - `name` string — The name of the Permission Policy.
  - `permissionPolicy` PermissionStatement[] — Array containing the Permission Policies information.
    - `effect` 'ALLOW' | 'DENY', required
    - `action` PermissionAction[], required — The actions available to users who are assigned the Permission Policy - what they can do or cannot do with respect to the specified resource. **NOTE:** Use lower case and a colon-separated format, for example, if you want to confer full CRUD, use: ``` "config:create", "config:delete", "config:retrieve", "config:update" ```
    - `resource` string[], required — See [Statements - Available Resources](https://www.m3ter.com/docs/guides/managing-organization-and-users/creating-and-managing-permissions#statements---available-resources) for a listing of available resources for Permission Policy statements.
  - `managedPolicy` boolean — Indicates whether this is a system generated Managed Permission Policy.
  - `dtCreated` string, date-time — The date and time *(in ISO-8601 format)* when the Permission Policy was created.
  - `dtLastModified` string, date-time — The date and time *(in ISO-8601 format)* when the Permission Policy was last modified.
  - `createdBy` string — The unique identifier (UUID) of the user who created this Permission Policy.
  - `lastModifiedBy` string — The unique identifier (UUID) of the user who last modified this Permission Policy.

## Other responses

- `4XX` — Error message
- `5XX` — Error message

---

[API](https://skmtc.net/m3ter-com/apis/m3ter-api.md) · [All operations](https://skmtc.net/m3ter-com/apis/m3ter-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/m3ter-com/m3ter-api/revisions/ac93d1a9e6d9/schema)