API キー一覧

現在のユーザー(または指定した組織)が所有する標準 API キーを一覧表示します。これは管理エンドポイントです。Bearer トークンで認証する場合、それは Management API Key である必要があり、通常の sk-bl- キーではこのエンドポイントを呼び出せません。ログイン済みのセッション Cookie でも動作します(Web ダッシュボード用)。レスポンスに生のキー値が含まれることはなく、prefix/suffix のみです。

GET/api/v1/keys

認証

Authorization必須

string · header

Authorization ヘッダーに Bearer トークンとして API キーを渡します。

クエリパラメータ

orgId

string

呼び出し元個人のキーだけでなく、組織全体のキーを一覧表示します。呼び出し元はその組織で org_admin または billing_viewer である必要があり、そうでない場合は 403 を返します。

GET /api/v1/keys

1
2
curl https://bazaarlink.ai/api/v1/keys \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY"

レスポンス例

成功。keys[] は作成日時の新しい順に並び、各項目に利用統計、支出上限、組織スコープ、サブスクリプションプラン(あれば)が含まれます——生のキー値自体は含まれません。limitRemainingUsd はこのキー自身のリセット期間に基づいて計算済みの残額(無制限なら null)、usageDailyUsd/usageWeeklyUsd/usageMonthlyUsd は spendLimitPeriod に関係ない固定カレンダー区間の内訳です。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
{
  "keys": [
    {
      "id": "key_abc123",
      "name": "production",
      "keyPrefix": "sk-bl-",
      "keySuffix": "hDS5",
      "enabled": true,
      "keyType": "standard",
      "requestCount": 1204,
      "totalTokens": 892340,
      "lastUsed": "2026-07-27T03:12:00.000Z",
      "createdAt": "2026-05-01T00:00:00.000Z",
      "spendLimitUsd": 50,
      "spendLimitPeriod": "month",
      "allowedModels": null,
      "expiresAt": null,
      "subscriptionPlanId": null,
      "subscriptionStatus": null,
      "subscriptionStartedAt": null,
      "organizationId": null,
      "teamId": null,
      "orgMemberId": null,
      "subscriptionPlan": null,
      "periodSpendUsd": 4.82,
      "limitRemainingUsd": 45.18,
      "usageDailyUsd": 0.4,
      "usageWeeklyUsd": 2.1,
      "usageMonthlyUsd": 4.82
    }
  ]
}