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

# List API Keys

> Returns metadata for every API key minted against the authenticated partner's wallet.

## Overview

Lists all API keys (active and revoked) minted against the authenticated partner's wallet. Only metadata is returned — raw API key values are **never** retrievable after creation.

## Headers

<ParamField header="x-api-key" type="string" required>
  A valid `PARTNER` scope key for the partner whose keys you want to list.
</ParamField>

## Response

<ResponseField name="api_keys" type="array">
  <Expandable title="entry properties">
    <ResponseField name="key_id" type="string">
      UUID of the key record. Pass to [Revoke API Key](/api-reference/partner/revoke-api-key) to revoke.
    </ResponseField>

    <ResponseField name="key_name" type="string">
      Human-readable label supplied at creation.
    </ResponseField>

    <ResponseField name="scope" type="string">
      Scope granted to the key. Always `"PARTNER"` for partner-minted keys.
    </ResponseField>

    <ResponseField name="status" type="string">
      `"active"` or `"revoked"`.
    </ResponseField>

    <ResponseField name="wallet_address" type="string">
      Partner wallet that signed the challenge when the key was minted.
    </ResponseField>

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

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

    <ResponseField name="revoked_at" type="string | null">
      ISO-8601 timestamp of revocation, or `null` if the key is still active.
    </ResponseField>
  </Expandable>
</ResponseField>

## Errors

| HTTP | `error`        | When                           |
| ---- | -------------- | ------------------------------ |
| 401  | `unauthorized` | Missing or invalid `x-api-key` |

<RequestExample>
  ```bash cURL theme={null}
  curl https://grail-stack-dev.onrender.com/v1/partner/api-keys \
    -H "x-api-key: grail_partner_<hex>"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "api_keys": [
      {
        "key_id": "0c9bd7e4-6b2e-4f3a-a9a7-1f6e5d4c3b2a",
        "key_name": "integration test",
        "scope": "PARTNER",
        "status": "active",
        "wallet_address": "Fd31QxW7RRZwvMfNnhNaPvczJpMh7wyzBTWvtMA66wjN",
        "last_used_at": "2026-04-19T12:45:10.002Z",
        "created_at": "2026-04-19T12:30:45.123Z",
        "revoked_at": null
      }
    ]
  }
  ```
</ResponseExample>