List API keys

GET /api/app/api-keys

Returns metadata for all API keys belonging to the organization. The raw key secret is never returned after creation.

Requires the API access feature entitlement (enabledFeatures.api). Available to all authenticated users.

Request

See API Basics for required headers.

This endpoint takes no request body or query parameters.

Sample request

curl https://api.recomly.com/api/app/api-keys \
  -H "Authorization: Bearer rk_live_abc123:def456"

Sample response

Status: 200 OK

{
  "keys": [
    {
      "keyId": "rk_live_abc123",
      "orgId": "a1b2c3d4-0000-4000-8000-e5f6a7b8c9d0",
      "email": "alice@acmeplumbing.com",
      "userId": "cognito-sub-uuid",
      "name": "Production integration",
      "createdAt": "2026-03-10T08:00:00.000Z",
      "lastUsedAt": "2026-04-14T17:32:00.000Z"
    }
  ]
}

lastUsedAt is omitted when the key has never been used.

Error responses

See API Basics for standard status codes and error response format.