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

# List your API keys

`GET /api/keys`

## Request

- Base URL: `https://www.audioscrape.com`
- URL: `https://www.audioscrape.com/api/keys`
- Auth: HTTP bearer

Returns all API keys belonging to the calling user. `key_value` is `null` on every entry — only the display `key_prefix` is recoverable after creation. To get a fresh raw value for a key, rotate it: `POST /api/keys/{id}/rotate`.

Accepts either a session cookie or an existing API key as auth.

## Response `200`

All API keys for the calling user

- ApiKey[]
  - `created_at` string, nullable: RFC 3339 UTC timestamp.
  - `expires_at` string, nullable: When the key stops authenticating (RFC 3339). `null` = never expires, which is the case for every key issued before 2026-07-31.
  - `id` integer, required
  - `key_name` string, required: Human-readable label for the key (shown in the dashboard).
  - `key_prefix` string, required: Display-safe prefix of the key (first 12 characters + "..."). Always present. Use this to identify the key in logs and UIs.
  - `key_value` string, nullable: The full bearer token, format `sk_<base64(32 random bytes)>`. **Returned only in the response to `POST /api/keys`** — Audioscrape stores only a SHA-256 hash, so list / delete endpoints cannot recover the raw value. Save it client-side immediately on creation.
  - `last_used` string, nullable: RFC 3339 UTC timestamp of the most recent request that used this key. `null` if the key has never been used.
  - `last_used_ip` string, nullable: Source IP of the request described by `last_used` (as seen by our edge). `null` if the key has never been used or the IP was unavailable. Use it to spot a leaked key being used from somewhere unexpected.
  - `workspace_id` integer, nullable: Workspace this key is scoped to. `null` means the key follows the user's `current_workspace_id` at request time (legacy behavior).

## Other responses

- `401`: Missing or invalid session / key

---

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