List API keys

​

Overview

​

GET /api/v1/api-keys

• 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)

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

curl -X GET \
  'https://api.boltroute.ai/api/v1/api-keys'

​

Response

{
  "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
}

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

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