---
title: "List API keys"
method: GET
path: "/identity/api_keys"
tags: ["api_keys", "identity", "customer-session"]
---

# List API keys

`GET /identity/api_keys`

## Request

- Base URL: `https://api.stablesea.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stablesea.com/identity/api_keys`
- Auth: none declared

Lists Live or Test key metadata for your current business. Requires api_keys_manage. Secrets are returned only when a key is created or rotated.

## Query parameters

- `limit` integer
- `cursor` string
- `environment` 'live' | 'test'

## Response `200`

OK

- PageCustomerAPIKey
  - `data` CustomerAPIKey[], nullable, required
    - `api_version` string
    - `created_ts` string, date-time
    - `id` string
    - `key_prefix` string
    - `key_suffix` string
    - `name` string
    - `revoked_ts` string, date-time, nullable
    - `scopes` string[], nullable
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required
  - `total_count` integer, nullable

## Other responses

- `default`: Error response.

## Changes

- **2026-10-29** `e003c8a67b62`: 1 info
  - added the optional property `error/authorization` to the response with the `default` status
- **2026-10-15** `33870379032d`: 1 info
  - api tag `customer-session` added
- **2026-10-06** `f34cdca636ad`: 1 info
  - added the new enum value `test` to the `query` request parameter `environment`
- **2026-09-25** `3b77ab3f29e6`: 1 breaking, 1 warning, 1 info
  - removed the enum value `test` from the `query` request parameter `environment`
  - removed the optional property `data/items/environment` from the response with the `200` status
  - the `query` request parameter `environment` became optional
- **2026-09-08** `24358bd7b74f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/stablesea/apis/stable-sea-backend/changes/identity/api_keys/get.md)

---

[API](https://skmtc.dev/stablesea/apis/stable-sea-backend.md) - [All operations](https://skmtc.dev/stablesea/apis/stable-sea-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/stablesea/apis/stable-sea-backend/revisions/772c80d83658?raw)