列出支出限额

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