> ## Documentation Index > Fetch the complete documentation index at: https://docs.fish.audio/llms.txt > Use this file to discover all available pages before exploring further. # List Test Runs > List your team's test runs, newest first. ## OpenAPI ````yaml get /v1/agent/test-runs openapi: 3.1.0 info: title: FishAudio OpenAPI version: '1' servers: - description: Fish Audio API url: https://api.fish.audio security: [] tags: [] paths: /v1/agent/test-runs: get: tags: - Agent Tests summary: List Test Runs description: >- Your team's test runs, newest first, filtered by agent, test, batch, status or test type. Items leave out the conversation and the judge's output. Fetch one run with `GET /v1/agent/test-runs/{run_id}` for those. Paginate with `cursor` (follow `next_cursor` while `has_more` is true) or with `page` for offset pagination with a `total` count. The two are mutually exclusive. parameters: - in: query name: agent_id description: '' required: false schema: anyOf: - type: string - type: 'null' default: null title: Agent Id deprecated: false - in: query name: test_id description: '' required: false schema: anyOf: - type: string - type: 'null' default: null title: Test Id deprecated: false - in: query name: batch_id description: '' required: false schema: anyOf: - type: string - type: 'null' default: null title: Batch Id deprecated: false - in: query name: status description: '' required: false schema: anyOf: - enum: - queued - running - passed - failed - error type: string - type: 'null' default: null title: Status deprecated: false - in: query name: test_type description: '' required: false schema: anyOf: - enum: - next_reply - tool - simulation type: string - type: 'null' default: null title: Test Type deprecated: false - in: query name: cursor description: '' required: false schema: anyOf: - type: string - type: 'null' default: null title: Cursor deprecated: false - in: query name: page description: 1-based page number, mutually exclusive with cursor. required: false schema: anyOf: - minimum: 1 type: integer - type: 'null' default: null title: Page deprecated: false - in: query name: include_total description: '' required: false schema: default: false title: Include Total type: boolean deprecated: false - in: query name: page_size description: '' required: false schema: default: 30 maximum: 100 minimum: 1 title: Page Size type: integer deprecated: false responses: '200': description: Request fulfilled, document follows headers: {} content: application/json: schema: properties: runs: items: $ref: '#/components/schemas/PublicAgentTestRunSummary' title: Runs type: array has_more: title: Has More type: boolean next_cursor: anyOf: - type: string - type: 'null' default: null title: Next Cursor total: anyOf: - type: integer - type: 'null' default: null title: Total required: - runs - has_more type: object '400': description: Bad request syntax or unsupported method headers: {} content: application/json: schema: properties: status: title: Status type: integer message: title: Message type: string reason: anyOf: - type: string - type: 'null' default: null title: Reason required: - status - message type: object '401': description: No permission -- see authorization schemes headers: {} content: application/json: schema: properties: status: title: Status type: integer message: title: Message type: string reason: anyOf: - type: string - type: 'null' default: null title: Reason required: - status - message type: object '404': description: Nothing matches the given URI headers: {} content: application/json: schema: properties: status: title: Status type: integer message: title: Message type: string reason: anyOf: - type: string - type: 'null' default: null title: Reason required: - status - message type: object '503': description: The server cannot process the request due to a high load headers: {} content: application/json: schema: properties: status: title: Status type: integer message: title: Message type: string reason: anyOf: - type: string - type: 'null' default: null title: Reason required: - status - message type: object security: - BearerAuth: [] components: schemas: PublicAgentTestRunSummary: properties: run_id: title: Run Id type: string test_id: title: Test Id type: string agent_id: title: Agent Id type: string batch_id: anyOf: - type: string - type: 'null' default: null title: Batch Id test_type: enum: - next_reply - tool - simulation title: Test Type type: string repeat_index: default: 0 description: Which repeat of the test in its batch this run is. title: Repeat Index type: integer status: enum: - queued - running - passed - failed - error title: Status type: string needs_review: default: false description: The judge could not decide, or a tool call had no mock answer. title: Needs Review type: boolean error: default: '' title: Error type: string usage: $ref: '#/components/schemas/PublicAgentTestRunUsage' created_at: format: date-time title: Created At type: string started_at: anyOf: - format: date-time type: string - type: 'null' default: null title: Started At finished_at: anyOf: - format: date-time type: string - type: 'null' default: null title: Finished At required: - run_id - test_id - agent_id - test_type - status - created_at title: PublicAgentTestRunSummary type: object PublicAgentTestRunUsage: properties: agent_replies: default: 0 title: Agent Replies type: integer cost_usd: anyOf: - type: string - type: 'null' default: null description: LLM cost of the run in USD, null while any part is unpriced. title: Cost Usd title: PublicAgentTestRunUsage type: object securitySchemes: BearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.