---
title: "List all personal access tokens"
method: GET
path: "/api/v4/personal_access_tokens"
tags: ["access_tokens"]
---

# List all personal access tokens

`GET /api/v4/personal_access_tokens`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/personal_access_tokens`
- Auth: none declared

Lists all personal access tokens accessible by the authenticated user. For administrators, returns all personal access tokens in the instance. For non-administrators, returns all of their personal access tokens.

## Query parameters

- `user_id` integer
- `revoked` boolean
- `state` 'active' | 'inactive'
- `created_before` string, date-time
- `created_after` string, date-time
- `last_used_before` string, date-time
- `last_used_after` string, date-time
- `expires_before` string, date
- `expires_after` string, date
- `search` string
- `sort` string
- `page` integer
- `per_page` integer

## Response `200`

List all personal access tokens

- APIEntitiesPersonalAccessToken[]
  - `id` integer, required
  - `name` string, required
  - `revoked` boolean, required
  - `created_at` string, date-time, required
  - `description` string, required
  - `scopes` unknown[], required
    - unknown
  - `user_id` integer, required
  - `last_used_at` string, date-time, required
  - `last_used_ips` string[], required: The five most recent unique IP addresses that have authenticated with this token. When the limit is reached, the oldest IP address is removed. The list updates once per minute per token.
  - `active` boolean, required
  - `granular` boolean, required
  - `granular_scopes` APIEntitiesPersonalAccessTokenGranularScope[]
    - `access` string, required
    - `permissions` unknown[], required
      - unknown
    - `project_id` integer, required
    - `group_id` integer, required
  - `expires_at` string, date-time, required

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/gitlab/apis/gitlab-api.md) - [All operations](https://skmtc.dev/gitlab/apis/gitlab-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gitlab/apis/gitlab-api/revisions/b234947ef3f2?raw)