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

# List API Keys

> Retrieve all API keys belonging to your organization.

Fetch every API key associated with your organization. Handy for auditing access or building a key management UI.

## Authorization

Requires an **organization-level** API key in the `Authorization` header.

## Response

Returns an array of key objects. Note that the raw key value is **never** included — we only store hashes, so what you see is what you get.

<ResponseField name="id" type="string">
  Unique identifier for the key.
</ResponseField>

<ResponseField name="organization_id" type="string">
  The organization this key belongs to.
</ResponseField>

<ResponseField name="name" type="string">
  The human-readable name assigned at creation.
</ResponseField>

<ResponseField name="key_prefix" type="string">
  The key prefix (`chd_sk_`).
</ResponseField>

<ResponseField name="is_active" type="boolean">
  Whether the key is currently active. Revoked or expired keys will show `false`.
</ResponseField>

<ResponseField name="expires_at" type="string | null">
  Expiration datetime, if one was set.
</ResponseField>

<ResponseField name="last_used_at" type="string | null">
  The last time this key was used to authenticate a request. `null` if the key has never been used.
</ResponseField>

<ResponseField name="created_at" type="string">
  When the key was created.
</ResponseField>

<RequestExample>
  ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  curl https://api.chowder.dev/v1/keys \
    -H "Authorization: Bearer chd_sk_your_org_key"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  [
    {
      "id": "key_9f8a7b6c",
      "organization_id": "org_1a2b3c4d",
      "name": "Production Bot Key",
      "key_prefix": "chd_sk_",
      "is_active": true,
      "expires_at": "2026-12-31T23:59:59Z",
      "last_used_at": "2026-02-14T08:30:00Z",
      "created_at": "2026-02-14T12:00:00Z"
    },
    {
      "id": "key_3e4f5g6h",
      "organization_id": "org_1a2b3c4d",
      "name": "Dev Testing Key",
      "key_prefix": "chd_sk_",
      "is_active": false,
      "expires_at": null,
      "last_used_at": null,
      "created_at": "2026-01-10T09:15:00Z"
    }
  ]
  ```
</ResponseExample>
