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

# List API Keys

`GET /v1/api-keys`

Lists metadata for all programmatic API keys. Secret key values are omitted.

## Query parameters

- `org_id` string, uuid, required

## Response `200`

List of API keys

- object
  - `api_keys` APIKey[], required
    - `id` string, uuid, required — Unique API Key identifier.
    - `name` string, required — Human-readable name given to the API key.
    - `org_id` string, uuid, required — UUID of the organization.
    - `team_id` string, uuid, nullable — Optional UUID of the team.
    - `operation` 'read_render' | 'all' | 'admin', required — The scope of operations.
    - `created_at` string, date-time, required — Timestamp when the API Key was created.
    - `last_used_at` string, date-time, nullable — Timestamp when the API Key was last used. Null if never used.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

## Changes

- **2026-07-02** `e500bc0895c5` — 1 breaking
  - removed the required property `api_keys/items/key_prefix` from the response with the `200` status
- **2026-06-29** `162c1e986d3a` — 1 warning
  - added the new `admin` enum value to the `api_keys/items/operation` response property for the response status `200`
- **2026-06-27** `08e27b8a28f4` — 4 breaking, 5 info
  - added the new required `query` request parameter `org_id`
  - removed the media type `application/json` for the response with the status `401`
  - removed the media type `application/json` for the response with the status `500`
  - the response property `api_keys/items/last_used_at` became optional for the status `200`
  - …5 more

[Change history](https://skmtc.dev/px0-ai/apis/px0-api/changes/v1/api-keys/get.md)

---

[API](https://skmtc.dev/px0-ai/apis/px0-api.md) · [All operations](https://skmtc.dev/px0-ai/apis/px0-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/px0-ai/px0-api/revisions/3ed72443989d/schema)
