---
title: "Get session usage stats"
method: GET
path: "/api/sessions/{sessionId}/stats"
tags: ["Sessions"]
---

# Get session usage stats

`GET /api/sessions/{sessionId}/stats`

Returns cumulative usage stats (tokens, turns, tool calls) for a session, accumulated across all its agent runs. Only the session owner (same user + org) can access it. Omits the full message history — use GET /api/sessions/{sessionId} for the full transcript.

## Path parameters

- `sessionId` string, required

## Headers

- `X-Grafana-Org-Id` string

## Response `200`

Session usage stats

- SessionStats — Cumulative usage stats for a session, accumulated across all its agent runs
  - `sessionId` string, required — Session ID (base64 URL-safe 32-byte token)
  - `runCount` integer, required — Number of completed agent runs (turns) in this session
  - `totalIterations` integer, required — Sum of agent-loop iterations (LLM round-trips) across all runs
  - `toolCallCount` integer, required — Sum of tool calls executed across all runs
  - `promptTokens` integer, required — Sum of LLM prompt tokens across all runs
  - `completionTokens` integer, required — Sum of LLM completion tokens across all runs
  - `totalTokens` integer, required — Sum of LLM prompt + completion tokens across all runs
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400` — Bad request (invalid parameters or malformed request body)
- `401` — Unauthorized (missing or invalid authentication)
- `404` — Resource not found
- `500` — Internal server error

---

[API](https://skmtc.net/consensys/apis/ask-o11y-ai-powered-observability-assistant-api.md) · [All operations](https://skmtc.net/consensys/apis/ask-o11y-ai-powered-observability-assistant-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/consensys/ask-o11y-ai-powered-observability-assistant-api/revisions/9762a43a4598/schema)