---
title: "List API keys"
method: GET
path: "/v0.1/merchants/{merchant_code}/api-keys"
tags: ["API Keys"]
---

# List API keys

`GET /v0.1/merchants/{merchant_code}/api-keys`

Returns paginated list of API keys.

## Path parameters

- `merchant_code` string, required

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

List of API keys.

- APIKeysList — List of API keys.
  - `items` APIKey[], required — List of API keys.
    - `created_at` string, date-time, required — The timestamp of when the API key was created.
    - `id` string, required — Unique identifier of the API Key.
    - `name` string, required — User-assigned name of the API Key.
    - `plaintext` string — The plaintext value of the API key. This field is returned only in the response to API key creation and is never again available in the plaintext form.
    - `preview` string, required — Last 8 characters of the API key.
    - `scopes` string[], required
    - `type` 'public' | 'secret', required
    - `updated_at` string, date-time, required — The timestamp of when the API key was last updated.
  - `total_count` integer, required — Total number of API keys.

## Changes

- **2025-02-25** `cdadac3315a1` — 2 info
  - the endpoint scheme security `apiKey` was added to the API
  - the endpoint scheme security `oauth2` was added to the API

[Change history](https://skmtc.dev/sumup/apis/sumup-rest-api/changes/v0.1/merchants/:merchant_code/api-keys/get.md)

---

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