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

# Get session usage stats

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

## Request

- Base URL: `/api/plugins/consensys-asko11y-app/resources` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/plugins/consensys-asko11y-app/resources/api/sessions/{sessionId}/stats`
- Auth: one of:
  - API key in cookie `grafana_session`
  - HTTP bearer

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

## Changes

- **2026-08-11** `9762a43a4598`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/consensys/apis/ask-o11y-ai-powered-observability-assistant-api/changes/api/sessions/:sessionId/stats/get.md)

---

[API](https://skmtc.dev/consensys/apis/ask-o11y-ai-powered-observability-assistant-api.md) - [All operations](https://skmtc.dev/consensys/apis/ask-o11y-ai-powered-observability-assistant-api/llms.txt) - [OpenAPI document](https://skmtc.dev/consensys/apis/ask-o11y-ai-powered-observability-assistant-api/revisions/ee3ccd0f186d?raw)