Claude Platform Docs

Listar límites de gasto

beta.organization.spend_limits.list(**kwargs) -> PageCursor<BetaSpendLimit>
GET/v1/organizations/spend_limits

Lista los límites de gasto de la organización.

Los límites se agrupan por tipo de ámbito, en el orden organization, seat_tier, rbac_group, organization_service, user; dentro de un tipo se devuelven en un orden fijo que no es el orden de creación. Compatible solo con organizaciones de Claude Enterprise, no con organizaciones de Claude Console.

Parameters
limit: Integer⁠Query parameter

Maximum number of limits per page. Defaults to 20.

minimum1
maximum1000
page: String⁠Query parameter

Opaque cursor from a previous response's next_page field.

scope_type: Array[:organization | :organization_service | :rbac_group | 3 more]⁠Query parameter

Return only limits with these scope types. Omit for all.

maxItems100
One of the following:
:organization
:organization_service
:rbac_group
:seat_tier
:user
:workspace
betas: Array[AnthropicBeta]⁠Header parameter

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

One of the following:
String = String
:"message-batches-2024-09-24"
:"prompt-caching-2024-07-31"
:"computer-use-2024-10-22"
:"computer-use-2025-01-24"
:"pdfs-2024-09-25"
:"token-counting-2024-11-01"
:"token-efficient-tools-2025-02-19"
:"output-128k-2025-02-19"
:"files-api-2025-04-14"
:"mcp-client-2025-04-04"
:"mcp-client-2025-11-20"
:"dev-full-thinking-2025-05-14"
:"interleaved-thinking-2025-05-14"
:"code-execution-2025-05-22"
:"extended-cache-ttl-2025-04-11"
:"context-1m-2025-08-07"
:"context-management-2025-06-27"
:"model-context-window-exceeded-2025-08-26"
:"skills-2025-10-02"
:"fast-mode-2026-02-01"
:"output-300k-2026-03-24"
:"user-profiles-2026-03-24"
:"user-profiles-2026-08-18"
:"user-profiles-2026-09-04"
:"advisor-tool-2026-03-01"
:"managed-agents-2026-04-01"
:"cache-diagnosis-2026-04-07"
:"dreaming-2026-04-21"
:"thinking-token-count-2026-05-13"
:"server-side-fallback-2026-06-01"
:"server-side-fallback-2026-07-01"
:"fallback-credit-2026-06-01"
:"fallback-credit-2026-07-01"
:"agent-memory-2026-07-22"
:"mid-conversation-tool-changes-2026-07-01"
:"compact-2026-01-12"
:"computer-use-2025-11-24"
:"mcp-tunnels-2026-06-22"
:"structured-outputs-2025-11-13"
:"task-budgets-2026-03-13"
:"thinking-display-updates-2026-08-18"
:"ce-user-management-2026-07-13"
:"mid-conversation-output-config-2026-07-01"
:"thinking-binding-controls-2026-08-01"
:"mid-conversation-system-clear-at-2026-08-21"
:"compact-2026-09-04"
:"inline-tools-2026-09-15"
:"mcp-client-2026-09-15"
:"ce-plugins-2026-09-01"
:"spend-limit-reads-2026-09-26"
:"telemetry-destinations-2026-08-11"
Returns
class BetaSpendLimit { type: :spend_limit, id, amount, 6 more }

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

Listar límites de gasto
require "anthropic"

anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key")

page = anthropic.beta.organization.spend_limits.list

puts(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_01WCz1FkmYMm4gnmykNKUu3Q"
      },
      "type": "spend_limit",
      "updated_at": "2019-12-27T18:11:19.117Z"
    }
  ],
  "next_page": "next_page"
}