---
title: "Get session statistics"
method: GET
path: "/api/experimental/session/stats"
tags: ["session"]
---

# Get session statistics

`GET /api/experimental/session/stats`

## Request

- Base URL: `https://opencode.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://opencode.ai/api/experimental/session/stats`
- Auth: none required

Aggregate local session activity, usage, and tool reliability for a time range.

## Query parameters

- `from` string, nullable
- `to` string, nullable
- `project` string
- `timezone` string, nullable
- `tools` 'none' | 'summary' | 'detail', nullable

## Response `200`

Success

- object
  - `data` SessionStatsInfo, required
    - `range` object, required
      - `from` number, required
      - `to` number, required
    - `sessions` integer, required
    - `subagents` integer, required
    - `prompts` integer, required
    - `steps` integer, required
    - `tokens` TokenUsageInfo, required
      - `input` number, required
      - `output` number, required
      - `reasoning` number, required
      - `cache` object, required
        - `read` number, required
        - `write` number, required
    - `cost` number, required
    - `tools` union, required
      - object
        - `mode` 'none', required
      - object
        - `mode` 'summary', required
        - `totals` SessionStatsToolTotals, required
          - `calls` integer, required
          - `succeeded` integer, required
          - `failed` integer, required
          - `unfinished` integer, required
      - object
        - `mode` 'detail', required
        - `totals` SessionStatsToolTotals, required
          - `calls` integer, required
          - `succeeded` integer, required
          - `failed` integer, required
          - `unfinished` integer, required
        - `usage` SessionStatsToolUsage[], required
          - `name` string, required
          - `calls` integer, required
          - `succeeded` integer, required
          - `failed` integer, required
          - `unfinished` integer, required
          - `durationP50` number
    - `activeDays` integer, required
    - `streak` integer, required
    - `activity` SessionStatsActivity[], required
      - `date` string, required
      - `steps` integer, required
    - `models` SessionStatsModelUsage[], required
      - `model` ModelRef, required
        - `id` string, required
        - `providerID` string, required
        - `variant` string
      - `steps` integer, required
      - `tokens` TokenUsageInfo, required
        - `input` number, required
        - `output` number, required
        - `reasoning` number, required
        - `cache` object, required
          - `read` number, required
          - `write` number, required
      - `cost` number, required

## Other responses

- `400`: InvalidRequestError
- `401`: UnauthorizedError

---

[API](https://skmtc.dev/kaaass/apis/opencode.md) - [All operations](https://skmtc.dev/kaaass/apis/opencode/llms.txt) - [OpenAPI document](https://skmtc.dev/kaaass/apis/opencode/revisions/4e083d954707?raw)