QUqualgent
jobs

Get test run status by ID

Changed on

Get detailed status information for a specific test run.

**Path Parameters:**
- `test_run_id`: The unique identifier of the test run

**Returns:**
- Detailed test run information including:
    - Current status and progress
    - Associated test case and application
    - Device information
    - User who initiated the test

**Authorization:**
- Only returns test runs belonging to your organization
- Internal runs (`is_internal`) return 404, like an absent run. The one
  exception is the run's creator when that caller is a superadmin (an FDE
  side run read by the FDE's own agent to file its bug draft).
get/v1/jobs/status/{test_run_id}

Request

Path parameters

test_run_idstring required

Headers

x-api-keystring

Response

Successfully retrieved test run details

idstring required

Test run ID

statusstring required

Test run status

prioritystring required

Test run priority

progressinteger nullable

Test run progress percentage

devicestring nullable

Device name

duration_secondsnumber nullable

Approximate test run duration in seconds (created_at → updated_at or agent-reported).

stepsinteger nullable

Number of agent steps / actions in the run, if recorded.

credits_usednumber nullable

Credits consumed by this test run, if credit tracking is enabled.

cost_usdnumber nullable

Approximate USD cost for this test run, derived from credits_used.

modelstring nullable

Model identifier used for this run (e.g. openai/gpt-5-2025-08-07).

varsobject

Effective variable values for this run (supplied values merged over declared defaults). Empty when the test case had no variables.

resolved_stepsstring[]

Step descriptions after {{name}} substitution — the exact text the agent executed. Empty for runs created before the variables feature shipped.

reported_result'passed' | 'failed' | 'blocked' nullable

Verdict the agent recorded with mobile_report_result, for a DevLoop run whose status stays run_locally (Desktop and cloud-agent runs). Null for every other run and for a DevLoop run with no recorded verdict yet.

Example response

{
  "status": "queued",
  "priority": "low",
  "device": "iPhone 14 Pro",
  "duration_seconds": 123.45,
  "steps": 42,
  "credits_used": 5,
  "cost_usd": 0.0234,
  "model": "openai/gpt-5-2025-08-07",
  "vars": {
    "branch": "feature/login-fix",
    "timeout_seconds": 60
  },
  "resolved_steps": [
    "Tap the codepush build feature/login-fix button",
    "Wait 60s for download"
  ],
  "reported_result": "failed"
}

Changes