---
title: "Get session usage"
method: GET
path: "/session/{sessionID}/usage"
tags: ["Session"]
---

# Get session usage

`GET /session/{sessionID}/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.

## Path parameters

- `sessionID` string, required

## Query parameters

- `directory` string

## Response `200`

Aggregated usage

- object
  - `rootID` string, required
  - `totalCost` number, required
  - `totalTokens` number, required
  - `sessionCount` number, required

## Other responses

- `400` — Bad request
- `404` — Not found

---

[API](https://skmtc.net/cyberstrikeus/apis/cyberstrike.md) · [All operations](https://skmtc.net/cyberstrikeus/apis/cyberstrike/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cyberstrikeus/cyberstrike/versions/4e11f1aed2fd/schema)