---
title: "Get Test Case"
method: GET
path: "/v1/test-cases/{testCaseId}"
tags: ["Test Cases"]
---

# Get Test Case

`GET /v1/test-cases/{testCaseId}`

Retrieves the full details of a single simulation test case by testCaseId. Returns the conversation scenario definition, including the user persona, goals, evaluation criteria, and current status.

## Path parameters

- `testCaseId` string, required

## Query parameters

- `agentId` string, required

## Response `200`

OK

- 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.

## 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/versions/d00f52b5123f/schema)