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

# List API Keys

`GET /keys`

Returns a list of all API keys belonging to the authenticated user's workspace.

**Requirements:**
- Authentication required via admin API key

**Key Features:**
- View all API keys with their aliases and creation dates
- Optionally expand to include creator information
- Paginated results for workspaces with many keys

**Expansion Options:**
- `expand=creator_info`: Include creator_nickname and creator_email for each key

**Common Use Cases:**
- Audit existing API keys
- Find keys by alias
- Monitor key creation activity
- Build key management interfaces

## Query parameters

- `limit` integer — Maximum number of items to return. Actual maximum depends on query type and expansion parameters.
- `cursor` string — Pagination cursor from previous response. Encodes the page number.
- `expand` union — Fields to expand in the response. Available: creator_info (includes creator_nickname and creator_email)
  - string
  - string[]

## Response `200`

Successfully retrieved API keys

- object — Response containing a list of API keys with pagination support
  - `next_cursor` string, nullable, required — Cursor for the next page of results, null if no more pages
  - `has_more` boolean, required — Boolean indicating if more results are available (convenience field derived from next_cursor)
  - `keys` object[], required — Array of API keys belonging to the authenticated user
    - `key_id` string, required — Unique identifier for the API key
    - `alias` string, required — User-provided friendly name for the key
    - `scope` 'API', required — Scope of the API key. Only API scope keys can be managed via this API.
    - `created_at` string, required — ISO8601 timestamp when the key was created
    - `creator_nickname` string — Nickname of the user who created this key (when expanded)
    - `creator_email` string — Email of the user who created this key (when expanded)

## Other responses

- `401` — Authentication required
- `403` — Access denied
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/fal/apis/platform-apis.md) · [All operations](https://skmtc.dev/fal/apis/platform-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fal/platform-apis/revisions/0c7dabf80b00/schema)