---
title: "List Effective Spend Limits"
method: GET
path: "/v1/organizations/spend_limits/effective?beta=true"
---

# List Effective Spend Limits

`GET /v1/organizations/spend_limits/effective?beta=true`

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

Returns one row per (member, period) the member resolves a spend limit
for, with the `source` scope the spend limit was inherited from.
Paginates by member, so a member's periods never split across pages.

## Query parameters

- `user_ids[]` string[], nullable — Restrict the report to these members, by tagged user ID (`user_...`). At most 100 entries.
- `period[]` string[], nullable — Restrict the report to these limit periods. Omit to return one row per period each member resolves a spend limit for.
- `limit` integer — Maximum number of members per page. A member's period rows never split across pages, so a page may carry more rows than this. Defaults to `20`.
- `page` string, nullable — Opaque cursor from a previous response's `next_page` field.

## Headers

- `x-api-key` string — Your unique Admin API key for authentication. This key is required in the header of all Admin API requests, to authenticate your account and access Anthropic's services. Get your Admin API key through the [Console](https://console.anthropic.com/settings/admin-keys).
- `anthropic-version` string — The version of the Claude API you want to use. Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).

## Response `200`

Successful Response

- BetaListEffectiveSpendLimitsResponse
  - `data` BetaSpendSummary[], required
    - `actor` BetaUserActorSchema, required — 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.
      - `deleted` boolean, required — True only when the underlying account has been deleted.
      - `email_address` string, nullable, required — The user's email address. Null when the account is unavailable or has been deleted.
      - `name` string, nullable, required — The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.
      - `type` 'user_actor', required — Actor type. Always `user_actor`.
      - `user_id` string, required — Tagged ID of the user.
    - `amount` string, nullable, required — Effective limit amount as a non-negative integer decimal string in the minor unit of `currency` (cents for USD). `null` means no limit applies for this row's `period` — each period resolves independently, so another period may still cap this member.
    - `currency` string, required — ISO 4217 code of the organization's billing currency; the unit for `amount` and `period_to_date_spend`.
    - `period` 'daily' | 'monthly' | 'weekly', required — Period this row's effective limit and spend are reported for.
    - `period_to_date_spend` string, required — The member's spend so far in the current period, as a non-negative decimal string in the minor unit of `currency` (cents for USD). May carry fractional minor units up to three decimal places (e.g. `"12050.5"`) — metered usage is not rounded to whole cents. Reads as `"0"` when the spend reading is temporarily unavailable.
    - `scope` BetaUserScope, required — Scope selecting a single member of the organization.
      - `type` 'user', required — Scope type. Always `user` for this scope.
      - `user_id` string, required — Tagged ID of the member the spend limit applies to.
    - `source` union, required
      - BetaUserScope — Scope selecting a single member of the organization.
        - `type` 'user', required — Scope type. Always `user` for this scope.
        - `user_id` string, required — Tagged ID of the member the spend limit applies to.
      - BetaSeatTierScope
        - `seat_tier` string, required
        - `type` 'seat_tier', required
      - BetaRbacGroupScope
        - `rbac_group_id` string, required
        - `type` 'rbac_group', required
      - BetaOrgServiceScope
        - `service` string, required
        - `type` 'organization_service', required
      - BetaOrganizationScope
        - `type` 'organization', required
    - `spend_limit_id` string, required
  - `next_page` string, nullable, required

## Other responses

- `400` — Invalid argument - The client specified an invalid argument
- `401` — Unauthenticated - The request does not have valid authentication credentials
- `403` — Permission denied - The caller does not have permission to execute the specified operation
- `404` — Not found - Some requested entity was not found
- `408` — Deadline exceeded - The deadline expired before the operation could complete
- `409` — Aborted - The operation was aborted due to concurrency issue
- `412` — Failed precondition - Operation was rejected because the system is not in required state
- `413` — Out of range - Operation was attempted past the valid range
- `429` — Resource exhausted - Some resource has been exhausted (rate limiting)
- `431` — Request header fields too large - Request metadata was too large
- `499` — Cancelled - The operation was cancelled by the client
- `500` — Internal - Internal server error
- `501` — Unimplemented - The operation is not implemented or supported
- `503` — Unavailable - The service is currently unavailable
- `504` — Deadline exceeded - Upstream service did not respond in time
- `529` — Overloaded - The service is temporarily overloaded

## Changes

- **2026-09-02** `1bb7c7a0a4a9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/anthropics/apis/anthropic-api/changes/v1/organizations/spend_limits/effective?beta=true/get.md)

---

[API](https://skmtc.dev/anthropics/apis/anthropic-api.md) · [All operations](https://skmtc.dev/anthropics/apis/anthropic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/anthropics/apis/anthropic-api/revisions/1bb7c7a0a4a9?raw)