List Effective Spend Limits

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.

get/v1/organizations/spend_limits/effective?beta=true

Query parameters

user_ids[]string[] nullable

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

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.

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.

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.

Opaque cursor from a previous response's next_page field.

Headers

x-api-keystring

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.

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.

anthropic-versionstring

The version of the Claude API you want to use.

Read more about versioning and our version history here.

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_01WCz1FkmYMm4gnmykNKUu3Q"
      },
      "amount": "50000",
      "currency": "USD",
      "period": "monthly",
      "period_to_date_spend": "12050.5",
      "scope": {
        "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
      },
      "source": {
        "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
      }
    }
  ]
}

Changes