Claude Enterprise Admin API リファレンスガイド

このガイドでは、Claude Enterprise Admin APIを使用してClaudeエンタープライズ組織の支出制限と支出制限の引き上げリクエストについて説明します。支出制限により、各メンバーの使用クレジット支出を定期的に上限に設定し、各メンバーの制限がどこから継承されているかを確認し、メンバーのより高い制限に対するリクエストを確認または対応することができます。

ユーザーごとおよび時間単位の使用状況とコストレポートについては、Analytics APIリファレンスガイドを参照してください。

Claude Enterprise Admin APIは現在パブリックベータ版であり、使用クレジットが有効になっているエンタープライズプランの組織で利用可能です。

概要

2つのリソースにわたって8つのエンドポイントがあります。

リソース	エンドポイント	用途
支出制限	`GET /v1/organizations/spend_limits/effective` `GET /v1/organizations/spend_limits/{spend_limit_id}` `POST /v1/organizations/spend_limits` `DELETE /v1/organizations/spend_limits/{spend_limit_id}`	各メンバーの有効な制限と期間内の支出を読み取り、ユーザーごとのオーバーライドを設定またはクリアします。
支出制限の引き上げリクエスト	`GET /v1/organizations/spend_limit_increase_requests` `GET /v1/organizations/spend_limit_increase_requests/{id}` `POST /v1/organizations/spend_limit_increase_requests/{id}/approve` `POST /v1/organizations/spend_limit_increase_requests/{id}/deny`	メンバーのより高い制限に対するリクエストを、決定に必要なコンテキストとともにリストアップし、各リクエストを承認または拒否します。

支出制限エンドポイントを使用して、「各メンバーにどの制限が適用され、どこから来ているのか、そしてどの程度近いのか」という質問に答え、ユーザーごとのオーバーライドを設定します。支出制限の引き上げリクエストエンドポイントを使用して、メンバーが送信したリクエストのキューを処理します。

前提条件と認証

組織はClaudeエンタープライズプランに登録している必要があります。
組織に対して使用クレジットを有効にする必要があります。プライマリオーナーはClaudeの請求設定でこれを有効にできます。
プライマリオーナーは、以下のスコープの1つまたは両方を持つAdmin APIキーを作成する必要があります。
- read:spend_limits（すべてのGETエンドポイントに必須）
- write:spend_limits（POSTおよびDELETEエンドポイントに必須）

すべてのリクエストでx-api-keyヘッダーにキーを渡します。

重要: APIキーを公開で共有したり、ソース管理にチェックインしたりしないでください。

Claude Enterpriseエンタープライズ組織のAdmin APIキーを作成する

プライマリオーナーとしてサインイン—Claude Enterpriseの親組織のプライマリオーナーのみがこれらのキーを作成できます。
APIの設定を開く—組織設定 > APIに移動し、キーセクションを見つけます。
クリックしてキーを作成—キーに名前を付け、スコープテーブルから必要なスコープを選択します。1つのキーで異なるAPI（たとえば、read:analyticsとread:spend_limits）からスコープを組み合わせることができます。
シークレットをコピーして保存—表示されたシークレット（sk-ant-api01-で始まる）をコピーして、シークレットマネージャーに保存します。完全なシークレットは1回だけ表示されます。

ベース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[]を変更して古いカーソルを渡すと、「カーソルが現在のクエリパラメータと一致しません」というメッセージで400エラーが返されます。代わりに最初のページから新しいシーケンスを開始してください。

カーソル文字列を不透明として扱う：解析、変更、または自分で構築しないでください。

リストパラメータのシリアライズ

リストパラメータはブラケット表記を使用します：各値に対して[]を付けてパラメータ名を繰り返します。

user_ids[]=user_01AbCdEfGh&user_ids[]=user_01JkLmNoPq

エラーレスポンス

ステータス	意味
400	無効な入力、サポートされていないパラメータ値、ページカーソルが現在のパラメータと一致しない、または前提条件が満たされていません（エンドポイントごとの検証を参照）。
401	`x-api-key`ヘッダーがありません。
403	APIキーに必要なスコープ（`read:spend_limits`または`write:spend_limits`）がありません。
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を介してユーザーごとのオーバーライドを設定すると、メンバーは本来継承するはずの内容に関係なく、特定の制限に固定されます。オーバーライドを削除すると、継承された制限に戻ります。

スコープ

スコープは、支出制限が書き込まれたまたは解決されたレベルを識別します：

タイプ	フィールド	意味
`user`	`user_id`	特定のメンバー。`user_id`はAdmin API ユーザーエンドポイントによって返されるIDと一致します。
`seat_tier`	`seat_tier`	シートティアのデフォルト。`seat_tier`の値は`enterprise_standard`または`enterprise_tier_1`などの完全修飾識別子です。追加の値が追加される場合があります。
`rbac_group`	`rbac_group_id`	組織がグループ別に制限を管理する場合のグループデフォルト。
`organization`	—	組織全体のデフォルト。

scope.typeはオープン文字列です。クライアントは不明な値を不透明として扱い、失敗するのではなく、フォールスルーする必要があります。追加のスコープタイプが将来追加される可能性があります。

期間

periodは、制限が適用され、支出がリセットされる定期的なウィンドウです。現在の唯一の値は"monthly"です。

periodはオープン文字列です。クライアントは不明な値を不透明として扱い、失敗するのではなく、フォールスルーする必要があります。追加の期間値が将来追加される可能性があります。

金額と通貨

すべての金銭的価値は、組織の請求通貨のマイナー単位（USDの場合はセント）の文字列です。たとえば、"50000"は500.00 USDを表します。小数として解析し、100で割ってドルを表示します。大きな値の場合は、バイナリ浮動小数点を避けてください。

amountはヌル可能です：nullは無制限（制限なし）を意味します。"0"は、そのメンバーに対して使用クレジットが無効であることを意味します。

period_to_date_spendは、メンバーが現在のperiodの開始以降に発生した使用クレジットで、同じマイナー単位形式です。小数部を含む場合があります（たとえば、"41280.125"）。

支出制限増加リクエストのライフサイクル

支出制限増加リクエストは、メンバーがclaude.aiで「さらに使用をリクエスト」をクリックしたときに作成されます。リクエストはこのAPIを介して作成されません。

ステータス	意味
`pending`	管理者のアクションを待機中。リクエストは通常、ライブな`spend_summary`を含むため、決定する際にメンバーの現在の有効制限と期間累計支出を確認できます。計算できない場合、`spend_summary`は`null`の可能性があるため、そのケースに対応してください。
`approved`	リクエストは承認で解決されました：管理者が明示的に承認したか（管理者が提供した金額でユーザーごとの支出制限を書き込んだ）、別の管理者アクションがメンバーに使用クレジットを利用可能にした（たとえば、シートティア制限を引き上げたか、組織の使用クレジット請求を有効にした）、またはAnthropicサポートが組織に代わって制限を引き上げました。`spend_summary`は`null`です。
`denied`	管理者が却下しました。`spend_summary` は `null` です。Claude.ai は、`resolved_at` から 30 日間、そのメンバーのリクエストボタンを非表示にします。管理者はいつでもメンバーの制限を直接引き上げることができます。

approved と denied は両方とも最終状態です。メンバーは一度に最大 1 つの pending リクエストを持つことができます。

POST …/approve 経由で承認すると、POST /v1/organizations/spend_limits が書き込むのと同じユーザーごとの支出制限行が書き込まれます。支出制限を直接設定しても、保留中のリクエストは遷移しません。リクエストを解決するには、承認エンドポイントを使用してください。

デフォルトでは、Anthropic はメンバーのリクエストが承認または却下されたときにメンバーにメールを送信します。承認または却下時に 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"
}

フィールド	タイプ	説明
`type`	文字列	常に `"spend_limit"` です。
`id`	文字列	`spl_` で始まります。
`created_at`	文字列（RFC 3339）	この制限が最初に設定されたとき。
`updated_at`	文字列（RFC 3339）	この制限が最後に変更されたとき。
`scope`	スコープ	この制限が書き込まれるレベル。「スコープ」セクションを参照してください。
`amount`	文字列または null	`period` の制限（マイナー単位）。`null` は無制限を意味します。
`currency`	文字列	ISO 4217。組織の請求通貨。
`period`	文字列	`amount` が適用される定期的なウィンドウ。「期間」セクションを参照してください。

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"
}

フィールド	タイプ	説明
`scope`	スコープ（`type: "user"`）	この行が対象とするメンバー。
`amount`	文字列または null	`period` の有効な制限（マイナー単位）。`null` は無制限を意味します。`"0"` は使用クレジットが無効になっていることを意味します。
`currency`	文字列	ISO 4217。
`period`	文字列	`source` が解決した支出制限の期間。「期間」セクションを参照してください。
`source`	スコープ	`amount`が階層内のどこから解決されたか。メンバーがユーザーごとのオーバーライドを持つ場合は`scope`と同じ。
`spend_limit_id`	文字列	`source`が解決された`SpendLimit`のID。`GET /v1/organizations/spend_limits/{spend_limit_id}`で取得できます。
`period_to_date_spend`	文字列	現在の`period`の開始以降にメンバーが蓄積した使用クレジット（マイナー単位）。

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"
  }
}

フィールド	タイプ	説明
`type`	文字列	常に`"spend_limit_increase_request"`。
`id`	文字列	`slir_`が接頭辞として付きます。
`created_at`	文字列（RFC 3339）	メンバーがリクエストを送信した時刻。
`status`	文字列	`pending`、`approved`、または`denied`。
`resolved_at`	文字列（RFC 3339）またはnull	リクエストが承認または拒否された時刻。保留中はnull。
`resolved_by`	アクターまたはnull	リクエストを承認または拒否した者：`user_actor`（管理者がclaude.aiで操作）または`scoped_api_key_actor`（このAPIで解決）。管理者がclaude.aiでのアクション（例：シートティアリミットの引き上げ、組織の使用クレジット課金の有効化、メンバーのリミット引き上げ）によってリクエストが自動解決された場合、`resolved_by`は操作した管理者の`user_actor`。保留中、解決した管理者のアカウントが削除された場合、またはリクエストがAnthropicサポートで解決された場合はnull。`scoped_api_key_actor`は削除またはリボークされたキーを参照する場合があります。`scoped_api_key_id`を履歴参照として扱い、ルックアップ失敗を許容してください。
`actor`	アクター（`user_actor`）	リクエストを送信したメンバー。
`spend_summary`	SpendSummaryまたはnull	リクエスター向けのライブ決定コンテキスト：有効なリミットと期間累計支出。`status`が保留中の場合に表示（サマリーが計算できない場合はnullの可能性あり）；解決後は常にnull。

アクター

フィールド	タイプ	説明
`type`	文字列	`user_actor`または`scoped_api_key_actor`。
`user_id`	文字列	`user_actor`に表示。ユーザーのID；`actor_ids[]`で受け入れられる同じ値。
`name`	文字列またはnull	`user_actor`に表示。ユーザーの名前；アカウントが削除されている場合またはユーザーが名前を設定していない場合はnull。
`email_address`	文字列またはnull	`user_actor`に表示されます。ユーザーのメールアドレス。アカウントが削除されている場合は`null`です。
`scoped_api_key_id`	文字列	`scoped_api_key_actor`に表示されます。`apikey_`が接頭辞として付きます。

支出制限

1. 有効な支出制限を一覧表示

GET /v1/organizations/spend_limits/effective

組織の現在のすべてのメンバーを、解決された有効な制限と期間内の支出とともに返します。ユーザーごとのオーバーライドがないメンバーは、source.typeがseat_tier、rbac_group、またはorganizationで表示されます。退職したメンバーはリストされません。

スコープが必要です: read:spend_limits.

クエリパラメータ

フィールド	タイプ	必須	デフォルト	説明
`user_ids[]`	文字列、最大100エントリ	いいえ	すべてのメンバー	特定のメンバーに絞り込みます。`user_...` IDを受け入れます。現在のメンバーではないエントリは`data`から暗黙的に除外されます。
`limit`	整数1～1000	いいえ	20	ページあたりの行数。
`page`	不透明なカーソル文字列	いいえ	—	前のレスポンスの`next_page`値。

レスポンスフィールド

フィールド	タイプ	説明
`data`	SpendSummaryの配列	メンバーごとに1つのエントリ。メンバーが組織に参加した時刻の順序（最新が最初）。
`next_page`	文字列またはnull	次のページの不透明なカーソル。ページがない場合は`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_..."
}

検証

条件	ステータス	メッセージ
`user_ids[]`エントリの形式が正しくありません	400	`user_ids[]: entry is not a valid user ID`
`user_ids[]` に 100 件を超えるエントリがあります	400
`limit` が 1～1000 の範囲外です	400
`page` カーソルが無効です	400	`page: invalid cursor`
`page` カーソルが現在の `user_ids[]` と一致しません	400	`page: cursor does not match current query parameters`
別の API バージョンからの `page` カーソル	400	`page: cursor was issued by a different API version`
組織が Enterprise プランに登録していません	400	`this endpoint is not supported for this organization type`
使用クレジット課金が有効になっていません	400	`overage billing is not enabled for this organization`

2. 支出制限を取得する

GET /v1/organizations/spend_limits/{spend_limit_id}

ID で単一の支出制限を返します。SpendSummary.spend_limit_id または POST レスポンスが参照する行を検査するために使用します。

必要なスコープ: read:spend_limits

パスパラメータ

フィールド	タイプ	説明
`spend_limit_id`	文字列	`spl_` のプレフィックス付き。

レスポンス

SpendLimit オブジェクト。

リクエスト例

curl "https://api.anthropic.com/v1/organizations/spend_limits/spl_01AbCdEfGhIjKlMnOpQrSt" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

検証

条件	ステータス	メッセージ
`spend_limit_id` がこの組織に見つかりません	404
組織が Enterprise プランに登録していません	400	`this endpoint is not supported for this organization type`
使用クレジット課金が有効になっていません	400	`overage billing is not enabled for this organization`

3. 支出制限を設定する

POST /v1/organizations/spend_limits

ユーザーごとの支出制限上書きを設定します。アップサート: 既に制限があるユーザーに対して制限を設定すると、その場で上書きされます。

scope.type: "user" のみが受け入れられます。シート層、グループ、および組織レベルのデフォルトは claude.ai 設定で構成されます。

支出制限を直接設定しても、メンバーの保留中の増加リクエストは遷移しません。リクエストを解決するには承認エンドポイントを使用してください。

必要なスコープ: write:spend_limits

リクエストボディ

フィールド	タイプ	必須	説明
`scope`	オブジェクト	はい	`{ "type": "user", "user_id": "user_..." }`。
`amount`	文字列またはnull	はい	`period`の新しい制限（マイナー単位、負でない整数の10進数文字列）。`"0"`はメンバーの使用クレジットを無効にします。`null`は制限を削除します（無制限）。
`period`	文字列	いいえ	デフォルト`"monthly"`。「期間」セクションを参照してください。

レスポンス

書き込まれたオーバーライドを反映する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"
}

検証

条件	ステータス	メッセージ
`scope.type`が`"user"`ではない	400	`scope.type: まだサポートされていません`
`scope.user_id`の形式が正しくない	400	`scope.user_id: 形式が正しくありません`
`scope.user_id`がこの組織のメンバーではない	400	`scope.user_id: この組織のメンバーではありません`
`amount`が負の値、小数、または有効な10進数文字列ではない	400
`period`が`"monthly"`ではない	400	`period: まだサポートされていません`
組織がエンタープライズプランに登録していない	400	`このエンドポイントはこの組織タイプではサポートされていません`
使用クレジット請求が有効になっていない	400	`この組織では超過請求が有効になっていません`

4. 支出制限を削除する

DELETE /v1/organizations/spend_limits/{spend_limit_id}

ユーザーごとのオーバーライドを削除して、メンバーが継承された制限（シート層、グループ、または組織のデフォルト）にフォールバックするようにします。シート層、グループ、および組織レベルの行はこのエンドポイント経由では削除できません。

スコープが必要です：write:spend_limits。

パスパラメータ

フィールド	タイプ	説明
`spend_limit_id`	文字列	プレフィックス `spl_`。ユーザーごとのオーバーライドのIDである必要があります。

レスポンス

{ "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"

検証

条件	ステータス	メッセージ
`spend_limit_id` がこの組織に見つかりません	404
`spend_limit_id` はシート層、グループ、または組織行です	400	`このエンドポイント経由で削除できるのはユーザーごとの支出制限のみです。`
組織がエンタープライズプランに登録していません	400	`このエンドポイントはこの組織タイプではサポートされていません`
使用クレジット請求が有効になっていません	400	`この組織では超過請求が有効になっていません`

支出制限増加リクエスト

5. 増加リクエストをリストアップ

GET /v1/organizations/spend_limit_increase_requests

増加リクエストを最新順にリストアップします。リクエスターが組織のメンバーではなくなったリクエストは除外されます。

必要なスコープ: read:spend_limits。

クエリパラメータ

フィールド	タイプ	必須	デフォルト	説明
`status[]`	`pending`、`approved`、`denied` のいずれか1つ以上	いいえ	すべて	ステータスでフィルタリングします。複数の値の場合はパラメータを繰り返してください。
`actor_ids[]`	文字列	いいえ	すべて	リクエスターでフィルタリングします。`user_...` IDを受け入れます。
`limit`	整数 1–1000	いいえ	20	ページあたりの行数。
`page`	不透明なカーソル文字列	いいえ	—	前のレスポンスからの `next_page` 値。

レスポンスフィールド

フィールド	タイプ	説明
`data`	SpendLimitIncreaseRequest の配列	`created_at` で降順に並べられています。
`next_page`	文字列または null	次のページの不透明なカーソル。ページがない場合は `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
}

検証

条件	ステータス	メッセージ
`actor_ids[]` エントリが不正な形式	400	`actor_ids[]: 無効なタグ付きユーザー ID`
`limit` が 1～1000 の範囲外	400
`page` カーソルが不正な形式	400	`無効なページカーソル形式` または `無効なページカーソル`
`page` カーソルが現在の `status[]` または `actor_ids[]` と一致しません	400	`ページカーソルが現在のクエリパラメータと一致しません`
別の API バージョンからの `page` カーソル	400	`ページカーソルは別の API バージョンで発行されました。ページネーションを再開してください`
組織が Enterprise プランに登録していません	400	`このエンドポイントはこの組織タイプではサポートされていません`
使用クレジット課金が有効になっていません	400	`この組織では超過課金が有効になっていません`

6. 増加リクエストを取得

GET /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}

単一の増加リクエストを返します。

必要なスコープ: read:spend_limits。

パスパラメータ

フィールド	タイプ	説明
`spend_limit_increase_request_id`	文字列	`slir_` でプレフィックスされています。

レスポンス

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。

パスパラメータ

フィールド	タイプ	説明
`spend_limit_increase_request_id`	文字列	`slir_`が接頭辞として付きます。

リクエストボディ

フィールド	タイプ	必須	デフォルト	説明
`amount`	文字列	はい	—	`period`の新しいユーザーあたりの制限。マイナー単位で、負でない整数の10進文字列として表示されます。
`period`	文字列	いいえ	`"monthly"`	「期間」セクションを参照してください。
`suppress_notification`	ブール値	いいえ	`false`	`true`の場合、Anthropicはメンバーにリクエストが承認されたことをメールで通知しません。

レスポンス

ステータス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	`支出制限増加リクエストは既に解決されています`
`金額`が負の値、小数、または有効な10進数文字列ではありません	400
`期間`が`"月次"`ではありません	400	`期間: まだサポートされていません`
オーガニゼーションはエンタープライズプランに登録していません	400	`このエンドポイントはこのオーガニゼーションタイプではサポートされていません`
使用クレジット請求が有効になっていません	400	`このオーガニゼーションでは超過請求が有効になっていません`

8. 増加リクエストを拒否する

POST /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/deny

保留中のリクエストを拒否します。拒否時にべき等です: 既に拒否されたリクエストを拒否すると、既存のリソースで200が返されます。既に承認されたリクエストを拒否することは拒否されるため、自動化は再試行と競合する決定を区別できます。

スコープが必要です: write:spend_limits。

パスパラメータ

フィールド	タイプ	説明
`spend_limit_increase_request_id`	文字列	`slir_`が接頭辞として付きます。

リクエストボディ

フィールド	タイプ	必須	デフォルト	説明
`suppress_notification`	ブール値	いいえ	`false`	`true`の場合、Anthropicはそのメンバーのリクエストが拒否されたことをメールで通知しません。

レスポンス

ステータスが拒否された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	`この組織では超過分の請求が有効になっていません`