---
title: "Retrieve a personal access token"
method: GET
path: "/api/v4/personal_access_tokens/self"
tags: ["access_tokens"]
---

# Retrieve a personal access token

`GET /api/v4/personal_access_tokens/self`

## Request

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

Retrieves a specified personal access token by passing it to the API in a header.

## Response `200`

Retrieve a personal access token

- APIEntitiesPersonalAccessToken: API_Entities_PersonalAccessToken model
  - `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
- `404`: Not found

---

[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)