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

# 列出 API Keys

> 列出目前管理令牌所屬組織下的使用者 API Key。

## 概覽

返回目前管理令牌所屬組織下的使用者 API Key 清單。

## 注意事項

* 系統代管的 Key 不會出現在結果中。

## 範例

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.tokenlab.sh/v1/management/api-keys" \
    -H "Authorization: Bearer mt-your-management-token"
  ```
</RequestExample>

## 請求 / 回應

使用上方的互動式 OpenAPI 面板以取得確切的架構。

## Response example

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "object": "list",
    "data": [
      {
        "id": "key_abc123def456",
        "name": "Backend Worker",
        "key_prefix": "sk-live...",
        "status": "active",
        "limit_amount": 500,
        "limit_amount_decimal": "500",
        "used_amount": 148.25,
        "used_amount_decimal": "148.25",
        "models": [
          "gpt-5-mini",
          "claude-3-7-sonnet"
        ],
        "expires_at": "2026-12-31T23:59:59.000Z",
        "last_used_at": "2026-07-08T03:12:45.000Z",
        "created_at": "2026-07-01T10:00:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 50,
      "total": 1,
      "totalPages": 1
    }
  }
  ```
</ResponseExample>

## Important fields

<ResponseField name="object" type="string">Always `list`.</ResponseField>
<ResponseField name="data" type="array">Array of API key objects.</ResponseField>
<ResponseField name="pagination" type="object">Pagination metadata with `page`, `limit`, `total`, and `totalPages`.</ResponseField>
<ResponseField name="data[].id" type="string">API key identifier used in follow-up Management API calls.</ResponseField>
<ResponseField name="data[].name" type="string">Display name for the API key.</ResponseField>
<ResponseField name="data[].key_prefix" type="string">Non-secret key prefix for display and support.</ResponseField>
<ResponseField name="data[].status" type="string">One of `active`, `inactive`, or `revoked`.</ResponseField>
<ResponseField name="data[].limit_amount" type="number | null">Spending cap in USD as a JSON number for display. `null` means unlimited.</ResponseField>
<ResponseField name="data[].limit_amount_decimal" type="string | null">Exact spending cap in USD as a decimal string. `null` means unlimited.</ResponseField>
<ResponseField name="data[].used_amount" type="number">Accumulated usage in USD as a JSON number for display.</ResponseField>
<ResponseField name="data[].used_amount_decimal" type="string">Exact accumulated usage in USD as a decimal string.</ResponseField>
<ResponseField name="data[].models" type="string[]">Per-key model allowlist. Empty array means no additional key-level model restriction.</ResponseField>
<ResponseField name="data[].expires_at" type="string | null">ISO timestamp when the key expires, or `null` for no expiry.</ResponseField>
<ResponseField name="data[].last_used_at" type="string | null">ISO timestamp for the most recent use, or `null` when unused.</ResponseField>
<ResponseField name="data[].created_at" type="string">ISO creation timestamp.</ResponseField>
