지출 한도 목록 조회

$client->beta->organization->spendLimits->list(?int limit, ?string page, ?list<ScopeType> scopeType, ?string workspaceID, ?list<AnthropicBeta> betas): PageCursor<SpendLimit>

GET/v1/organizations/spend_limits

Requires anthropic-beta: spend-limit-reads-2026-09-26. How to send beta headers

조직의 지출 한도를 나열합니다.

Claude Console 조직의 한도는 읽기 전용 usage_tier 한도를 포함하여 최신순으로 반환됩니다. 이 한도를 나열하는 기능은 얼리 액세스 프리뷰 단계입니다. 액세스를 요청하려면 Anthropic 계정 팀에 문의하세요. Claude Enterprise 조직의 한도는 범위 유형별로 organization, seat_tier, rbac_group, organization_service, user 순서로 그룹화되며, 각 유형 내에서는 생성 순서가 아닌 고정된 순서로 반환됩니다.

Parameters

limit?: optional int⁠Query

Maximum number of limits per page. Defaults to 20.

default20

page?: optional string⁠Query

Opaque cursor from a previous response's next_page field.

scopeType?: optional list<ScopeType>⁠Query

Return only limits with these scope types. Omit for all. A scope type that doesn't apply to the organization gets a 400 error.

workspaceID?: optional string⁠Query

Return only the limits whose scope.workspace_id is this workspace (wrkspc_...). Claude Console organizations only; other organizations get a 400 error.

betas?: optional list<AnthropicBeta>⁠Header

This endpoint is in beta: requests must send spend-limit-reads-2026-09-26 in this header.

Returns

class SpendLimit { $type = 'spend_limit'; $id; $amount; /* 6 more */ }

"spend_limit" type

Object type. Always spend_limit.

string id

Unique tagged ID of the spend limit (spl_...).

?string amount

Limit amount as a non-negative integer decimal string in the minor unit of currency (cents for USD): "50000" is $500.00. null means no numeric cap is configured at this scope — see the effective report for whether a limit applies.

\Datetime createdAt

RFC 3339 datetime at which the spend limit was created.

string currency

ISO 4217 code of the organization's billing currency; the unit for amount.

bool isEnabled

Read-only. false when extra usage is switched off for this organization (organization limit); amount is kept and applies again when it's switched back on. Always true for other limits.

SpendLimitPeriod period

Length of the window the limit resets over. amount caps spend within each period.

Scope scope

What the limit applies to. A tagged union on type; each variant carries the identifier for its scope.

\Datetime updatedAt

RFC 3339 datetime at which the spend limit was last modified.

지출 한도 목록 조회

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Anthropic\Client;
use Anthropic\Beta\AnthropicBeta;

$client = new Client(apiKey: 'my-anthropic-api-key');

$page = $client->beta->organization->spendLimits->list(
  limit: 1,
  page: 'page',
  scopeType: ['organization'],
  workspaceID: 'workspace_id',
  betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24],
);

var_dump($page);

Response 200

{
  "data": [
    {
      "id": "id",
      "amount": "50000",
      "created_at": "2019-12-27T18:11:19.117Z",
      "currency": "USD",
      "is_enabled": true,
      "period": "daily",
      "scope": {
        "type": "user",
        "user_id": "user_01WxYzAbCdEfGhJkMnPqRsTu"
      },
      "type": "spend_limit",
      "updated_at": "2019-12-27T18:11:19.117Z"
    }
  ],
  "next_page": "next_page"
}

Returns Examples

Response 200

{
  "data": [
    {
      "id": "id",
      "amount": "50000",
      "created_at": "2019-12-27T18:11:19.117Z",
      "currency": "USD",
      "is_enabled": true,
      "period": "daily",
      "scope": {
        "type": "user",
        "user_id": "user_01WxYzAbCdEfGhJkMnPqRsTu"
      },
      "type": "spend_limit",
      "updated_at": "2019-12-27T18:11:19.117Z"
    }
  ],
  "next_page": "next_page"
}