---
title: "List Scopes of a Personal Access Token"
method: GET
path: "/tokens/{_id}/scopes/"
tags: ["Tokens"]
---

# List Scopes of a Personal Access Token

`GET /tokens/{_id}/scopes/`

Retrieve the scopes associated with a specific personal access token.
Scopes determine the level of access and operations permitted by the token.
#### Returns A JSON:API-compliant response containing an array of scopes.
#### Errors - `404 Not Found`: Token or scopes not accessible by user.

## Path parameters

- `_id` string, required

## Response `200`

Successfully retrieved tokens scopes.

- object
  - `data` object[]
    - `id` string
    - `type` string
    - `attributes` object
      - `description` string

## Other responses

- `404` — Token not found.

---

[API](https://skmtc.net/osf/apis/osf-apiv2-documentation.md) · [All operations](https://skmtc.net/osf/apis/osf-apiv2-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/osf/osf-apiv2-documentation/revisions/ca701048eb0d/schema)