---
title: "List all active tokens across users"
method: GET
path: "/api/admin/tokens"
tags: ["Token (Admin)"]
---

# List all active tokens across users

`GET /api/admin/tokens`

Returns all non-revoked, non-expired user-type tokens. Optionally filter by
a specific user via query parameter. Requires admin (sudo) privileges.

## Query parameters

- `user` string

## Headers

- `X-EDH-USER` string, required
- `X-EDH-TOKEN` string, required

## Response `200`

Token list retrieved successfully

- object
  - `success` boolean
  - `message` object[]
    - `id` integer
    - `user` string
    - `name` string
    - `hint` string
    - `permissions` object
    - `expires_at` string, date-time
    - `renewable` boolean
    - `renewal_count` integer
    - `last_used_at` string, date-time, nullable
    - `last_used_ip` string, nullable
    - `created_at` string, date-time
    - `created_by` string

## Other responses

- `401` — Not authorized (requires admin privileges)

---

[API](https://skmtc.dev/aws-samples/apis/engineering-development-hub-edh-api.md) · [All operations](https://skmtc.dev/aws-samples/apis/engineering-development-hub-edh-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aws-samples/engineering-development-hub-edh-api/revisions/058396b8f0f1/schema)