---
title: "Get Eval KPI"
method: GET
path: "/api/platform/v1/evals/{slug}/kpi"
tags: ["observability"]
---

# Get Eval KPI

`GET /api/platform/v1/evals/{slug}/kpi`

## Request

- Base URL: `https://docs.amdahl.ai`
- URL: `https://docs.amdahl.ai/api/platform/v1/evals/{slug}/kpi`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Fetch the score trend for one eval as a time series over its completed runs: mean submitted-side score per day/week/month, the improved-side ceiling, refusal rate, and the current-vs-prior-window delta. Read when reporting whether writing quality is improving over time. The trend tracks the grade of what callers SUBMITTED, read from verdict.headline so it means one thing across an eval_version bump; windows under 3 scored runs abstain with a named reason rather than assert a mean.

## Path parameters

- `slug` string, required

## Query parameters

- `window_days` integer: Trailing window to aggregate (default 90, clamped 7-365).
- `granularity` 'day' | 'week' | 'month'

## Response `200`

OK

- object
  - `data` unknown

## Other responses

- `400`: Invalid input - failed schema validation
- `401`: Authentication required
- `403`: Forbidden - missing scope or role
- `404`: Not found
- `500`: Internal server error

---

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