Claude Platform Docs

List Spend Limit Increase Requests

GET/v1/organizations/spend_limit_increase_requests

List spend limit increase requests, most recent first.

Pending requests include a live spend_summary for the requester. Requests whose requester is no longer a member are excluded.

Query parameters
actor_ids: optional array of string

Filter by requester, as user_... tagged IDs.

limit: optional number
default20
maximum1000
minimum1
page: optional string

Opaque cursor from a previous response's next_page.

status: optional array of "approved" or "denied" or "pending"

Filter by status. Omit to return all.

One of the following:
"approved"
"denied"
"pending"
Returns
data: array of SpendLimitIncreaseRequest { id, actor, created_at, 6 more }
id: string
actor: object{ deleted, email_address, name, 2 more }

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
defaultfalse
email_address: string or null
name: string or null
type: "user_actor"
defaultuser_actor
user_id: string
created_at: string
formatdate-time
period: "daily" or "monthly" or "weekly"
One of the following:
"daily"
"monthly"
"weekly"
resolved_at: string or null
formatdate-time
resolved_by: object{ deleted, email_address, name, 2 more } or object{ scoped_api_key_id, type } or null

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.

One of the following:
UserActor object{ deleted, email_address, name, 2 more }

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
defaultfalse
email_address: string or null
name: string or null
type: "user_actor"
defaultuser_actor
user_id: string
ScopedAPIKeyActor object{ scoped_api_key_id, type }

A scoped Admin API key acting on behalf of the organization.

scoped_api_key_id: string
type: "scoped_api_key_actor"
defaultscoped_api_key_actor
spend_summary: SpendSummary { actor, amount, currency, 5 more } or null

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

status: "approved" or "denied" or "pending"
One of the following:
"approved"
"denied"
"pending"
type: "spend_limit_increase_request"
defaultspend_limit_increase_request
next_page: string or null

List Spend Limit Increase Requests

cURL
curl https://api.anthropic.com/v1/organizations/spend_limit_increase_requests \
    -H 'anthropic-version: 2023-06-01' \
    -H "Authorization: Bearer $ANTHROPIC_OAUTH_TOKEN"
{
  "data": [
    {
      "id": "id",
      "actor": {
        "deleted": true,
        "email_address": "email_address",
        "name": "name",
        "type": "user_actor",
        "user_id": "user_id"
      },
      "created_at": "2019-12-27T18:11:19.117Z",
      "period": "monthly",
      "resolved_at": "2019-12-27T18:11:19.117Z",
      "resolved_by": {
        "deleted": true,
        "email_address": "email_address",
        "name": "name",
        "type": "user_actor",
        "user_id": "user_id"
      },
      "spend_summary": {
        "actor": {
          "deleted": true,
          "email_address": "email_address",
          "name": "name",
          "type": "user_actor",
          "user_id": "user_id"
        },
        "amount": "50000",
        "currency": "USD",
        "period": "monthly",
        "period_to_date_spend": "12050.5",
        "scope": {
          "type": "user",
          "user_id": "user_id"
        },
        "source": {
          "type": "user",
          "user_id": "user_id"
        },
        "spend_limit_id": "spend_limit_id"
      },
      "status": "approved",
      "type": "spend_limit_increase_request"
    }
  ],
  "next_page": "next_page"
}
Returns Examples
{
  "data": [
    {
      "id": "id",
      "actor": {
        "deleted": true,
        "email_address": "email_address",
        "name": "name",
        "type": "user_actor",
        "user_id": "user_id"
      },
      "created_at": "2019-12-27T18:11:19.117Z",
      "period": "monthly",
      "resolved_at": "2019-12-27T18:11:19.117Z",
      "resolved_by": {
        "deleted": true,
        "email_address": "email_address",
        "name": "name",
        "type": "user_actor",
        "user_id": "user_id"
      },
      "spend_summary": {
        "actor": {
          "deleted": true,
          "email_address": "email_address",
          "name": "name",
          "type": "user_actor",
          "user_id": "user_id"
        },
        "amount": "50000",
        "currency": "USD",
        "period": "monthly",
        "period_to_date_spend": "12050.5",
        "scope": {
          "type": "user",
          "user_id": "user_id"
        },
        "source": {
          "type": "user",
          "user_id": "user_id"
        },
        "spend_limit_id": "spend_limit_id"
      },
      "status": "approved",
      "type": "spend_limit_increase_request"
    }
  ],
  "next_page": "next_page"
}