RecomlyRecomlyRecomlyDocs
API Keys

List API keys

List API keys for the authenticated user.

GET /app/api-keys

Returns metadata for all API keys belonging to the authenticated user. Each user only sees their own keys — this endpoint does not return keys belonging to other org members. The raw key secret is never returned after creation.

Requires the API Access plan feature. Available to all authenticated users (admin and user roles).


Request

See API Basics for required headers.

This endpoint takes no request body or query parameters.


Sample request

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

Sample response

Status: 200 OK

{
  "keys": [
    {
      "keyId": "rk_live_abc123",
      "email": "alice@acmeplumbing.com",
      "userId": "user-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.

StatusMeaning
403The API access feature is not enabled for the organization.

On this page

We use cookies

We use essential cookies to keep the site working, and optional analytics cookies to understand how it's used. Read our Privacy Policy.