---
title: "List Test Runs"
method: GET
path: "/v1/test-runs"
tags: ["Test Runs"]
---

# List Test Runs

`GET /v1/test-runs`

Returns a paginated list of test run results for the specified batch, sorted by most recently created first. Use page and size to navigate through results.

## Query parameters

- `batchId` string, required
- `agentId` string, required
- `page` integer
- `size` integer

## Response `200`

OK

- PaginatedResponseTestCaseRunResponse — Standard wrapper for paginated API responses. Use this when returning list data that is split across multiple pages. Includes the current page of results along with pagination metadata to help clients navigate through large datasets efficiently.
  - `data` TestCaseRunResponse[] — List of items for the current page. Contains up to 'size' number of records.
    - `batchId` string — The unique identifier of the batch run this simulation attempt belongs to.
    - `workspaceId` string — The unique identifier of the workspace under which this simulation attempt was created.
    - `agent` AgentResponse — Agent assigned to handle all calls in this campaign. Contains the agent's ID, name, and current status. All contacts in the campaign's contact list will be called using this agent.
      - `name` string — The display name of the assigned agent.
      - `agentId` string — The unique identifier of the agent within the system.
      - `status` 'Live' | 'Testing' | 'Disabled' — The current operational status of the agent.
    - `testCase` TestCaseResponse
      - `testCaseId` string — The unique identifier of the test case.
      - `label` string — A human-readable name or label for the test case, used to identify it in reports and dashboards.
      - `agent` AgentResponse — Agent assigned to handle all calls in this campaign. Contains the agent's ID, name, and current status. All contacts in the campaign's contact list will be called using this agent.
        - `name` string — The display name of the assigned agent.
        - `agentId` string — The unique identifier of the agent within the system.
        - `status` 'Live' | 'Testing' | 'Disabled' — The current operational status of the agent.
      - `workspaceId` string — The unique identifier of the workspace under which this test case was created.
      - `llmModel` string — The LLM model used to generate Agent responses during the simulation.
      - `mockData` MockDataResponse[] — The list of mock variables and their simulated values that were used to substitute for real external data sources during the simulation.
        - `variableName` string — The name of the variable that was substituted with mock data during the simulation.
        - `value` string — The simulated value that was assigned to the variable for the duration of the test run.
      - `userPrompt` string — The prompt that defined the persona and intent of the simulated user, driving the user-side messages throughout the conversation.
      - `attempt` integer — The number of times this test case was configured to run as independent simulation attempts.
      - `successCriteria` string — The plain-language description of what a successful agent response looks like, used to evaluate the agent's performance after each simulation run.
    - `jobId` string — The unique identifier of this individual simulation attempt within the batch run.
    - `chatId` string — The unique identifier of the chat session generated during this simulation run.
    - `createdDate` string, date-time — The UTC timestamp indicating when this simulation run was initiated.
    - `completedDate` string, date-time — The UTC timestamp indicating when this simulation run was completed.
    - `isSuccessful` boolean — Indicates whether the Agent met the success criteria during this simulation run.
    - `remarks` string — A plain-language explanation of why the simulation run was evaluated as successful or failed, based on the success criteria.
    - `conversation` ConversationResponse[] — The full transcript of the conversation between the simulated user and the Agent during this simulation run.
      - `role` string — The role of the participant who sent this message in the simulation. Indicates whether the message was generated by the simulated user or the Agent.
      - `content` string — The message content produced by the participant for this turn in the conversation.
  - `page` integer — Current page number (0-based index). Indicates which page of results is being returned.
  - `size` integer — Number of items requested per page. Determines the maximum size of the 'data' list.
  - `totalCount` integer — Total number of records available across all pages. Useful for calculating pagination on the client side.
  - `totalPages` integer — Total number of pages available based on totalCounts and size. Helps clients understand how many pages exist in total.
  - `hasNext` boolean — Indicates whether there is a next page available after the current one. Useful for implementing 'Load More' or next navigation.
  - `hasPrevious` boolean — Indicates whether there is a previous page before the current one. Useful for enabling backward navigation.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/sigmamind/apis/sigmamind-apis.md) · [All operations](https://skmtc.net/sigmamind/apis/sigmamind-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sigmamind/sigmamind-apis/revisions/d00f52b5123f/schema)