List usage events
list_usage_eventsRetrieve itemized billable usage events. Filter by session_id to see exactly what one call cost and why, with each event summing to the debited amount.
Instructions
Every billable line, itemised. Filter by session_id (from a call record) to see exactly what one call cost and why: the sum of a call's events equals what was debited.
Requires scope usage:read.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_usage_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | ISO 8601 timestamp, UTC, e.g. "2026-09-01T12:00:00.000Z". | |
| limit | No | Page size, 1–100. Default 20. | |
| start | No | ISO 8601 timestamp, UTC, e.g. "2026-09-01T12:00:00.000Z". | |
| component | No | ||
| session_id | No | The call's session_id (not its id). | |
| ending_before | No | Cursor from a previous response. Fetches the page before it. Not with starting_after. | |
| starting_after | No | Cursor from a previous response's next_cursor. Fetches the page after it. |