## Versioning
The whole hunk
from line 11, old and new numbered
/
lines
from line 11
1111<Check>
1212 **Scoped Admin API key required**
1313
14 These endpoints require an Admin API key with the `read:spend_limits` scope (for `GET` endpoints) or the `write:spend_limits` scope (for `POST` and `DELETE` endpoints). See [Create an Admin API key](https://platform.claude.com/docs/en/manage-claude/admin-api-keys#create-a-key-for-a-claude-enterprise-organization) for where your primary owner creates one and which scopes to select. Pass the key in the `x-api-key` header on every request.
14 These endpoints require an Admin API key with the `read:spend_limits` scope (for `GET` endpoints) or the `write:spend_limits` scope (for `POST` and `DELETE` endpoints). See [Create an Admin API key](https://platform.claude.com/docs/en/manage-claude/admin-api-keys#create-a-key-for-a-claude-enterprise-organization) for where your primary owner creates one and which scopes to select. Pass the key in the `x-api-key` header on every request, together with the [`anthropic-version`](https://platform.claude.com/docs/en/api/versioning) header.
1515</Check>
1616
1717<Note>
from line 40
4040
4141```bash cURL
4242curl "https://api.anthropic.com/v1/organizations/spend_limits/effective?limit=20" \
43 --header "x-api-key: $ANTHROPIC_ADMIN_KEY"
43 --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
44 --header "anthropic-version: 2023-06-01"
4445```
4546
4647## Key concepts
from line 82
8182
8283By default, Anthropic emails the member when their request is approved or denied. Pass `suppress_notification: true` on approve or deny to suppress that email (for example, when your own system notifies the member).
8384
85## Versioning
86
87Send the `anthropic-version` header on every request; see [API versions](https://platform.claude.com/docs/en/api/versioning) for the available versions.
88
8489## Rate limiting
8590
8691All eight endpoints share a single per-organization limit of **60 requests per minute**. Requests over the limit return **429 Too Many Requests**.
from line 118
113118
114119```bash cURL
115120curl "https://api.anthropic.com/v1/organizations/spend_limits/effective?limit=20" \
116 --header "x-api-key: $ANTHROPIC_ADMIN_KEY"
121 --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
122 --header "anthropic-version: 2023-06-01"
117123```
118124
119125```json
from line 154
148154
149155```bash cURL
150156curl "https://api.anthropic.com/v1/organizations/spend_limits/spl_01AbCdEfGhIjKlMnOpQrSt" \
151 --header "x-api-key: $ANTHROPIC_ADMIN_KEY"
157 --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
158 --header "anthropic-version: 2023-06-01"
152159```
153160
154161### Set a per-user override
from line 168
161168curl --request POST "https://api.anthropic.com/v1/organizations/spend_limits" \
162169 --header "content-type: application/json" \
163170 --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
171 --header "anthropic-version: 2023-06-01" \
164172 --data '{"scope": {"type": "user", "user_id": "user_01AbCdEfGh"}, "amount": "75000"}'
165173```
166174
from line 193
185193
186194```bash cURL
187195curl --request DELETE "https://api.anthropic.com/v1/organizations/spend_limits/spl_01RsTuVwXyZaBcDeFgHiJk" \
188 --header "x-api-key: $ANTHROPIC_ADMIN_KEY"
196 --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
197 --header "anthropic-version: 2023-06-01"
189198```
190199
191200## Spend limit increase requests
from line 207
198207
199208```bash cURL
200209curl --globoff "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests?status[]=pending&limit=50" \
201 --header "x-api-key: $ANTHROPIC_ADMIN_KEY"
210 --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
211 --header "anthropic-version: 2023-06-01"
202212```
203213
204214Each pending request carries a live `spend_summary` showing the requester's current effective spend limit and period-to-date spend, enough to decide without a separate lookup.
from line 221
211221
212222```bash cURL
213223curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt" \
214 --header "x-api-key: $ANTHROPIC_ADMIN_KEY"
224 --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
225 --header "anthropic-version: 2023-06-01"
215226```
216227
217228### Approve an increase request
from line 235
224235curl --request POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/approve" \
225236 --header "content-type: application/json" \
226237 --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
238 --header "anthropic-version: 2023-06-01" \
227239 --data '{"amount": "75000", "suppress_notification": true}'
228240```
229241
from line 249
237249curl --request POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/deny" \
238250 --header "content-type: application/json" \
239251 --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
252 --header "anthropic-version: 2023-06-01" \
240253 --data '{"suppress_notification": true}'
241254```
242255
from line 267
254267
255268 ```bash cURL
256269 curl --globoff "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests?status[]=pending&limit=100" \
257 --header "x-api-key: $ANTHROPIC_ADMIN_KEY"
270 --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
271 --header "anthropic-version: 2023-06-01"
258272 ```
259273
260274 Each request carries the requester's `actor.user_id` and a live `spend_summary` with their current effective `amount` and `period_to_date_spend`, enough to decide without a separate lookup.
from line 281
267281 curl --request POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/{id}/approve" \
268282 --header "content-type: application/json" \
269283 --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
284 --header "anthropic-version: 2023-06-01" \
270285 --data '{"amount": "75000", "suppress_notification": true}'
271286 ```
272287
from line 295
280295
281296 ```bash cURL
282297 curl "https://api.anthropic.com/v1/organizations/analytics/user_cost_report?starting_at=2026-06-01T00:00:00Z&limit=1000" \
283 --header "x-api-key: $ANALYTICS_API_KEY"
298 --header "x-api-key: $ANALYTICS_API_KEY" \
299 --header "anthropic-version: 2023-06-01"
284300 ```
285301
286302 Each row carries `actor.user_id`, `actor.email`, and `amount` (the member's spend in cents). Page through `next_page` to cover the whole organization.
from line 305
289305
290306 ```bash cURL
291307 curl --globoff "https://api.anthropic.com/v1/organizations/spend_limits/effective?user_ids[]=user_01Ab...&user_ids[]=user_01Cd...&limit=100" \
292 --header "x-api-key: $ANTHROPIC_ADMIN_KEY"
308 --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
309 --header "anthropic-version: 2023-06-01"
293310 ```
294311
295312 Each row returns the cap as `amount` (`null` = unlimited, `"0"` = included usage only) alongside `period_to_date_spend`.
from line 323
306323
307324 ```bash cURL
308325 curl "https://api.anthropic.com/v1/organizations/analytics/user_cost_report?starting_at=2026-06-09T00:00:00Z&ending_at=2026-06-23T00:00:00Z&bucket_width=1d&limit=1000" \
309 --header "x-api-key: $ANALYTICS_API_KEY"
326 --header "x-api-key: $ANALYTICS_API_KEY" \
327 --header "anthropic-version: 2023-06-01"
310328 ```
311329
312330 With `bucket_width` set, each member spans one row per day with usage; page through `next_page` to collect every member's full series.
from line 341
323341
324342 ```bash cURL
325343 curl --globoff "https://api.anthropic.com/v1/organizations/spend_limits/effective?user_ids[]=user_01AbCdEfGh&period[]=monthly" \
326 --header "x-api-key: $ANTHROPIC_ADMIN_KEY"
344 --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
345 --header "anthropic-version: 2023-06-01"
327346 ```
328347
3293482. Raise the cap:
from line 351
332351 curl --request POST "https://api.anthropic.com/v1/organizations/spend_limits" \
333352 --header "content-type: application/json" \
334353 --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
354 --header "anthropic-version: 2023-06-01" \
335355 --data '{"scope": {"type": "user", "user_id": "user_01AbCdEfGh"}, "amount": "500000", "period": "monthly"}'
336356 ```
337357
from line 361
341361 curl --request POST "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn/members" \
342362 --header "content-type: application/json" \
343363 --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
364 --header "anthropic-version: 2023-06-01" \
344365 --data '{"user_id": "user_01AbCdEfGh"}'
345366 ```
346367