---
title: "GET /api/tokens"
method: GET
path: "/api/tokens"
tags: ["token"]
---

# GET /api/tokens

`GET /api/tokens`

## Query parameters

- `org` string, uuid, nullable
- `repo` string, uuid, nullable
- `instance` boolean, nullable
- `type` 'personal' | 'organization' | 'ci' | 'deploy' | 'runner' | 'instance'
- `includeRevoked` boolean, nullable
- `offset` integer, nullable
- `limit` integer, nullable

## Response `200`

List of tokens

- TokenResponse[]
  - `creator` string, uuid, nullable — UUID of the user that created this token. Not used for scoping Unset once the creating user has been deleted
  - `expiresAt` string, date-time, nullable — Expiration
  - `id` string, uuid, required — ID
  - `lastUsedAt` string, date-time, nullable — Last used
  - `name` string, required — Name
  - `ownerOrg` string, uuid, nullable — UUID of the organization that owns this token Only set for `token_type` = `organization`
  - `ownerRepo` string, uuid, nullable — UUID of the repository that owns this token. Only set for `token_type` = \[`ci`, `deploy`, `runner?`]
  - `ownerUser` string, uuid, nullable — UUID of the user who owns this token Only set for `token_type` = `personal`
  - `permissions` TokenPermission[], required — Permissions
  - `revokedAt` string, date-time, nullable — Revocation
  - `scope` 'all' | 'public' | 'selected', required
  - `tokenType` 'personal' | 'organization' | 'ci' | 'deploy' | 'runner' | 'instance', required
  - `scopeOrgs` string[], required — UUIDs of the organizations this token is limited to
  - `scopeRepos` string[], required — UUIDs of the repositories this token is limited to

## Other responses

- `400` — More than one owner specified
- `401` — Authentication required
- `403` — Insufficient permissions

## Changes

- **2026-09-20** `dc37a4c478f9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mari/apis/gitarena/changes/api/tokens/get.md)

---

[API](https://skmtc.dev/mari/apis/gitarena.md) · [All operations](https://skmtc.dev/mari/apis/gitarena/llms.txt) · [OpenAPI document](https://skmtc.dev/mari/apis/gitarena/revisions/dc37a4c478f9?raw)