---
title: "Fetch a user permission"
method: GET
path: "/user_permissions/{user_permission_id}"
tags: ["user_permissions"]
---

# Fetch a user permission

`GET /user_permissions/{user_permission_id}`

Returns the matching user permission.

## Headers

- `Accept` 'application/json', required

## Response `200`

The matching user permission.

- object
  - `data` object, required
    - `id` string, required — Unique identifier for the resource instance.
    - `type` 'user_permissions', required — The type of the resource.
    - `attributes` object, required
      - `permission_level` 'guest' | 'collaborator' | 'admin' | 'owner' — Access level to the object. Learn more about the permission levels you can grant Users in our Knowledge Base article on <a href="https://help.smartsheet.com/115002602273-User-Permissions" target="_blank">User Permissions</a>.
    - `relationships` object, required
      - `user` object
        - `id` string — Unique identifier for the resource instance.
        - `type` 'users' — The type of the resource.
      - `permissible` object
        - `id` string — Unique identifier for the resource instance.
        - `type` 'organizations' | 'brandfolders' | 'collections' — The type of the resource.

## Other responses

- `default` — Generic error payload

---

[API](https://skmtc.net/smartsheet/apis/brandfolder-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/brandfolder-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/brandfolder-openapi-reference/versions/fd95b0a2d2f8/schema)