List API Keys - KnoxCall Docs

List API Keys

GET /v1/api-keys

Returns a paginated list of API keys for your tenant. Key values are masked — only the prefix is shown.

For new integrations we recommend OAuth clients or the SDK instead of long-lived API keys — see the Authentication guide. This endpoint remains fully supported; the examples below authenticate with a minted OAuth access token ($TOKEN).

Results are filtered by the host you call. The live host (api.knoxcall.com) returns only standard and access_key keys, while the sandbox host (sandbox.knoxcall.com) returns only test keys.

Query Parameters

Parameter	Type	Default	Description
`page`	integer	`1`	Page number
`per_page`	integer	`20`	Items per page (max 100)

Response

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "key_id": "tk_a1b2c3d4",
      "key_prefix": "tk_a1b2c3d4_",
      "key_type": "standard",
      "name": "Backend Server",
      "active": true,
      "created_at": "2026-01-15T09:30:00.000Z",
      "last_used_at": "2026-03-10T14:22:01.000Z",
      "rate_limit_requests": null,
      "rate_limit_window_sec": null
    }
  ],
  "meta": {
    "total": 3,
    "page": 1,
    "per_page": 20,
    "total_pages": 1,
    "request_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

# $TOKEN is a minted OAuth access token — see /api-reference/authentication
curl https://api.knoxcall.com/v1/api-keys \
  -H "Authorization: Bearer $TOKEN"

import os
import requests

resp = requests.get(
    "https://api.knoxcall.com/v1/api-keys",
    headers={"Authorization": f"Bearer {os.environ['KNOXCALL_ACCESS_TOKEN']}"}
)
keys = resp.json()["data"]

const resp = await fetch("https://api.knoxcall.com/v1/api-keys", {
  headers: { Authorization: `Bearer ${process.env.KNOXCALL_ACCESS_TOKEN}` }
});
const { data: keys } = await resp.json();