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

# List API keys

`GET /api/v1/keys`

## Request

- Base URL: `https://volunteerreminder.com`
- URL: `https://volunteerreminder.com/api/v1/keys`
- Auth: HTTP bearer

List this account's API keys (including revoked ones, so their status is visible). The secret is NEVER returned. Requires the `keys:manage` scope.

## Response `200`

The account's keys, newest first.

- ApiKeySummary[]
  - `id` integer, required
  - `name` string, required
  - `key_prefix` string, required
  - `scopes` Scope[], required
  - `created_at` integer, required: Epoch ms (UTC).
  - `last_used_at` integer, nullable, required: Epoch ms (UTC) of the last authenticated use, or null.
  - `revoked_at` integer, nullable, required: Epoch ms (UTC) when revoked, or null if still active.

## Other responses

- `401`: Missing or invalid API key.
- `403`: The API key lacks a scope required by this endpoint.

---

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