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

# List API Keys

`GET /v1/keys`

## Request

- Base URL: `https://api.cloudbeds.com/payments/sdk-api`
- URL: `https://api.cloudbeds.com/payments/sdk-api/v1/keys`
- Auth: HTTP bearer

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.dev/cloudbeds/apis/payment-sdk-api.md) - [All operations](https://skmtc.dev/cloudbeds/apis/payment-sdk-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudbeds/apis/payment-sdk-api/revisions/afe699ad0227?raw)