ListUsageEntriesResponse
A page of ledger entries, newest first.
Shape
itemsarray of UsageEntry
- The UsageEntry schema
- amount_microsinteger · int64
- entry_idUsageEntryId (string · uuid)
- fee_microsinteger · int64
- kindUsageEntryKindsettledorphan_settledcorrection
- lineUsageLineai_model_usageWhat a ledger entry charges for. One line so far: AI model usage.
- monthstring
- occurred_atstring · date-time
- price_refobjectWhat the amount was calculated from: the model price used and the token counts.
- subjectobjectWhat was charged for — for a model call, organization, agent, session and turn.
- next_tokenstring or nulloptional
Example
Synthesized example{
"items": [
{
"amount_micros": 82,
"entry_id": "5dbe0e0f-f5c7-436f-8d76-15fd84becf72",
"fee_micros": 66,
"kind": "settled",
"line": "ai_model_usage",
"month": "month-2da6",
"occurred_at": "2026-10-09T23:05:06Z",
"price_ref": {},
"subject": {}
},
{
"amount_micros": 54,
"entry_id": "b09d1f5f-1eae-476b-8bca-b89475e42b07",
"fee_micros": 42,
"kind": "settled",
"line": "ai_model_usage",
"month": "month-884a",
"occurred_at": "2026-10-11T07:20:11Z",
"price_ref": {},
"subject": {}
}
],
"next_token": "next-token-883a"
}
Graph
Used inside
No schema contains this one.
Contains
Used by
Sent by 0 operations
No operation takes it as a request body.
Returned by 1 operation