Budget
| Method | Path | Description |
|---|---|---|
| GET | /v1/usage | Budget for the authenticated API key. |
Usage response
{
"object": "api_key.usage",
"id": "key_abc",
"name": "Claude Prod",
"redacted_value": "sk-...abcd",
"foundation": "all",
"budget": {
"used_percent": 40,
"remaining_percent": 60
},
"subscription": {
"five_hour": { "window_seconds": 18000, "used_percent": 30, "remaining_percent": 70 },
"weekly": { "window_seconds": 604800, "used_percent": 42, "remaining_percent": 58 }
}
}Budget consumption is reported as percentages only. The subscription block is present only for keys on a subscription tier and reports rolling 5-hour and weekly windows.