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

# List API Keys

> List all API keys for the authenticated user. Raw key values are never returned — only metadata.

<Note>
  This endpoint uses your dashboard session (Auth0 JWT), not an API key.
</Note>

### Response

Returns an array of key objects ordered by `created_at` descending.

<ResponseField name="id" type="string">
  Unique key identifier. Use this when revoking.
</ResponseField>

<ResponseField name="name" type="string">
  The label assigned when the key was created.
</ResponseField>

<ResponseField name="key_prefix" type="string">
  First 8 characters of the key. Useful for identifying a key in logs.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 creation timestamp.
</ResponseField>

<ResponseField name="last_used_at" type="string | null">
  ISO 8601 timestamp of the most recent validated request, or `null` if the key has never been used.
</ResponseField>

<ResponseField name="request_count" type="number">
  Total number of validated requests made with this key.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -s "https://api.impulselabs.ai/api/api-keys" \
    -H "Authorization: Bearer <your-dashboard-session-token>"
  ```

  ```python Python theme={null}
  import requests

  resp = requests.get(
      "https://api.impulselabs.ai/api/api-keys",
      headers={"Authorization": "Bearer <dashboard-token>"},
  )
  print(resp.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "production",
      "key_prefix": "imp_a1b2",
      "created_at": "2026-02-19T12:00:00.000Z",
      "last_used_at": "2026-02-19T14:32:11.000Z",
      "request_count": 47
    },
    {
      "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
      "name": "ci-pipeline",
      "key_prefix": "imp_c3d4",
      "created_at": "2026-01-10T09:15:00.000Z",
      "last_used_at": null,
      "request_count": 0
    }
  ]
  ```
</ResponseExample>
