Get a test case job (test run) by ID

get/get-test-run/{test_case_job_id}

Path parameters

test_case_job_idstring required

ID of the test case job to retrieve

Response

Test case job retrieved successfully

test_case_job_idstring required

Unique identifier for the test case job

status'in_progress' | 'pass' | 'fail' | 'error' required

Status of the test case job

test_case_definition_idstring required

ID of the test case definition used

transcript_snapshotobject nullable

Snapshot of the transcript generated during test execution. Can be either ConversationFlowPlaygroundSnapshot or RetellLlmPlaygroundSnapshot

result_explanationstring nullable

Explanation of the test result

creation_timestampinteger required

Timestamp when the test case job was created (milliseconds since epoch)

user_modified_timestampinteger required

Timestamp when the test case job was last modified (milliseconds since epoch)

Changes

Changed in 7 of the 28 revisions of this API.62

    • removed the gemini-2.5-flash enum value from the ///// response property for the response status

      response-property-enum-value-removed

    • added the new gpt-5.5 enum value to the ///// response property for the response status

      response-property-enum-value-added

    • added the new gemini-3.1-flash-lite enum value to the ///// response property for the response status

      response-property-enum-value-added

    • added the new gpt-5.4-mini enum value to the ///// response property for the response status

      response-property-enum-value-added

    • added the new gpt-5.4-nano enum value to the ///// response property for the response status

      response-property-enum-value-added

    • added the new gpt-5.4 enum value to the ///// response property for the response status

      response-property-enum-value-added

    • added the new claude-4.6-sonnet enum value to the ///// response property for the response status

      response-property-enum-value-added

    • endpoint added

      endpoint-added