---
title: "Lists every API key owned by the authenticated user, newest first."
method: GET
path: "/api/keys"
tags: ["api-keys"]
---

# Lists every API key owned by the authenticated user, newest first.

`GET /api/keys`

## Request

- Base URL: `https://api.pricklymails.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pricklymails.com/api/keys`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Response `200`

The caller's API keys, newest first.

- ApiKeyResponse[]
  - `created_at` string, required: RFC 3339 creation timestamp.
  - `enabled_checks` string[], required: Verification checks enabled for the key.
  - `environment` string, required: Environment of the key: `"live"` or `"test"`.
  - `expires_at` string, nullable: RFC 3339 expiry timestamp, or `null` when the key does not expire.
  - `is_active` boolean, required: Whether the key can currently authenticate (not revoked and not expired).
  - `last_used_at` string, nullable: RFC 3339 timestamp of the last request made with the key, or `null` when it was never used.
  - `name` string, required: Display name of the key.
  - `prefix` string, required: Visible prefix of the key (for example `pm_live_abc12345`).
  - `rate_limit` RateLimitDto, required: Request budget of an API key.
    - `per_minute` integer, required: Maximum number of requests the key may make per minute.
  - `request_count` integer, required: Total number of requests made with the key.
  - `revoked_at` string, nullable: RFC 3339 timestamp of the revocation, or `null` when the key is not revoked.
  - `scopes` string[], required: Scopes granted to the key.
  - `uuid` string, required: Public UUID of the key.

## Other responses

- `401`: Missing or invalid API key, session token, or agent token.
- `403`: The key or agent token lacks the `api_keys:read` scope.

---

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