REretellai

GET /get-test-run/{test_case_job_id}

Changed on

Get a test case job (test run) by ID

Request

  • Base URL
    https://api.retellai.com
  • Auth
    HTTP bearer

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'pending' | 'in_progress' | 'pass' | 'fail' | 'error' required

Status of the test case job. pending means the run is queued but has not started yet; it becomes in_progress once a worker picks it up, then resolves to pass, fail, or error.

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

  • 6e88894224e1Revision changes
    • warning

      added the new gpt-6.1-terra enum value to the ///// response property for the response status

  • ca41f0dbb297Revision changes
    • breaking

      added subschema #1 subschema #2 to the /////// response property oneOf list for the response status

    • warning

      added the new claude-5-opus enum value to the ///// response property for the response status

    • warning

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

    • warning

      added the new claude-5.5-haiku enum value to the ///// response property for the response status

    • warning

      added the new claude-5.5-opus enum value to the ///// response property for the response status

    • warning

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

    • warning

      added the new gemini-3.5-flash enum value to the ///// response property for the response status

    • warning

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

    • warning

      added the new gemini-3.6-flash enum value to the ///// response property for the response status

    • warning

      added the new gemini-3.7-flash enum value to the ///// response property for the response status

    • warning

      added the new gemini-3.8-flash enum value to the ///// response property for the response status

    • warning

      added the new gemini-4-argon enum value to the ///// response property for the response status

    • warning

      added the new gpt-5.6-luna enum value to the ///// response property for the response status

    • warning

      added the new gpt-5.6-terra enum value to the ///// response property for the response status

    • warning

      added the new gpt-6-astra enum value to the ///// response property for the response status

    • warning

      added the new gpt-6-luna enum value to the ///// response property for the response status

    • warning

      added the new gpt-6-sol enum value to the ///// response property for the response status

    • warning

      added the new gpt-6.1-sol enum value to the ///// response property for the response status

    • warning

      added the new pending enum value to the response property for the response status

    • info

      removed the claude-4.5-sonnet enum value from the ///// response property for the response status

    • info

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

    • info

      removed the gpt-4.1-nano enum value from the ///// response property for the response status

    • info

      removed subschema #1 subschema #2 from the /////// response property oneOf list for the response status