total_tokens. /spend/by-model, /spend/by-agent and /spend/users give each row's total. A row's total here can differ slightly from the one those lists show, because this endpoint adds up only the token types it recognizes.billing_period, or nothing at all, to report over a single calendar month.start_date and end_date together to report over an explicit span of up to 92 days.start_date and end_date, a period and a range together, an end date earlier than its start, or a range longer than 92 days each return a 400.curl --location --globoff 'https:///metering-service/api/v2/organizations//spend/token-breakdown?billing_period=&start_date=&end_date=&paginated=&page=&items_per_page=&group_by=&agent_id=&user_id=&model=' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer '{
"success": true,
"message": "Token breakdown retrieved successfully",
"data": {
"items": [
{
"agent_id": 4527,
"user_id": null,
"model": "claude-sonnet-5-5",
"day": null,
"input_tokens": 1000000,
"cached_input_tokens": 200000000,
"cache_write_tokens": 40000000,
"output_tokens": 5000000,
"total_tokens": 246000000
},
{
"agent_id": 4538,
"user_id": null,
"model": "gpt-5.4",
"day": null,
"input_tokens": 2000000,
"cached_input_tokens": 3000000,
"cache_write_tokens": 0,
"output_tokens": 100000,
"total_tokens": 5100000
}
],
"meta": {
"count": 37,
"current_page": 1,
"num_pages": 19
},
"totals": {
"input_tokens": 9000000,
"cached_input_tokens": 520000000,
"cache_write_tokens": 110000000,
"output_tokens": 14000000,
"total_tokens": 653000000
}
}
}