usage

Get detailed token and estimated cost usage for one session

get/api/v1/usage/sessions/{sessionId}

Path parameters

sessionIdstring required

Session identifier, e.g. project-1.

Response

incompleteboolean required

sessionIdstring required

Changes

Changed in 3 of the 108 revisions of this API.1216

Aug 28, 2026e853ada076ff123See the full diff
- ▲
  removed the required property harnesses/items/models/items/totals/cacheWriteTokens from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property harnesses/items/models/items/totals/provenance from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property harnesses/items/models/items/totals/providerDetails from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property harnesses/items/models/items/totals/reasoningTokens from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property harnesses/items/totals/cacheWriteTokens from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property harnesses/items/totals/provenance from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property harnesses/items/totals/providerDetails from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property harnesses/items/totals/reasoningTokens from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property totals/cacheWriteTokens from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property totals/provenance from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property totals/providerDetails from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property totals/reasoningTokens from the response with the 200 status
  response-required-property-removed
- ○
  added the required property harnesses/items/models/items/totals/estimatedCost to the response with the 200 status
  response-required-property-added
- ○
  added the required property harnesses/items/totals/estimatedCost to the response with the 200 status
  response-required-property-added
- ○
  added the required property totals/estimatedCost to the response with the 200 status
  response-required-property-added
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 21, 20265682a5de740912See the full diff
- ○
  added the required property harnesses/items/models/items/totals/cachedInputTokens to the response with the 200 status
  response-required-property-added
- ○
  added the required property harnesses/items/models/items/totals/processedTokens to the response with the 200 status
  response-required-property-added
- ○
  added the required property harnesses/items/models/items/totals/provenance to the response with the 200 status
  response-required-property-added
- ○
  added the required property harnesses/items/models/items/totals/providerDetails to the response with the 200 status
  response-required-property-added
- ○
  added the required property harnesses/items/totals/cachedInputTokens to the response with the 200 status
  response-required-property-added
- ○
  added the required property harnesses/items/totals/processedTokens to the response with the 200 status
  response-required-property-added
- ○
  added the required property harnesses/items/totals/provenance to the response with the 200 status
  response-required-property-added
- ○
  added the required property harnesses/items/totals/providerDetails to the response with the 200 status
  response-required-property-added
- ○
  added the required property totals/cachedInputTokens to the response with the 200 status
  response-required-property-added
- ○
  added the required property totals/processedTokens to the response with the 200 status
  response-required-property-added
- ○
  added the required property totals/provenance to the response with the 200 status
  response-required-property-added
- ○
  added the required property totals/providerDetails to the response with the 200 status
  response-required-property-added
Aug 6, 2026966e7144cdbc1See the full diff
- ○
  endpoint added
  endpoint-added

Full history