# Increase Requests ## List Spend Limit Increase Requests ### Query Parameters ### Returns ### Example #### Response ## Get Spend Limit Increase Request ### Path Parameters ### Returns ### Example #### Response ## Approve Spend Limit Increase Request ### Path Parameters ### Body Parameters ### Returns ### Example #### Response ## Deny Spend Limit Increase Request ### Path Parameters ### Body Parameters ### Returns ### Example #### Response ## Domain Types ### Spend Limit Increase Request ### Increase Request Approve Response
The whole hunk
1539 lines, first recorded
/
lines
The first capture of this source. The page was already there, and this is what it said.
---
title: Increase Requests
url: https://platform.claude.com/docs/en/api/admin/spend_limits/increase_requests
---
# Increase Requests
## 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`
- `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.
- `"approved"`
- `"denied"`
- `"pending"`
### Returns
- `data: array of SpendLimitIncreaseRequest`
- `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`
- `email_address: string or null`
- `name: string or null`
- `type: "user_actor"`
- `"user_actor"`
- `user_id: string`
- `created_at: string`
- `period: "daily" or "monthly" or "weekly"`
- `"daily"`
- `"monthly"`
- `"weekly"`
- `resolved_at: string or null`
- `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.
- `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`
- `email_address: string or null`
- `name: string or null`
- `type: "user_actor"`
- `"user_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"`
- `"scoped_api_key_actor"`
- `spend_summary: SpendSummary or null`
Per-member effective-limit report row (GET /spend_limits/effective).
- `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`
- `email_address: string or null`
- `name: string or null`
- `type: "user_actor"`
- `"user_actor"`
- `user_id: string`
- `amount: string or null`
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`
ISO 4217 code of the organization's billing currency; the unit for `amount` and `period_to_date_spend`.
- `period: "daily" or "monthly" or "weekly"`
- `"daily"`
- `"monthly"`
- `"weekly"`
- `period_to_date_spend: string`
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: object { type, user_id }`
- `type: "user"`
- `"user"`
- `user_id: string`
- `source: object { type, user_id } or object { seat_tier, type } or object { rbac_group_id, type } or 2 more`
- `User object { type, user_id }`
- `type: "user"`
- `"user"`
- `user_id: string`
- `SeatTier object { seat_tier, type }`
- `seat_tier: string`
- `type: "seat_tier"`
- `"seat_tier"`
- `RbacGroup object { rbac_group_id, type }`
- `rbac_group_id: string`
- `type: "rbac_group"`
- `"rbac_group"`
- `OrganizationService object { service, type }`
- `service: string`
- `type: "organization_service"`
- `"organization_service"`
- `Organization object { type }`
- `type: "organization"`
- `"organization"`
- `spend_limit_id: string`
- `status: "approved" or "denied" or "pending"`
- `"approved"`
- `"denied"`
- `"pending"`
- `type: "spend_limit_increase_request"`
- `"spend_limit_increase_request"`
- `next_page: string or null`
### Example
```http
curl https://api.anthropic.com/v1/organizations/spend_limit_increase_requests \
-H 'anthropic-version: 2023-06-01' \
-H "Authorization: Bearer $ANTHROPIC_OAUTH_TOKEN"
```
#### Response
```json
{
"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"
}
```
## Get Spend Limit Increase Request
**get** `/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}`
Retrieve a spend limit increase request.
While `pending`, the response includes a live `spend_summary` for the
requester at the request's period.
### Path Parameters
- `spend_limit_increase_request_id: string`
ID of the spend limit increase request.
### Returns
- `SpendLimitIncreaseRequest object { 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
Cut at 300 lines. The page has the rest.