---
title: "List Keys"
method: GET
path: "/api/v1/auth/keys"
tags: ["grandline-auth"]
---

# List Keys

`GET /api/v1/auth/keys`

## Request

- Base URL: `https://grandline.luzomi.com`
- URL: `https://grandline.luzomi.com/api/v1/auth/keys`
- Auth: none declared

List the calling user's API keys.

Revoked keys are included (with revoked_at set) so users can see
their full key history in the UI — useful for auditing "which key
last hit our endpoint" etc.

## Response `200`

Successful Response

- ApiKeyOut[]
  - `id` integer, required
  - `name` string, required
  - `prefix` string, required
  - `created_at` string, date-time, required
  - `last_used_at` string, date-time, nullable, required
  - `revoked_at` string, date-time, nullable, required
  - `expires_at` string, date-time, nullable

## Other responses

- `401`: Authentication required
- `404`: Key not found / not owned by caller

---

[API](https://skmtc.dev/luzomi/apis/grandline-api.md) · [All operations](https://skmtc.dev/luzomi/apis/grandline-api/llms.txt) · [OpenAPI document](https://skmtc.dev/luzomi/apis/grandline-api/revisions/4ce06aea012b?raw)