API usage analytics and limits
The Console shows your organization’s API usage on three pages: Usage Limits for the plan windows, Billing Details for spend by day and model, and Export Records for a download. Every API response also reports its own token counts.
Where to look
| Question | Console page |
|---|---|
| How much of my plan is used, and when does it reset? | Usage Limits |
| What did I spend, per day or per model? | Billing Details |
| How much credit is left? | Billing overview |
| Which top-ups did we buy? | Recharge Details |
| Can I get the data as a file? | Export Records |
Select an organization first; on Personal most of these pages show no data.
The limits that apply
| Limit | Value | Error when hit |
|---|---|---|
| Requests per API key | 600 per minute | 429 rate_limited |
| Request body | About 2 MB | 413 payload_too_large |
| Messages per request | 500 | 413 too_many_messages |
| Context window | Per model (context_window in GET /v1/models), input plus max_tokens | 400 context_length_exceeded |
| Plan windows | 5-hour session (25%), weekly (60%), monthly (100%) | 402 quota_exhausted |
| Spend limits and credit balance | Set by your admins and top-ups | 402 with a limit value |
The full explanation is in Rate limits and quotas.
Need more?
- Raise your plan allowance: Change your plan.
- Keep going past the plan: Turn usage credits on or off.
- Higher request rates: Contact Sales → Increase Rate Limits in the Console.
Learn more
Was this page helpful?