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

# List API keys

> List active API keys.

## Overview

List active API keys for the authenticated user, with optional filtering by last-used timestamps.

## GET /api/v1/api-keys

Purpose: list active API keys for the authenticated user.

Query parameters:

* `from` (RFC3339 timestamp, optional): filter by `last_used_at` >= from
* `to` (RFC3339 timestamp, optional): filter by `last_used_at` less than or equal to `to`
* `reveal` (boolean, optional): include plaintext keys in the response (requires `ENCRYPTION_KEY`)

Notes:

* When `reveal=true`, each key includes a plaintext `key` field.
* Keys are masked by default using `key_preview`.

Example request:

```bash theme={null}
curl -X GET \
  'https://api.boltroute.ai/api/v1/api-keys'
```

### Response

Status: `200 OK`

Example response:

```json theme={null}
{
  "keys": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "key_preview": "a1b2c3...9f0e",
      "name": "My Production Key",
      "purpose": "zapier",
      "last_used_at": "2025-01-01T12:00:00Z",
      "total_requests": 1234,
      "created_at": "2025-01-01T12:00:00Z",
      "is_active": true
    }
  ],
  "count": 1
}
```

Response fields:

* `keys[].key_preview`: masked key (present when `reveal=false`).
* `keys[].key`: plaintext key (present only when `reveal=true`).

Errors:

* `400` invalid query parameters.
* `401` unauthorized.
* `500` internal error (including when `reveal=true` and `ENCRYPTION_KEY` is missing).