Claude Platform Docs

Список лимитов расходов

$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 parameter

Maximum number of limits per page. Defaults to 20.

default20
page?: optional string⁠Query parameter

Opaque cursor from a previous response's next_page field.

scopeType?: optional list<ScopeType>⁠Query parameter

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 parameter

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 parameter

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