Get usage
GET /admin/v1/usage
Requests, tokens, pages, errors and cost of a time range, with averages per request.
The console's Analytics page shows the same data. Times are UTC. Usage counts are exact, and rated costs come from the billing report, so the newest usage can wait for a cost.
Use an admin key.
Your Munito API key, with the admin:read permission.
In: header
Query Parameters
A range that ends now. Ignored when month or start and end are set.
"7d"Value in
- "1h"
- "6h"
- "24h"
- "7d"
- "14d"
- "30d"
A UTC calendar month, such as 2026-09.
With end: a custom range of at most 30 days, in whole minutes.
The end of a custom range.
Break down by model or API key.
"model"Value in
- "model"
- "key"
Only these model ids.
Only these API key ids.
Also return the totals of each interval.
falseResponse Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/usage"{
"object": "usage_report",
"start": "2019-08-24T14:15:22Z",
"end": "2019-08-24T14:15:22Z",
"interval_seconds": 0,
"group_by": "model",
"costs_rated_until": "2019-08-24T14:15:22Z",
"totals": {
"requests": 0,
"completed_requests": 0,
"success_rate": 0,
"responses": {
"success": 0,
"client_errors": 0,
"rate_limited": 0,
"server_errors": 0,
"unavailable": 0
},
"input_tokens": 0,
"cached_input_tokens": 0,
"cache_hit_rate": 0,
"output_tokens": 0,
"total_tokens": 0,
"pages": 0,
"rated_cost_usd": 0,
"avg_input_tokens_per_request": 0,
"avg_output_tokens_per_request": 0,
"avg_total_tokens_per_request": 0
},
"groups": [
{
"requests": 0,
"completed_requests": 0,
"success_rate": 0,
"responses": {
"success": 0,
"client_errors": 0,
"rate_limited": 0,
"server_errors": 0,
"unavailable": 0
},
"input_tokens": 0,
"cached_input_tokens": 0,
"cache_hit_rate": 0,
"output_tokens": 0,
"total_tokens": 0,
"pages": 0,
"rated_cost_usd": 0,
"avg_input_tokens_per_request": 0,
"avg_output_tokens_per_request": 0,
"avg_total_tokens_per_request": 0,
"id": "string",
"name": "string"
}
],
"series": [
{
"start": "2019-08-24T14:15:22Z",
"requests": 0,
"completed_requests": 0,
"input_tokens": 0,
"output_tokens": 0,
"pages": 0,
"rated_cost_usd": 0
}
]
}