Skip to main content
GET
/
test_run
/
{test_run_id}
Get Test Run
curl --request GET \
  --url https://api.docketqa.com/test_run/{test_run_id} \
  --header 'X-API-KEY: <api-key>'
{
  "test_run": {
    "id": 123,
    "status": "<string>",
    "test_blueprint_id": 123,
    "test_group_run_id": 123,
    "blueprint_metadata": {},
    "results": [
      {
        "step_number": 123,
        "task": "<string>",
        "is_successful": true,
        "result": "<string>",
        "duration": 123,
        "actions": [
          {}
        ]
      }
    ],
    "test_video_url": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>"
  }
}
Retrieve the details and results of a specific test run. Use this to poll for results after triggering a run.
​
test_run_id
integer
required
The ID of the test run to retrieve (returned from the Run Test endpoint).
​
test_run
object
The test run object with full results.

​
Example response

{
  "test_run": {
    "id": 38,
    "status": "failed",
    "test_blueprint_id": 180,
    "test_group_run_id": 35,
    "blueprint_metadata": {
      "id": 180,
      "title": "Login Flow",
      "type": "integration",
      "starting_url": "https://example.com/login",
      "steps": [
        {
          "action": "Enter 'user@example.com' in the email field",
          "step_number": 1,
          "type": "act"
        },
        {
          "action": "Enter 'password123' in the password field",
          "step_number": 2,
          "type": "act"
        }
      ]
    },
    "results": [
      {
        "step_number": 1,
        "task": "Enter 'user@example.com' in the email field",
        "is_successful": false,
        "result": "The agent could not complete the objective because no email field was present on the page.",
        "duration": 43,
        "actions": [
          {
            "description": "Action: extract content with goal='Find any input fields'",
            "type": "extract_content",
            "screenshot_url": "https://..."
          }
        ]
      },
      {
        "step_number": 2,
        "task": "Enter 'password123' in the password field",
        "is_successful": false,
        "result": "Step not completed",
        "duration": 0,
        "actions": []
      }
    ],
    "test_video_url": "https://...",
    "created_at": "2025-07-03T01:38:03.032648+00:00",
    "updated_at": "2025-07-03T01:40:05.043914+00:00"
  }
}