このガイドでは、Claude Enterprise Admin APIを使用してClaudeエンタープライズ組織の支出制限と支出制限の引き上げリクエストについて説明します。支出制限により、各メンバーの使用クレジット支出を定期的な期間内で上限設定でき、各メンバーの制限がどこから継承されているかを確認でき、メンバーのより高い制限に対するリクエストを確認または対応できます。
ユーザーごとおよび時間単位の使用状況とコストレポートについては、Claude Enterprise Analytics APIリファレンスガイドを参照してください。
Claude Enterprise Admin APIは現在パブリックベータ版であり、使用クレジットが有効になっているエンタープライズプランの組織で利用可能です。
概要
2つのリソースにわたって8つのエンドポイントがあります。
リソース | エンドポイント | 用途 |
支出制限 |
| 各メンバーの有効な制限と期間内の支出を読み取り、ユーザーごとのオーバーライドを設定またはクリアします。 |
支出制限の引き上げリクエスト |
| メンバーのより高い制限に対するリクエストを一覧表示し、決定に必要なコンテキストを提供します。各リクエストを承認または拒否します。 |
支出制限エンドポイントを使用して、「各メンバーにどの制限が適用され、どこから来ているのか、そしてどの程度近いのか?」という質問に答え、ユーザーごとのオーバーライドを設定します。支出制限の引き上げリクエストエンドポイントを使用して、メンバーが送信したリクエストのキューを処理します。
前提条件と認証
組織はClaudeエンタープライズプランに登録している必要があります。
使用クレジットは組織に対して有効にする必要があります。プライマリオーナーはClaudeの請求設定でこれを有効にできます。
プライマリオーナーは、以下の1つまたは両方のスコープを持つAdmin APIキーを生成する必要があります。
read:spend_limits(すべてのGETエンドポイントに必須)write:spend_limits(POSTおよびDELETEエンドポイントに必須)
すべてのリクエストでx-api-keyヘッダーにキーを渡します。
重要:APIキーを公開で共有したり、ソース管理にチェックインしたりしないでください。
ベースURL
https://api.anthropic.com
レート制限
8つのエンドポイントすべてが、組織ごとに1分あたり60リクエストの単一の制限を共有します。制限を超えるリクエストは429 Too Many Requestsを返します。
ページネーション
GET /v1/organizations/spend_limits/effectiveとGET /v1/organizations/spend_limit_increase_requestsは不透明なカーソルでページネーションされます。最初のリクエストは最大limit行とnext_pageカーソルを返します。そのカーソルを次のリクエストでpageパラメータとして変更せずに渡し、next_pageがnullになるまで繰り返します。
重要:シーケンスの途中でクエリパラメータを変更しないでください。カーソルはそれらを発行したフィルタに関連付けられています。user_ids[]、status[]、またはactor_ids[]を変更して古いカーソルを渡すと、「cursor does not match current query parameters」というメッセージで400エラーが返されます。代わりに最初のページから新しいシーケンスを開始してください。
カーソル文字列を不透明として扱う:解析、変更、または自分で構築しないでください。
リストパラメータのシリアライズ
リストパラメータは括弧表記を使用します:各値に対して[]を付けてパラメータ名を繰り返します。
user_ids[]=user_01AbCdEfGh&user_ids[]=user_01JkLmNoPq
エラーレスポンス
ステータス | 意味 |
400 | 無効な入力、サポートされていないパラメータ値、ページカーソルが現在のパラメータと一致しない、または前提条件が満たされていません(エンドポイントごとの検証を参照)。 |
401 |
|
403 | APIキーに必要なスコープ( |
404 | リソースが見つかりません。APIキーが不明、期限切れ、または取り消されています。 |
429 | レート制限を超過しました。 |
500 | 内部エラー。 |
エラーボディの形式は以下の通りです:
{"type": "error", "error": {"type": "<error_type>", "message": "..."}, "request_id": "req_..."}
error.type はステータス依存の判別子です:invalid_request_error(400)、authentication_error(401)、permission_error(403)、not_found_error(404)、rate_limit_error(429)、api_error(500)。request_id は常に存在し、サポートに問い合わせる際に引用する値です。各エンドポイントの検証テーブルに特定のメッセージが記載されています。
概念
支出制限階層
各メンバーの使用クレジット支出は、スコープレベルの階層から解決される有効支出制限によって制限されます。メンバーがユーザー単位のオーバーライドを持たない場合、シートティア、グループ(組織がグループベースの制限を使用している場合)、または組織全体のデフォルトに設定された制限を継承します。
GET /v1/organizations/spend_limits/effective を読み取ると、解決された有効制限を持つすべての現在のメンバー、その制限が解決された場所(source)、および期間累計支出が返されます。POST /v1/organizations/spend_limits 経由でユーザー単位のオーバーライドを設定すると、メンバーは本来継承する内容に関係なく特定の制限に固定されます。オーバーライドを削除すると、継承された制限に戻ります。
スコープ
スコープは、支出制限が書き込まれたまたは解決されたレベルを識別します:
タイプ | フィールド | 意味 |
|
| 特定のメンバー。 |
|
| シートティアのデフォルト。 |
|
| 組織がグループ別に制限を管理する場合のグループデフォルト。 |
| — | 組織全体のデフォルト。 |
scope.type はオープン文字列です。クライアントは不明な値を不透明として扱い、失敗するのではなく次に進むべきです。追加のスコープタイプが将来追加される場合があります。
期間
period は制限が適用され支出がリセットされる定期的なウィンドウです。現在の唯一の値は "monthly" です。
period はオープン文字列です。クライアントは不明な値を不透明として扱い、失敗するのではなく次に進むべきです。追加の期間値が将来追加される場合があります。
金額と通貨
すべての金銭的価値は、組織の請求通貨の最小単位(USD の場合はセント)の文字列です。たとえば、"50000" は 500.00 USD を表します。小数として解析し、100 で割ってドルを表示します。大きな値の場合は、バイナリ浮動小数点を避けてください。
amount はヌル可能です:null は無制限(制限なし)を意味します。"0" は、そのメンバーに対して使用クレジットが無効であることを意味します。
period_to_date_spend は、現在の period の開始以降にメンバーが蓄積した使用クレジットで、同じ最小単位形式です。小数部を含む場合があります(たとえば、"41280.125")。
支出制限増加リクエストのライフサイクル
支出制限増加リクエストは、メンバーが claude.ai で「さらに使用をリクエスト」をクリックしたときに作成されます。このAPI経由ではリクエストは作成されません。
ステータス | 意味 |
| 管理者のアクションを待機中。リクエストは通常、メンバーの現在の有効制限と期間累計支出を確認できるようにライブ |
| リクエストは承認で解決されました:管理者が明示的に承認したか(管理者が指定した金額でユーザー単位の支出制限を書き込んだ)、別の管理者アクションがメンバーに使用クレジットを利用可能にした(たとえば、シートティア制限を引き上げたか、組織の使用クレジット請求を有効にした)、または Anthropic サポートが組織に代わって制限を引き上げました。 |
| 管理者が拒否しました。 |
approved と denied の両方がターミナルです。メンバーは最大 1 つの pending リクエストを持つことができます。
POST …/approve 経由で承認すると、POST /v1/organizations/spend_limits が書き込むのと同じユーザー単位の支出制限行が書き込まれます。支出制限を直接設定しても、保留中のリクエストは遷移しません。リクエストを解決するには approve エンドポイントを使用してください。
デフォルトでは、Anthropic はメンバーのリクエストが承認または拒否されたときにメンバーにメールを送信します。approve または deny で suppress_notification: true を渡して、そのメール(たとえば、独自のシステムがメンバーに通知する場合)を抑制します。
SpendLimit オブジェクト
1つのスコープレベルで設定された制限。
{
"type": "spend_limit",
"id": "spl_01AbCdEfGhIjKlMnOpQrSt",
"created_at": "2026-05-01T12:00:00Z",
"updated_at": "2026-05-03T09:14:11Z",
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "50000",
"currency": "USD",
"period": "monthly"
}フィールド | タイプ | 説明 |
| 文字列 | 常に |
| 文字列 |
|
| 文字列(RFC 3339) | この制限が最初に設定された時刻。 |
| 文字列(RFC 3339) | この制限が最後に変更された時刻。 |
| スコープ | この制限が書き込まれるレベル。「スコープ」セクションを参照してください。 |
| 文字列またはnull |
|
| 文字列 | ISO 4217。組織の請求通貨。 |
| 文字列 |
|
SpendSummaryオブジェクト
計算されたメンバーごとのレポート行:メンバーの有効な制限、その出所、および期間内の支出。アドレス指定可能なリソースではありません(idなし)。
{
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "50000",
"currency": "USD",
"period": "monthly",
"source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
"spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
"period_to_date_spend": "31402.5"
}フィールド | タイプ | 説明 |
| スコープ( | このロウが対象とするメンバー。 |
| 文字列またはnull |
|
| 文字列 | ISO 4217。 |
|
| The period of the spend limit that |
| スコープ |
|
| 文字列 |
|
| 文字列 | 現在の |
SpendLimitIncreaseRequest オブジェクト
{
"type": "spend_limit_increase_request",
"id": "slir_01AbCdEfGhIjKlMnOpQrSt",
"created_at": "2026-05-04T16:22:09Z",
"status": "pending",
"resolved_at": null,
"resolved_by": null,
"actor": {
"type": "user_actor",
"user_id": "user_01AbCdEfGh",
"name": "Jane Smith",
"email_address": "[email protected]"
},
"spend_summary": {
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "50000",
"currency": "USD",
"period": "monthly",
"source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
"spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
"period_to_date_spend": "48900"
}
}フィールド | タイプ | 説明 |
| 文字列 | 常に |
| 文字列 |
|
| 文字列(RFC 3339) | メンバーがリクエストを送信した時刻。 |
| 文字列 |
|
| 文字列(RFC 3339)または null | リクエストが承認または却下された時刻。保留中は |
| Actor または null | リクエストを承認または却下した者: |
| Actor( | リクエストを送信したメンバー。 |
| SpendSummary または null | リクエスター向けのライブ決定コンテキスト:有効なリミットと期間累計支出。 |
Actor
フィールド | タイプ | 説明 |
| 文字列 |
|
| 文字列 |
|
| 文字列または null |
|
| 文字列または null |
|
| 文字列 |
|
支出制限
1. 有効な支出制限を一覧表示
GET /v1/organizations/spend_limits/effective
組織の現在のすべてのメンバーを、解決された有効な制限と期間内の支出とともに返します。ユーザーごとのオーバーライドがないメンバーは、source.typeがseat_tier、rbac_group、またはorganizationで表示されます。退職したメンバーはリストされません。
必要なスコープ: read:spend_limits.
クエリパラメータ
フィールド | タイプ | 必須 | デフォルト | 説明 |
| 文字列、最大100エントリ | いいえ | すべてのメンバー | 特定のメンバーに絞り込みます。 |
| 整数1~1000 | いいえ | 20 | ページあたりの行数。 |
| 不透明なカーソル文字列 | いいえ | — | 前のレスポンスの |
レスポンスフィールド
フィールド | タイプ | 説明 |
| SpendSummaryの配列 | メンバーごとに1つのエントリ、メンバーが組織に参加した時期順(最新が最初)。 |
| 文字列またはnull | 次のページの不透明なカーソル。ページがない場合は |
リクエスト例
curl "https://api.anthropic.com/v1/organizations/spend_limits/effective?limit=20" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
レスポンス例
{
"data": [
{
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "50000",
"currency": "USD",
"period": "monthly",
"source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
"spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
"period_to_date_spend": "31402.5"
}
],
"next_page": "page_..."
}
検証
条件 | ステータス | メッセージ |
| 400 |
|
| 400 |
|
| 400 |
|
| 400 |
|
| 400 |
|
| 400 |
|
組織がエンタープライズプランに登録していません | 400 |
|
使用クレジット請求が有効になっていません | 400 |
|
2. 支出制限を取得する
GET /v1/organizations/spend_limits/{spend_limit_id}
IDで単一の支出制限を返します。SpendSummary.spend_limit_id または POST レスポンスが参照する行を検査するために使用します。
必要なスコープ: read:spend_limits。
パスパラメータ
フィールド | タイプ | 説明 |
| 文字列 |
|
レスポンス
SpendLimitオブジェクト。
リクエスト例
curl "https://api.anthropic.com/v1/organizations/spend_limits/spl_01AbCdEfGhIjKlMnOpQrSt" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
検証
条件 | ステータス | メッセージ |
| 404 |
|
組織がエンタープライズプランに登録していません | 400 |
|
使用クレジット請求が有効になっていません | 400 |
|
3. 支出制限を設定する
POST /v1/organizations/spend_limits
ユーザーごとの支出制限オーバーライドを設定します。アップサート: 既に制限を持つユーザーに対して制限を設定すると、その場で上書きされます。
scope.type: "user" のみが受け入れられます。シート層、グループ、および組織レベルのデフォルトは claude.ai 設定で構成されます。
支出制限を直接設定しても、メンバーの保留中の増加リクエストは遷移しません。承認エンドポイントを使用してリクエストを解決してください。
必要なスコープ: write:spend_limits。
リクエストボディ
フィールド | タイプ | 必須 | 説明 |
| オブジェクト | はい |
|
| 文字列またはnull | はい |
|
| 文字列 | いいえ | デフォルト |
レスポンス
書き込まれたオーバーライドを反映するSpendLimitオブジェクト。
リクエスト例
curl -X POST "https://api.anthropic.com/v1/organizations/spend_limits" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-H "content-type: application/json" \
-d '{"scope": {"type": "user", "user_id": "user_01AbCdEfGh"}, "amount": "75000"}'
レスポンス例
{
"type": "spend_limit",
"id": "spl_01RsTuVwXyZaBcDeFgHiJk",
"created_at": "2026-05-11T10:02:44Z",
"updated_at": "2026-05-11T10:02:44Z",
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "75000",
"currency": "USD",
"period": "monthly"
}
検証
条件 | ステータス | メッセージ |
| 400 |
|
| 400 |
|
| 400 |
|
| 400 |
|
| 400 |
|
組織がエンタープライズプランに登録していない | 400 |
|
使用クレジット請求が有効になっていない | 400 |
|
4. 支出制限を削除する
DELETE /v1/organizations/spend_limits/{spend_limit_id}
ユーザーごとのオーバーライドを削除して、メンバーが継承された制限(シート層、グループ、または組織のデフォルト)にフォールバックするようにします。シート層、グループ、および組織レベルの行はこのエンドポイント経由では削除できません。
スコープが必要です:write:spend_limits。
パスパラメータ
フィールド | タイプ | 説明 |
| 文字列 |
|
レスポンス
{ "type": "spend_limit_deleted", "id": "spl_01RsTuVwXyZaBcDeFgHiJk" }
リクエスト例
curl -X DELETE "https://api.anthropic.com/v1/organizations/spend_limits/spl_01RsTuVwXyZaBcDeFgHiJk" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
検証
条件 | ステータス | メッセージ |
| 404 |
|
| 400 |
|
組織がエンタープライズプランに登録していません | 400 |
|
使用クレジット請求が有効になっていません | 400 |
|
支出制限増加リクエスト
5. 増加リクエストをリストアップ
GET /v1/organizations/spend_limit_increase_requests
増加リクエストを最新順にリストアップします。リクエスターが組織のメンバーではなくなったリクエストは除外されます。
必要なスコープ: read:spend_limits。
クエリパラメータ
フィールド | タイプ | 必須 | デフォルト | 説明 |
|
| いいえ | すべて | ステータスでフィルタリングします。複数の値の場合はパラメータを繰り返します。 |
| 文字列 | いいえ | すべて | リクエスターでフィルタリングします。 |
| 整数 1–1000 | いいえ | 20 | ページあたりの行数。 |
| 不透明なカーソル文字列 | いいえ | — | 前のレスポンスの |
レスポンスフィールド
フィールド | タイプ | 説明 |
| SpendLimitIncreaseRequest の配列 |
|
| 文字列または null | 次のページの不透明なカーソル。ページがない場合は |
リクエスト例
curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests?status[]=pending&limit=50" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
レスポンス例
{
"data": [
{
"type": "spend_limit_increase_request",
"id": "slir_01AbCdEfGhIjKlMnOpQrSt",
"created_at": "2026-05-04T16:22:09Z",
"status": "pending",
"resolved_at": null,
"resolved_by": null,
"actor": {
"type": "user_actor",
"user_id": "user_01AbCdEfGh",
"name": "Jane Smith",
"email_address": "[email protected]"
},
"spend_summary": {
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "50000",
"currency": "USD",
"period": "monthly",
"source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
"spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
"period_to_date_spend": "48900"
}
}
],
"next_page": null
}
検証
条件 | ステータス | メッセージ |
| 400 |
|
| 400 |
|
| 400 |
|
| 400 |
|
別の API バージョンからの | 400 |
|
組織が Enterprise プランに登録していません | 400 |
|
使用クレジット課金が有効になっていません | 400 |
|
6. 増加リクエストを取得する
GET /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}
単一の増加リクエストを返します。
必要なスコープ: read:spend_limits。
パスパラメータ
フィールド | タイプ | 説明 |
| 文字列 |
|
レスポンス
SpendLimitIncreaseRequest オブジェクト。
リクエスト例
curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
検証
条件 | ステータス | メッセージ |
この組織でリクエストが見つかりません | 404 |
|
リクエスターはこの組織のメンバーではなくなりました | 404 |
|
組織はエンタープライズプランに登録していません | 400 |
|
使用クレジット請求が有効になっていません | 400 |
|
7. 増加リクエストを承認する
POST /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/approve
保留中のリクエストを承認します。amountでリクエスターのユーザーあたりの支出制限を書き込み、リクエストをapprovedに遷移させます。リクエストが要求額を含まない場合、管理者は承認時に新しい制限を提供します。
必要なスコープ: write:spend_limits。
パスパラメータ
フィールド | タイプ | 説明 |
| 文字列 |
|
リクエストボディ
フィールド | タイプ | 必須 | デフォルト | 説明 |
| 文字列 | はい | — |
|
| 文字列 | いいえ |
| 「期間」セクションを参照してください。 |
| ブール値 | いいえ |
|
|
レスポンス
ステータスapprovedのSpendLimitIncreaseRequest。書き込まれたSpendLimitを含む追加のspend_limitフィールドが含まれます。
リクエスト例
curl -X POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/approve" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-H "content-type: application/json" \
-d '{"amount": "75000", "suppress_notification": true}'
レスポンス例
{
"type": "spend_limit_increase_request",
"id": "slir_01AbCdEfGhIjKlMnOpQrSt",
"created_at": "2026-05-04T16:22:09Z",
"status": "approved",
"resolved_at": "2026-05-11T10:05:02Z",
"resolved_by": {
"type": "scoped_api_key_actor",
"scoped_api_key_id": "apikey_01ZyXwVuTsRqPoNmLkJiHg"
},
"actor": {
"type": "user_actor",
"user_id": "user_01AbCdEfGh",
"name": "Jane Smith",
"email_address": "[email protected]"
},
"spend_summary": null,
"spend_limit": {
"type": "spend_limit",
"id": "spl_01RsTuVwXyZaBcDeFgHiJk",
"created_at": "2026-05-11T10:05:02Z",
"updated_at": "2026-05-11T10:05:02Z",
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "75000",
"currency": "USD",
"period": "monthly"
}
}
検証
条件 | ステータス | メッセージ |
この組織でリクエストが見つかりません | 404 |
|
リクエスターはこの組織のメンバーではなくなりました | 404 |
|
リクエストは既に | 400 |
|
| 400 |
|
| 400 |
|
組織はエンタープライズプランに登録していません | 400 |
|
使用クレジット請求が有効になっていません | 400 |
|
8. 増加リクエストを拒否する
POST /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/deny
保留中のリクエストを拒否します。拒否時はべき等です: 既に拒否されたリクエストを拒否すると、既存のリソースで200が返されます。既に承認されたリクエストを拒否することは拒否されるため、自動化は再試行と矛盾する決定を区別できます。
スコープが必要です: write:spend_limits。
パスパラメータ
フィールド | タイプ | 説明 |
| 文字列 |
|
リクエストボディ
フィールド | タイプ | 必須 | デフォルト | 説明 |
| ブール値 | いいえ |
|
|
レスポンス
ステータスが拒否されたSpendLimitIncreaseRequest。
リクエスト例
curl -X POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/deny" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-H "content-type: application/json" \
-d '{"suppress_notification": true}'
検証
条件 | ステータス | メッセージ |
この組織でリクエストが見つかりません | 404 |
|
リクエスターはこの組織のメンバーではなくなりました | 404 |
|
リクエストは既に | 400 |
|
リクエストは既に | — (200, idempotent) |
|
組織はエンタープライズプランに登録していません | 400 |
|
使用クレジットが有効になっていません | 400 |
|
