Spend Limits API

Spend Limits APIを使用すると、Claude Enterpriseの各メンバーに支出上限を設定し、各メンバーの支出上限がどこから継承されているかを確認し、メンバーからの上限引き上げリクエストを確認または対応できます。

ユーザー別および時間バケット別の使用量とコストのレポートについては、Analytics APIを参照してください。



概要

このAPIは、2つのリソースにわたって8つのエンドポイントを公開しています。

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



前提条件

• 組織がClaude Enterpriseプランに加入している必要があります。
• 組織で使用量クレジットが有効になっている必要があります。プライマリオーナーはclaude.aiの請求設定で有効にできます。



クイックスタート

すべてのメンバーの有効な月次支出上限と期間内の累計支出を一覧表示します。

curl "https://api.anthropic.com/v1/organizations/spend_limits/effective?limit=20" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"



主要な概念



支出上限の階層

有効な支出上限（effective spend limit）は、スコープレベルの階層から解決されて各メンバーの支出に適用されます。メンバーにユーザー単位のオーバーライドがない場合、そのメンバーは所属グループ（組織がグループベースの上限を使用している場合）、シートティア、または組織全体のデフォルトに設定された支出上限を継承します。グループの支出上限はメンバーごとのデフォルトです。つまり、それを継承する各メンバーは、プールされたグループ予算ではなく、自分自身の支出に対して制限されます。

GET /v1/organizations/spend_limits/effectiveを読み取ると、現在のすべてのメンバーが、解決された有効な支出上限、その上限がどこから解決されたか（source）、および期間内の累計支出とともに返されます。POST /v1/organizations/spend_limitsでユーザー単位のオーバーライドを設定すると、そのメンバーは本来継承するはずの値に関係なく、特定の支出上限に固定されます。オーバーライドを削除すると、メンバーは継承された支出上限に戻ります（継承元が存在しない場合は無制限になります）。

各メンバーの行にあるsourceフィールドは、その支出上限がどのレベルから解決されたかを示します。user（ユーザー単位のオーバーライド）、seat_tier、rbac_group、またはorganizationのいずれかです。スコープタイプはオープンセットとして扱い、未知の値に対してはエラーにせずフォールスルーしてください。



期間

periodは、支出上限が適用され支出がリセットされる繰り返しウィンドウです。支出上限は(scope, period)のペアで識別されます。現在サポートされている期間はmonthlyのみで、月次支出は各暦月の1日の00



金額と通貨

すべての金額値は、組織の請求通貨の最小単位（USDの場合はセント）の文字列です。たとえば、"50000"は500.00 USDを表します。ドルで表示するには、10進数として解析し100で割ってください。大きな値には2進浮動小数点の使用を避けてください。

amountはnull許容です。メンバーの有効な行では、nullは無制限（支出上限なし）を意味し、"0"はメンバーがプランに含まれる使用量を超えてClaudeを使用できないことを意味します。設定済みの支出上限行（GET /v1/organizations/spend_limits/{id}で返されるもの）では、nullは数値の支出上限が設定されていないことのみを意味します。無制限なのか、含まれる使用量のみなのかを区別するには、メンバーの有効な行を読み取ってください。

period_to_date_spendは、現在のperiodの開始以降に発生したメンバーの支出で、同じ最小単位形式です。小数部分を含む場合があります（例："41280.125"）。支出の読み取りが一時的に利用できない場合は"0"と表示されることがあります。トランザクション的なものではなく、情報提供として扱ってください。



引き上げリクエストのライフサイクル

支出上限引き上げリクエストは、メンバーがclaude.aiでRequest more usageをクリックしたときに作成されます。リクエストはこのAPIを通じて作成されません。リクエストのstatusは次のいずれかです。

approvedとdeniedはどちらも終了状態です。メンバーは一度に最大1つのpendingリクエストを持ちます。

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

デフォルトでは、Anthropicはリクエストが承認または却下されたときにメンバーにメールを送信します。承認または却下時にsuppress_notification: trueを渡すと、そのメールを抑制できます（たとえば、独自のシステムがメンバーに通知する場合）。



レート制限

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[]、period[]、status[]、またはactor_ids[]を変更して古いカーソルを渡すと、*"cursor does not match current query parameters"*というメッセージとともに400が返されます。代わりに最初のページから新しいシーケンスを開始してください。



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

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

user_ids[]=user_01AbCdEfGh&user_ids[]=user_01JkLmNoPq



エラーレスポンス

エラーレスポンスは、エラーに記載されている標準形式に従います。サポートに連絡する際は、レスポンスボディのrequest_idを引用してください。



支出上限



各メンバーの有効な支出上限を一覧表示する

GET /v1/organizations/spend_limits/effectiveは、現在のメンバーごとに1行を返し、各メンバーの有効な支出上限、スコープ階層内のsource、およびperiod_to_date_spendを反映します。read:spend_limitsスコープが必要です。

完全なパラメータの詳細とレスポンススキーマについては、APIリファレンスの有効な支出上限の一覧表示を参照してください。

curl "https://api.anthropic.com/v1/organizations/spend_limits/effective?limit=20" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "data": [
    {
      "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
      "actor": {
        "type": "user_actor",
        "user_id": "user_01AbCdEfGh",
        "name": "Jane Smith",
        "email_address": "[email protected]",
        "deleted": false
      },
      "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_..."
}



単一の支出上限を取得する

GET /v1/organizations/spend_limits/{spend_limit_id}は、IDで指定された1つの設定済み支出上限を返します。spend_limit_idフィールドが参照している行を調べるために使用します。read:spend_limitsスコープが必要です。

完全なパラメータの詳細とレスポンススキーマについては、APIリファレンスの支出上限の取得を参照してください。

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



ユーザー単位のオーバーライドを設定する

POST /v1/organizations/spend_limitsは、ユーザー単位の支出上限オーバーライドを設定します。これは(scope, period)をキーとするアップサートです。すでに上限が設定されているユーザーと期間に対して上限を設定すると、その場で上書きされます。このエンドポイントはscope.type: "user"のみを受け付けます。シートティア、グループ、組織レベルのデフォルトはclaude.aiの設定で構成します。write:spend_limitsスコープが必要です。

完全なパラメータの詳細とレスポンススキーマについては、APIリファレンスの支出上限の作成を参照してください。

curl --request POST "https://api.anthropic.com/v1/organizations/spend_limits" \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"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"
}



ユーザー単位のオーバーライドを削除する

DELETE /v1/organizations/spend_limits/{spend_limit_id}は、ユーザー単位のオーバーライドを削除します。削除後、メンバーは継承されたシートティア、グループ、または組織のデフォルトにフォールバックします。シートティア、グループ、組織レベルの行はこのエンドポイントでは削除できません。write:spend_limitsスコープが必要です。

完全なパラメータの詳細とレスポンススキーマについては、APIリファレンスの支出上限の削除を参照してください。

curl --request DELETE "https://api.anthropic.com/v1/organizations/spend_limits/spl_01RsTuVwXyZaBcDeFgHiJk" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"



支出上限引き上げリクエスト



引き上げリクエストを一覧表示する

GET /v1/organizations/spend_limit_increase_requestsは、リクエストを新しい順に一覧表示します。status[]（pending、approved、denied）およびactor_ids[]でフィルタリングできます。リクエスト送信者が組織のメンバーでなくなったリクエストは一覧から除外されます。read:spend_limitsスコープが必要です。

完全なパラメータの詳細とレスポンススキーマについては、APIリファレンスの支出上限引き上げリクエストの一覧表示を参照してください。

curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests?status[]=pending&limit=50" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

各保留中リクエストには、リクエスト送信者の現在の有効な支出上限と期間内の累計支出を示すライブのspend_summaryが含まれており、別途照会することなく判断するのに十分な情報が得られます。



単一の引き上げリクエストを取得する

GET /v1/organizations/spend_limit_increase_requests/{id}は、IDで指定された1つのリクエストを返します。read:spend_limitsスコープが必要です。

完全なパラメータの詳細とレスポンススキーマについては、APIリファレンスの支出上限引き上げリクエストの取得を参照してください。

curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"



引き上げリクエストを承認する

POST /v1/organizations/spend_limit_increase_requests/{id}/approveは、保留中のリクエストを承認します。管理者が指定したamountでリクエスト送信者にユーザー単位の支出上限を書き込み、リクエストをapprovedに遷移させます。リクエストにはリクエストされた金額は含まれていません。承認時に新しい支出上限を指定します。write:spend_limitsスコープが必要です。

完全なパラメータの詳細とレスポンススキーマについては、APIリファレンスの支出上限引き上げリクエストの承認を参照してください。

curl --request POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/approve" \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"amount": "75000", "suppress_notification": true}'



引き上げリクエストを却下する

POST /v1/organizations/spend_limit_increase_requests/{id}/denyは、保留中のリクエストを却下します。deniedに対して冪等です。すでに却下されたリクエストを却下すると、既存のリソースとともに200が返されます。このエンドポイントは、すでに承認されたリクエストを却下しようとする試みを拒否するため、自動化処理はリトライと競合する決定を区別できます。write:spend_limitsスコープが必要です。

完全なパラメータの詳細とレスポンススキーマについては、APIリファレンスの支出上限引き上げリクエストの却下を参照してください。

curl --request POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/deny" \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"suppress_notification": true}'



よくある質問



支出上限を直接設定すると、メンバーの保留中の引き上げリクエストは解決されますか？

いいえ。POST /v1/organizations/spend_limitsはオーバーライドを書き込みますが、保留中のリクエストはそのまま残ります。リクエストを解決し、オーバーライドを1回の呼び出しで書き込むには、POST /v1/organizations/spend_limit_increase_requests/{id}/approveを使用してください。



ユーザー単位のオーバーライドを削除するとどうなりますか？

メンバーは階層から継承するもの（グループ、シートティア、または組織のデフォルト）にフォールバックします。どのレベルにもデフォルトが存在しない場合、メンバーは無制限になります。



このAPIを通じてシートティアまたは組織全体のデフォルトを設定できますか？

いいえ。このAPIを通じて書き込めるのはユーザー単位のオーバーライドのみです。シートティア、グループ、組織レベルのデフォルトはclaude.aiの組織設定で構成します。



アクティブなメンバーのperiod_to_date_spendが"0"と表示されることがあるのはなぜですか？

支出の読み取りが一時的に利用できない場合があり、その場合フィールドはエラーにならず"0"と表示されます。情報提供として扱ってください。



関連情報