Skip to main content
GET
Get test run status

Authorizations

Authorization
string
header
required

API key authentication using Bearer token format. The CLI's ta auth access tokens are also accepted; because they name a user rather than a workspace, a user in several workspaces selects one with the x-testerarmy-team header (workspace id or slug).

Path Parameters

id
string<uuid>
required

Test run ID

Response

Run details

id
string<uuid>
required

Unique run identifier

type
enum<string>
required

Run type

Available options:
ci,
test,
discovery
status
enum<string>
required

Current run status

Available options:
queued,
running,
completed,
failed,
cancelled
input
object
required

Original request input

createdAt
string<date-time>
required

When the run was created

platform
enum<string> | null

Target platform

Available options:
web,
ios,
android,
null
deviceModel
enum<string> | null

Mobile device the run used (iOS: iphone | ipad). Null for web runs and platforms without device variants.

Available options:
iphone,
ipad,
null
source
enum<string> | null

Run source

Available options:
api,
github_action,
github_app,
scheduled,
webhook,
structured_test,
null
projectId
string<uuid> | null

Linked project ID

output
object

Run output when completed or skipped

testPlan
object | null

Generated test plan (CI runs only)

error
object | null

Error details when failed

durationMs
number | null

Execution time in milliseconds

webhookUrl
string<uri> | null

Webhook delivery URL

webhookStatus
enum<string> | null

Webhook delivery status

Available options:
pending,
delivered,
failed,
null
testId
string<uuid> | null

Linked test ID

stepResults
object[] | null

Step-level results for structured test runs

userName
string | null

Display name of the user who triggered the run

externalRef
object | null

External integration metadata (e.g. GitHub PR/deployment IDs)

executionMode
enum<string> | null

Execution mode used for this run

Available options:
fast,
deep,
null
autoRetryCount
integer | null

Number of times the run was automatically retried after a temporary failure. Failed attempts are not counted toward usage.

startedAt
string<date-time> | null

When execution started

completedAt
string<date-time> | null

When execution finished