# Spend Limits ## Set Spend Limit ### Body Parameters ### Returns ### Example #### Response ## Get Spend Limit ### Path Parameters ### Returns ### Example #### Response ## Delete Spend Limit ### Path Parameters ### Returns ### Example #### Response ## List Effective Spend Limits ### Query Parameters ### Returns ### Example #### Response ## Domain Types ### Spend Limit ### Spend Summary ### Spend Limit Delete Response # 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
2158 lines, first recordedThe first capture of this source. The page was already there, and this is what it said.
---
title: Spend Limits
url: https://platform.claude.com/docs/en/api/admin/spend_limits
---
# Spend Limits
## Set Spend Limit
**post** `/v1/organizations/spend_limits`
Set a per-user spend limit override.
Upsert keyed on (scope, period): setting a limit that already exists
overwrites it in place. Only `scope.type: "user"` is accepted; seat-tier,
group, and organization-level defaults are configured in claude.ai.
### Body Parameters
- `amount: string or null`
Limit amount as a non-negative integer decimal string in the minor unit of the organization's billing currency (cents for USD): "50000" is $500.00. `null` sets an explicit no-limit override for this scope and `period` only — each period resolves independently, so caps for other periods still apply.
- `scope: object { type, user_id }`
- `type: "user"`
- `"user"`
- `user_id: string`
- `period: optional "daily" or "monthly" or "weekly"`
- `"daily"`
- `"monthly"`
- `"weekly"`
### Returns
- `SpendLimit object { id, amount, created_at, 5 more }`
- `id: string`
- `amount: string or null`
Limit amount as a non-negative integer decimal string in the minor unit of `currency` (cents for USD): "50000" is $500.00. `null` means no numeric cap is configured at this scope — see the effective report for whether a limit applies.
- `created_at: string`
- `currency: string`
ISO 4217 code of the organization's billing currency; the unit for `amount`.
- `period: "daily" or "monthly" or "weekly"`
- `"daily"`
- `"monthly"`
- `"weekly"`
- `scope: 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"`
- `type: "spend_limit"`
- `"spend_limit"`
- `updated_at: string`
### Example
```http
curl https://api.anthropic.com/v1/organizations/spend_limits \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2023-06-01' \
-H "Authorization: Bearer $ANTHROPIC_OAUTH_TOKEN" \
-d '{
"amount": "50000",
"scope": {
"type": "user",
"user_id": "user_id"
},
"period": "monthly"
}'
```
#### Response
```json
{
"id": "id",
"amount": "50000",
"created_at": "2019-12-27T18:11:19.117Z",
"currency": "USD",
"period": "monthly",
"scope": {
"type": "user",
"user_id": "user_id"
},
"type": "spend_limit",
"updated_at": "2019-12-27T18:11:19.117Z"
}
```
## Get Spend Limit
**get** `/v1/organizations/spend_limits/{spend_limit_id}`
Retrieve a spend limit by ID.
### Path Parameters
- `spend_limit_id: string`
ID of the Spend Limit.
### Returns
- `SpendLimit object { id, amount, created_at, 5 more }`
- `id: string`
- `amount: string or null`
Limit amount as a non-negative integer decimal string in the minor unit of `currency` (cents for USD): "50000" is $500.00. `null` means no numeric cap is configured at this scope — see the effective report for whether a limit applies.
- `created_at: string`
- `currency: string`
ISO 4217 code of the organization's billing currency; the unit for `amount`.
- `period: "daily" or "monthly" or "weekly"`
- `"daily"`
- `"monthly"`
- `"weekly"`
- `scope: 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"`
- `type: "spend_limit"`
- `"spend_limit"`
- `updated_at: string`
### Example
```http
curl https://api.anthropic.com/v1/organizations/spend_limits/$SPEND_LIMIT_ID \
-H 'anthropic-version: 2023-06-01' \
-H "Authorization: Bearer $ANTHROPIC_OAUTH_TOKEN"
```
#### Response
```json
{
"id": "id",
"amount": "50000",
"created_at": "2019-12-27T18:11:19.117Z",
"currency": "USD",
"period": "monthly",
"scope": {
"type": "user",
"user_id": "user_id"
},
"type": "spend_limit",
"updated_at": "2019-12-27T18:11:19.117Z"
}
```
## Delete Spend Limit
**delete** `/v1/organizations/spend_limits/{spend_limit_id}`
Delete a per-user spend limit override.
The member falls back to any inherited spend limit at that period.
Seat-tier, group, and organization-level rows cannot be deleted via
this endpoint.
### Path Parameters
- `spend_limit_id: string`
ID of the Spend Limit.
### Returns
- `id: string`
- `type: "spend_limit_deleted"`
- `"spend_limit_deleted"`
### Example
```http
curl https://api.anthropic.com/v1/organizations/spend_limits/$SPEND_LIMIT_ID \
-X DELETE \
-H 'anthropic-version: 2023-06-01' \
-H "Authorization: Bearer $ANTHROPIC_OAUTH_TOKEN"
```
#### Response
```json
{
"id": "id",
"type": "spend_limit_deleted"
}
```
## List Effective Spend Limits
**get** `/v1/organizations/spend_limits/effective`
List each member's effective spend limit and period-to-date spend.
Cut at 300 lines. The page has the rest.