Skip to main content
GET
/
v1
/
run-test-case
/
{shortId}
Get run test case
curl --request GET \
  --url https://api.qa.tech/v1/run-test-case/{shortId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "shortId": "<string>",
  "name": "<string>",
  "status": "<string>",
  "result": "<string>",
  "resultTitle": "<string>",
  "evaluationThought": "<string>",
  "errorCode": "<string>",
  "classification": "<string>",
  "promptGoal": "<string>",
  "promptExamples": "<string>",
  "runShortId": "<string>",
  "projectTestCaseId": "<string>",
  "startedAt": "<string>",
  "completedAt": "<string>",
  "durationMs": 123,
  "url": "<string>",
  "screenshotUrl": "<string>",
  "recordingUrl": "<string>"
}

Path Parameters

​
shortId
string
required

Query Parameters

​
query
object
required

Response

200 - application/json

The request has succeeded.

Detailed view of a single run test case (one test's execution within a run), for root-cause investigation. Resolve the <shortId> from a /results/test/<shortId> URL.

​
id
string
required
​
shortId
string
required
​
name
string
required
​
status
string
required

Run lifecycle status: INITIATED, RUNNING, COMPLETED, ERROR, or CANCELLED.

​
result
string | null
required

Outcome once complete: PASSED, FAILED, or SKIPPED. null while still running.

​
resultTitle
string | null
required

Short human-readable summary of the result.

​
evaluationThought
string | null
required

The evaluator's reasoning for the pass/fail verdict.

​
errorCode
string | null
required

Error classification when the test did not cleanly pass/fail, e.g. TEST_FAILED (real product failure) vs an AGENT_/PLATFORM_ execution miss. null for a clean pass.

​
classification
string | null
required

POSITIVE (expected to succeed) or NEGATIVE (expected to fail).

​
promptGoal
string | null
required

The test's goal / instructions.

​
promptExamples
string | null
required

The success criteria / examples the evaluator checks against.

​
runShortId
string
required

Short ID of the run this test case belongs to. Use with get_run.

​
projectTestCaseId
string
required

Stable project test case ID. Use with get_test_case_history to see the pass/fail trend.

​
startedAt
string | null
required
​
completedAt
string | null
required
​
durationMs
integer<int32> | null
required

Wall-clock duration in milliseconds, when both timestamps are present.

​
url
string
required

Deep link to the recording and trace in the QA.tech UI. Always works; the media URLs below may be time-limited.

​
screenshotUrl
string | null
required

Best-effort link to the final screenshot. May be a time-limited URL; use url for a durable view.

​
recordingUrl
string | null
required

Best-effort link to the session video recording, if captured. May be a time-limited URL; use url for a durable view.