Claude Platform Docs

Spend Limits

Set Spend Limit
client.beta.organization.spendLimits.set(params, options?): BetaSpendLimit
POST/v1/organizations/spend_limits

Set a spend limit.

Get Spend Limit
client.beta.organization.spendLimits.retrieve(spendLimitID, options?): BetaSpendLimit
GET/v1/organizations/spend_limits/{spend_limit_id}

Retrieve a spend limit by ID.

Delete Spend Limit
client.beta.organization.spendLimits.delete(spendLimitID, options?): SpendLimitDeleteResponse
DELETE/v1/organizations/spend_limits/{spend_limit_id}

Delete a spend limit.

List Spend Limits
client.beta.organization.spendLimits.list(params?, options?): PageCursor<BetaSpendLimit>
GET/v1/organizations/spend_limits
Requires anthropic-beta: spend-limit-reads-2026-09-26. Learn how to send beta headers.

List the organization's spend limits.

Models
interface BetaSpendLimit { type: "spend_limit"; id; amount; /* 6 more */ }

A configured spend limit: a cap on metered spend for one scope and period.

interface BetaSpendLimitOrganizationScope { type: "organization" }
type: "organization"
defaultorganization
interface BetaSpendLimitOrganizationServiceScope { type: "organization_service"; service }
type: "organization_service"
defaultorganization_service
service: string
type BetaSpendLimitPeriod = "daily" | "monthly" | "weekly"
One of the following:
"daily"
"monthly"
"weekly"
interface BetaSpendLimitRBACGroupScope { type: "rbac_group"; rbac_group_id }
type: "rbac_group"
defaultrbac_group
rbac_group_id: string
interface BetaSpendLimitScopedAPIKeyActor { type: "scoped_api_key_actor"; scoped_api_key_id }

A scoped Admin API key acting on behalf of the organization.

type: "scoped_api_key_actor"
defaultscoped_api_key_actor
scoped_api_key_id: string
interface BetaSpendLimitSeatTierScope { type: "seat_tier"; seat_tier }
type: "seat_tier"
defaultseat_tier
seat_tier: string
interface BetaSpendLimitUsageTierScope { type: "usage_tier" }

Scope of the monthly spend cap Anthropic sets for a Claude Console organization from its usage tier, or a higher cap Anthropic granted the organization. Read-only; its created_at and updated_at are the organization's creation time, so amount can change while updated_at stays the same.

type: "usage_tier"

Scope type. Always usage_tier for this scope.

defaultusage_tier
interface BetaSpendLimitUserActor { type: "user_actor"; deleted; email_address; /* 2 more */ }

A user within the organization. name and email_address are null when the underlying account is unavailable or has been deleted; deleted is true only for deleted accounts.

type: "user_actor"

Actor type. Always user_actor.

defaultuser_actor
deleted: boolean

True only when the underlying account has been deleted.

defaultfalse
email_address: string | null

The user's email address. Null when the account is unavailable or has been deleted.

name: string | null

The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.

user_id: string

Tagged ID of the user.

interface BetaSpendLimitUserScope { type: "user"; user_id }

Scope selecting a single member of the organization.

type: "user"

Scope type. Always user for this scope.

defaultuser
user_id: string

Tagged ID of the member the spend limit applies to.

interface BetaSpendLimitWorkspaceScope { type: "workspace"; workspace_id }

Scope selecting one workspace of a Claude Console organization.

type: "workspace"

Scope type. Always workspace for this scope.

defaultworkspace
workspace_id: string

Tagged ID of the workspace the spend limit applies to.

interface BetaSpendLimitsAdminAPIWritesNotEnabledErrorDetails { error_code }
error_code: "spend_limits_admin_api_writes_not_enabled"
interface BetaSpendSummary { actor; amount; currency; /* 5 more */ }

Per-member effective-limit report row (GET /spend_limits/effective).

interface SpendLimitDeleteResponse { type: "spend_limit_deleted"; id }
type: "spend_limit_deleted"
defaultspend_limit_deleted
id: string
Errors
class BetaSpendLimitsAdminAPIWritesNotEnabledError extends PermissionDeniedError { errorCode; details }⁠HTTP status 403

The organization cannot retrieve, set or delete spend limits with an Admin API credential.

errorCode: "spend_limits_admin_api_writes_not_enabled"
error_code: "spend_limits_admin_api_writes_not_enabled"

Spend LimitsEffective

List Effective Spend Limits
client.beta.organization.spendLimits.effective.list(query?, options?): PageCursor<BetaSpendSummary>
GET/v1/organizations/spend_limits/effective

List each member's effective spend limit and period-to-date spend.

Spend LimitsIncrease Requests

List Spend Limit Increase Requests
client.beta.organization.spendLimits.increaseRequests.list(query?, options?): PageCursor<BetaSpendLimitIncreaseRequest>
GET/v1/organizations/spend_limit_increase_requests

List spend limit increase requests, most recent first.

Get Spend Limit Increase Request
client.beta.organization.spendLimits.increaseRequests.retrieve(spendLimitIncreaseRequestID, options?): BetaSpendLimitIncreaseRequest
GET/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}

Retrieve a spend limit increase request.

Approve Spend Limit Increase Request
client.beta.organization.spendLimits.increaseRequests.approve(spendLimitIncreaseRequestID, body, options?): IncreaseRequestApproveResponse
POST/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/approve

Approve a pending spend limit increase request.

Deny Spend Limit Increase Request
client.beta.organization.spendLimits.increaseRequests.deny(spendLimitIncreaseRequestID, body, options?): BetaSpendLimitIncreaseRequest
POST/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/deny

Deny a pending spend limit increase request.