API Keys

List API Keys

Retrieve every secret API key (active or revoked) for the authenticated merchant. The keyValue field only contains the short prefix so the real secret never leaves the server again.

GET
/api-keys

Authorization

bearerAuth
AuthorizationBearer <token>

Use your secret API key as the bearer token

In: header

Response Body

application/json

application/json

curl -X GET "https://api.getlumen.dev/v1/api-keys"
{
  "success": true,
  "data": [
    {
      "id": "ak_01hrwzqrz4ytkwv07syv8k7g3z",
      "merchantId": "mrc_01hptv3p6xj173pfv96pxd5pke",
      "name": "Production dashboard",
      "keyType": "secret",
      "environment": "live",
      "permissions": [
        "admin"
      ],
      "keyValue": "sk_live_9s7f",
      "prefix": "sk_live_9s7f",
      "createdAt": "2025-02-12T18:43:02.982Z",
      "expiresAt": null,
      "revokedAt": null,
      "lastUsedAt": "2025-02-20T09:12:54.102Z"
    }
  ]
}
{
  "error": "Failed to list API keys",
  "details": "Database temporarily unavailable"
}