> ## Documentation Index
> Fetch the complete documentation index at: https://docs.knoxcall.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List API Keys

> Returns a paginated list of API keys for your tenant

## List API Keys

```text theme={"dark"}
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

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

### Response

```json theme={"dark"}
{
  "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"
  }
}
```

<CodeGroup>
  ```bash cURL theme={"dark"}
  curl https://api.knoxcall.com/v1/api-keys \
    -H "Authorization: Bearer tk_a1b2c3d4_..."
  ```

  ```python Python theme={"dark"}
  import requests

  resp = requests.get(
      "https://api.knoxcall.com/v1/api-keys",
      headers={"Authorization": "Bearer tk_a1b2c3d4_..."}
  )
  keys = resp.json()["data"]
  ```

  ```javascript Node.js theme={"dark"}
  const resp = await fetch("https://api.knoxcall.com/v1/api-keys", {
    headers: { Authorization: "Bearer tk_a1b2c3d4_..." }
  });
  const { data: keys } = await resp.json();
  ```
</CodeGroup>