Claude Platform Docs

유효 지출 한도 목록 조회

beta.organization.spend_limits.effective.list(**kwargs) -> SyncPageCursor[BetaSpendSummary]
GET/v1/organizations/spend_limits/effective

각 멤버의 유효 지출 한도와 기간 누적 지출액을 나열합니다.

멤버에게 지출 한도가 적용되는 (멤버, 기간) 조합마다 한 행을 반환하며, 지출 한도를 상속받은 source 범위를 함께 반환합니다. 멤버 단위로 페이지를 나누므로 한 멤버의 기간이 여러 페이지에 걸쳐 나뉘지 않습니다. Claude Console 한도 나열 기능은 얼리 액세스 프리뷰 단계입니다. 액세스를 요청하려면 Anthropic 계정 팀에 문의하세요.

Parameters
limit: Optional[int]⁠Query parameter

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.

default20
minimum1
maximum1000
page: Optional[str]⁠Query parameter

Opaque cursor from a previous response's next_page field.

period: Optional[List[Literal["daily", "monthly", "weekly"]]]⁠Query parameter

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

maxItems3
One of the following:
"daily"
"monthly"
"weekly"
user_ids: Optional[Sequence[str]]⁠Query parameter

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

maxItems100
Returns
class BetaSpendSummary: actor; amount; currency; ... # 5 more

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

유효 지출 한도 목록 조회
import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ.get(
        "ANTHROPIC_API_KEY"
    ),  # This is the default and can be omitted
)
page = client.beta.organization.spend_limits.effective.list()
page = page.data[0]
print(page.spend_limit_id)
Returns Examples
Response 200
{
  "data": [
    {
      "actor": {
        "deleted": true,
        "email_address": "email_address",
        "name": "name",
        "type": "user_actor",
        "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
      },
      "amount": "50000",
      "currency": "USD",
      "period": "daily",
      "period_to_date_spend": "12050.5",
      "scope": {
        "type": "user",
        "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
      },
      "source": {
        "type": "user",
        "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
      },
      "spend_limit_id": "spend_limit_id"
    }
  ],
  "next_page": "next_page"
}