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

# Get session usage stats

`GET /api/v1/sessions/{session_id}/stats`

Aggregated token counts, latency, and model breakdown for all turns in a session.

## Path parameters

- `session_id` string, required — Identifier of the session whose stats to retrieve.

## Response `200`

Successful Response

- SessionStatsResponse — Aggregated usage stats for a session.
  - `total_tokens_in` integer — Total input tokens across all turns.
  - `total_tokens_out` integer — Total output tokens across all turns.
  - `total_latency_ms` integer — Total latency in milliseconds across all turns.
  - `model_breakdown` object — Mapping of model_name to turn count.

## Other responses

- `401` — Authentication is required or the provided token is invalid.
- `403` — The caller does not have permission to access this resource.
- `404` — Session not found.
- `422` — Validation Error
- `503` — Session services are unavailable because server startup is incomplete.

---

[API](https://skmtc.net/qredence/apis/fleet-rlm.md) · [All operations](https://skmtc.net/qredence/apis/fleet-rlm/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qredence/fleet-rlm/revisions/62e8c152aa18/schema)