ANanthropics

List Effective Spend Limits

Changed on

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. Supported for Claude Enterprise organizations only, not for Claude Console organizations.

get/v1/organizations/spend_limits/effective

Request

  • Base URL
    https://api.anthropic.com
  • Auth
    none declared

Query parameters

user_ids[]string[] nullable

Restrict the report to these members, by tagged user ID (user_...). At most 100 entries.

period[]SpendLimitPeriod[] nullable

Restrict the report to these limit periods. Omit to return one row per period each member resolves a spend limit for.

limitinteger

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.

pagestring nullable

Opaque cursor from a previous response's next_page field.

Headers

anthropic-versionstring

The version of the Claude API you want to use.

Read more about versioning and our version history here.

Response

Successful Response

next_pagestring nullable required

Example response

{
  "data": [
    {
      "actor": {
        "user_id": "user_01WxYzAbCdEfGhJkMnPqRsTu"
      },
      "amount": "50000",
      "currency": "USD",
      "period_to_date_spend": "12050.5",
      "scope": {
        "user_id": "user_01WxYzAbCdEfGhJkMnPqRsTu"
      },
      "source": {
        "user_id": "user_01WxYzAbCdEfGhJkMnPqRsTu"
      }
    }
  ]
}

Changes