Skip to main content
Returns the current status of a run, or polls until it finishes. Use this when you started a run with qatech run (without --wait) and want to check on it later.

​
Usage

qatech status <run-id> [options]

​
Arguments

ArgumentDescription
<run-id>Run short ID (e.g. UkxK). Returned by qatech run and visible in the dashboard URL.

​
Options

FlagShortDescription
--wait-wPoll until the run completes, then print results
--poll-interval <secs>How often to check status when waiting (default: 5)
--timeout <secs>Max time to wait before giving up (default: 600)
--json-jMachine-readable output
--api-key <key>Per-command API key override
--help-hShow command help

​
Run statuses

StatusMeaning
INITIATEDQueued, not yet executing
RUNNINGTests are running
COMPLETEDAll tests finished - check result for PASSED/FAILED
ERRORRun failed due to an infrastructure error
CANCELLEDRun was cancelled before completion
Exit code is 1 if result is FAILED, 0 otherwise.

​
Examples

# One-shot status check
qatech status UkxK

# Block until finished
qatech status UkxK --wait

# Wait, then get JSON
qatech status UkxK --wait --json

# Just the top-line result
qatech status UkxK -j | jq '.result'

​
JSON output

{
  "shortId": "UkxK",
  "status": "COMPLETED",
  "result": "FAILED",
  "runTestCases": [
    {
      "id": "636a990b-...",
      "shortId": "AbCd",
      "name": "Checkout with saved card",
      "status": "COMPLETED",
      "result": "FAILED",
      "resultTitle": "Card form did not submit",
      "evaluationThought": "..."
    }
  ]
}
Without --wait, the response only includes failed test cases (testCases=failed server-side). With --wait, you get the full set.