---
title: "Get Test Score History"
method: GET
path: "/voice/testing/{agentId}/score-history"
tags: ["Voice Agent Testing"]
---

# Get Test Score History

`GET /voice/testing/{agentId}/score-history`

## Request

- Base URL: `https://api.speakai.co/v1`
- URL: `https://api.speakai.co/v1/voice/testing/{agentId}/score-history`
- Auth: API key in header `x-speakai-key` and API key in header `x-access-token`

### Get Score History

Completed-run score points for charting, most recent first, capped at 100 regardless of `limit`. Only `status: completed` runs are included — a queued, running, paused, failed, or cancelled run never appears here.

## Path parameters

- `agentId` string, required

## Query parameters

- `limit` integer

## Response `200`

OK

- object
  - `status` 'success'
  - `data` object
    - `history` object[]
      - `runId` string
      - `score` number
      - `timestamp` string, date-time
      - `trigger` 'manual' | 'kb_update' | 'instruction_save' | 'scheduled'

## Other responses

- `404`: Agent not found

---

[API](https://skmtc.dev/speakai/apis/speak-ai-api.md) · [All operations](https://skmtc.dev/speakai/apis/speak-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/speakai/apis/speak-ai-api/revisions/52d777e6d46e?raw)