---
title: "GET /experimental/eval-runs/{id}/stats"
method: GET
path: "/experimental/eval-runs/{id}/stats"
tags: ["Evals"]
---

# GET /experimental/eval-runs/{id}/stats

`GET /experimental/eval-runs/{id}/stats`

Returns aggregated stats per (scenario × variant) group for an eval run. Every numeric quantity carries the full distribution suite — Min, Q1, Median, Mean, Q3, Max, StdDev — never bare means.

## Path parameters

- `id` string, uuid, required

## Response `200`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
  - `data` object, required
    - `id` string, uuid, required
    - `type` 'eval-run-stats', required
    - `attributes` object, required
      - `groups` object[], required
        - `scenarioId` string, uuid, required
        - `variant` string, required
        - `path` string
        - `shortDescription` string
        - `repeatCount` number, required
        - `recipe` object, required
          - `durationMs` object, required
            - `count` number, required
            - `missingCount` number, required
            - `min` number, required
            - `q1` number, required
            - `median` number, required
            - `mean` number, required
            - `q3` number, required
            - `max` number, required
            - `stdDev` number, required
          - `agentDurationMs` object, required
            - `count` number, required
            - `missingCount` number, required
            - `min` number, required
            - `q1` number, required
            - `median` number, required
            - `mean` number, required
            - `q3` number, required
            - `max` number, required
            - `stdDev` number, required
          - `costUsd` object, required
            - `count` number, required
            - `missingCount` number, required
            - `min` number, required
            - `q1` number, required
            - `median` number, required
            - `mean` number, required
            - `q3` number, required
            - `max` number, required
            - `stdDev` number, required
          - `inputTokens` object, required
            - `count` number, required
            - `missingCount` number, required
            - `min` number, required
            - `q1` number, required
            - `median` number, required
            - `mean` number, required
            - `q3` number, required
            - `max` number, required
            - `stdDev` number, required
          - `outputTokens` object, required
            - `count` number, required
            - `missingCount` number, required
            - `min` number, required
            - `q1` number, required
            - `median` number, required
            - `mean` number, required
            - `q3` number, required
            - `max` number, required
            - `stdDev` number, required
          - `totalTokens` object, required
            - `count` number, required
            - `missingCount` number, required
            - `min` number, required
            - `q1` number, required
            - `median` number, required
            - `mean` number, required
            - `q3` number, required
            - `max` number, required
            - `stdDev` number, required
          - `cacheReadTokens` object, required
            - `count` number, required
            - `missingCount` number, required
            - `min` number, required
            - `q1` number, required
            - `median` number, required
            - `mean` number, required
            - `q3` number, required
            - `max` number, required
            - `stdDev` number, required
          - `cacheCreationTokens` object, required
            - `count` number, required
            - `missingCount` number, required
            - `min` number, required
            - `q1` number, required
            - `median` number, required
            - `mean` number, required
            - `q3` number, required
            - `max` number, required
            - `stdDev` number, required
          - `turns` object, required
            - `count` number, required
            - `missingCount` number, required
            - `min` number, required
            - `q1` number, required
            - `median` number, required
            - `mean` number, required
            - `q3` number, required
            - `max` number, required
            - `stdDev` number, required
          - `score` object, required
            - `count` number, required
            - `missingCount` number, required
            - `min` number, required
            - `q1` number, required
            - `median` number, required
            - `mean` number, required
            - `q3` number, required
            - `max` number, required
            - `stdDev` number, required
          - `metricsMissing` number, required
        - `perTurn` object
          - `turns` object, required
            - `durationMs` object, required
              - …
            - `tokensPerTurn` object, required
              - …
            - `cachedTokensPerTurn` object, required
              - …
          - `tools` object, required
            - `perTool` object[], required
              - …
            - `allTools` object, required
              - …
          - `agentLogUnavailable` number, required
        - `scorer` object
          - `totalTimeMs` object, required
            - `count` number, required
            - `missingCount` number, required
            - `min` number, required
            - `q1` number, required
            - `median` number, required
            - `mean` number, required
            - `q3` number, required
            - `max` number, required
            - `stdDev` number, required
          - `scorerTaskTimeMs` object, required
            - `count` number, required
            - `missingCount` number, required
            - `min` number, required
            - `q1` number, required
            - `median` number, required
            - `mean` number, required
            - `q3` number, required
            - `max` number, required
            - `stdDev` number, required
          - `costUsd` object, required
            - `count` number, required
            - `missingCount` number, required
            - `min` number, required
            - `q1` number, required
            - `median` number, required
            - `mean` number, required
            - `q3` number, required
            - `max` number, required
            - `stdDev` number, required
          - `inputTokens` object, required
            - `count` number, required
            - `missingCount` number, required
            - `min` number, required
            - `q1` number, required
            - `median` number, required
            - `mean` number, required
            - `q3` number, required
            - `max` number, required
            - `stdDev` number, required
          - `outputTokens` object, required
            - `count` number, required
            - `missingCount` number, required
            - `min` number, required
            - `q1` number, required
            - `median` number, required
            - `mean` number, required
            - `q3` number, required
            - `max` number, required
            - `stdDev` number, required
          - `cacheReadTokens` object, required
            - `count` number, required
            - `missingCount` number, required
            - `min` number, required
            - `q1` number, required
            - `median` number, required
            - `mean` number, required
            - `q3` number, required
            - `max` number, required
            - `stdDev` number, required
          - `cacheCreationTokens` object, required
            - `count` number, required
            - `missingCount` number, required
            - `min` number, required
            - `q1` number, required
            - `median` number, required
            - `mean` number, required
            - `q3` number, required
            - `max` number, required
            - `stdDev` number, required
          - `metricsMissing` number, required
        - `criteria` object[]
          - `name` string, required
          - `maxScore` number, required
          - `score` object, required
            - `count` number, required
            - `missingCount` number, required
            - `min` number, required
            - `q1` number, required
            - `median` number, required
            - `mean` number, required
            - `q3` number, required
            - `max` number, required
            - `stdDev` number, required
      - `arms` object[], required
        - `label` string, required
        - `agent` string, required
        - `model` string, required
        - `includeContext` boolean, required
        - `forceContextActivation` boolean, required
        - `fixtureNames` string[], required
        - `addedFixtureNames` string[], required
        - `deletedFixtureNames` string[], required
      - `baseFixtureNames` string[], required
      - `variedDimensionKeys` string[], required
      - `summary` object[], required
        - `label` string, required
        - `meanScore` number
        - `scoreStdDev` number
        - `medianCostUsd` number
        - `repeatCount` number, required
        - `scenarioCount` number, required
        - `missingScoreCount` number, required
        - `missingCostCount` number, required
        - `score` object, required
          - `count` number, required
          - `missingCount` number, required
          - `min` number, required
          - `q1` number, required
          - `median` number, required
          - `mean` number, required
          - `q3` number, required
          - `max` number, required
          - `stdDev` number, required
        - `costUsd` object, required
          - `count` number, required
          - `missingCount` number, required
          - `min` number, required
          - `q1` number, required
          - `median` number, required
          - `mean` number, required
          - `q3` number, required
          - `max` number, required
          - `stdDev` number, required
        - `agentDurationMs` object, required
          - `count` number, required
          - `missingCount` number, required
          - `min` number, required
          - `q1` number, required
          - `median` number, required
          - `mean` number, required
          - `q3` number, required
          - `max` number, required
          - `stdDev` number, required
        - `totalTokens` object, required
          - `count` number, required
          - `missingCount` number, required
          - `min` number, required
          - `q1` number, required
          - `median` number, required
          - `mean` number, required
          - `q3` number, required
          - `max` number, required
          - `stdDev` number, required
        - `inputTokens` object, required
          - `count` number, required
          - `missingCount` number, required
          - `min` number, required
          - `q1` number, required
          - `median` number, required
          - `mean` number, required
          - `q3` number, required
          - `max` number, required
          - `stdDev` number, required
        - `outputTokens` object, required
          - `count` number, required
          - `missingCount` number, required
          - `min` number, required
          - `q1` number, required
          - `median` number, required
          - `mean` number, required
          - `q3` number, required
          - `max` number, required
          - `stdDev` number, required
        - `totalCostUsd` number
      - `solutionCount` number, required
      - `reusedCount` number, required

## Other responses

- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2026-09-10** `e57a144d1cab` — 4 info
  - added the required property `data/attributes/arms/items/addedFixtureNames` to the response with the `200` status
  - added the required property `data/attributes/arms/items/deletedFixtureNames` to the response with the `200` status
  - added the required property `data/attributes/baseFixtureNames` to the response with the `200` status
  - added the required property `data/attributes/groups/items/recipe/totalTokens` to the response with the `200` status
- **2026-09-08** `989fccac42c5` — 13 info
  - added the optional property `data/attributes/summary/items/totalCostUsd` to the response with the `200` status
  - the response property `data/attributes/arms/items/forceContextActivation` became required for the status `200`
  - response property `data/attributes/summary/items/meanScore` deprecated
  - response property `data/attributes/summary/items/medianCostUsd` deprecated
  - …9 more
- **2026-09-04** `ffb03b5d287f` — 4 info
  - added the optional property `data/attributes/groups/items/criteria` to the response with the `200` status
  - added the required property `data/attributes/arms` to the response with the `200` status
  - added the required property `data/attributes/summary` to the response with the `200` status
  - added the required property `data/attributes/variedDimensionKeys` to the response with the `200` status
- **2026-09-01** `756235b720be` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/tessl/apis/tessl-api/changes/experimental/eval-runs/:id/stats/get.md)

---

[API](https://skmtc.dev/tessl/apis/tessl-api.md) · [All operations](https://skmtc.dev/tessl/apis/tessl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tessl/apis/tessl-api/revisions/6da83f4191fc?raw)
