Session

Get session usage

Aggregate token and cost usage across the session and all its descendant subagents. Resolves the tree root, so the result is the same whether a parent or child session ID is passed.

get/session/{sessionID}/usage

Path parameters

sessionIDstring required

Query parameters

directorystring

Response

Aggregated usage

rootIDstring required

totalCostnumber required

totalTokensnumber required

sessionCountnumber required

Changes

Changed in 2 of the 102 revisions of this API.11

Jun 17, 2026d416958f05571See the full diff
- ○
  endpoint added
  endpoint-added
Jan 20, 2026c7ae6a68e4fb1See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 36 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history