---
title: "List Test Batches"
method: GET
path: "/v1/agent/agents/{agent_id}/test-batches"
tags: ["Agent Tests"]
---

# List Test Batches

`GET /v1/agent/agents/{agent_id}/test-batches`

## Request

- Base URL: `https://api.fish.audio`
- URL: `https://api.fish.audio/v1/agent/agents/{agent_id}/test-batches`
- Auth: HTTP bearer

The agent's test batches, newest first, with their pass, fail and error
counts. Paginate with `cursor`, following `next_cursor` while `has_more` is
true.

## Path parameters

- `agent_id` string, required

## Query parameters

- `cursor` string, nullable
- `page_size` integer

## Response `200`

Request fulfilled, document follows

- object
  - `batches` PublicAgentTestBatchSummary[], required
    - `batch_id` string, required
    - `agent_id` string, required
    - `status` 'running' | 'completed', required: running until every run has finished.
    - `completed` boolean, required
    - `passed` integer, required
    - `failed` integer, required
    - `errors` integer, required
    - `pass_rate` number, nullable: passed / (passed + failed), null until a run passed or failed. Error runs never judged the agent and are left out.
    - `run_count` integer, required
    - `trigger_source` 'console' | 'api', required: Where the batch was started: the console or the API.
    - `created_at` string, date-time, required: When the first run was created.
    - `finished_at` string, date-time, nullable: When the last run finished, null until the batch completed.
  - `has_more` boolean, required
  - `next_cursor` string, nullable

## Other responses

- `400`: Bad request syntax or unsupported method
- `401`: No permission -- see authorization schemes
- `404`: Nothing matches the given URI
- `503`: The server cannot process the request due to a high load

## Changes

- **2026-11-03** `42ac421f7a12`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fish/apis/fishaudio-openapi/changes/v1/agent/agents/:agent_id/test-batches/get.md)

---

[API](https://skmtc.dev/fish/apis/fishaudio-openapi.md) - [All operations](https://skmtc.dev/fish/apis/fishaudio-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/fish/apis/fishaudio-openapi/revisions/42ac421f7a12?raw)