---
title: "List API Keys"
method: GET
path: "/v1/keys"
tags: ["Payment SDK API Key Management"]
---

# List API Keys

`GET /v1/keys`

Retrieve a paginated list of API keys, optionally filtered by property or revocation status.

Use `next_page_token` from the response as `page_token` in the next request to paginate.
The `secret` field is never included in list responses.

## Query parameters

- `property_ids` string[]
- `include_revoked` boolean
- `page_size` integer, nullable
- `page_token` string, nullable

## Response `200`

Successful operation

- ListApiKeysResponse — List Api Keys Response
  - `api_keys` ApiKeyResponse[], required — Array of API key objects. Each contains identity, property_ids, status, created_at, and revoked_at fields.
    - `identity` string — Public key identifier.
    - `property_ids` string[] — Property IDs the key is scoped to.
    - `status` string — Key status.
    - `created_at` string, date-time — ISO 8601 creation timestamp.
    - `revoked_at` string, date-time, nullable — ISO 8601 revocation timestamp, or null if active.
  - `next_page_token` string, nullable — Token for the next page, or null if no more results.

## Other responses

- `400` — Malformed request
- `401` — Missing or invalid JWT token
- `500` — Internal server error

---

[API](https://skmtc.net/cloudbeds/apis/cloudbeds-api.md) · [All operations](https://skmtc.net/cloudbeds/apis/cloudbeds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudbeds/cloudbeds-api/revisions/2faa857793e8/schema)