Skip to main content

​
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. 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

ParameterTypeDefaultDescription
pageinteger1Page number
per_pageinteger20Items 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"
  }
}

curl https://api.knoxcall.com/v1/api-keys \
  -H "Authorization: Bearer tk_a1b2c3d4_..."