Get test run status | TesterArmy: Documentation

{
  "id": "string",
  "type": "ci",
  "status": "queued",
  "input": {},
  "createdAt": "2024-01-15T09:30:00Z",
  "platform": "web",
  "deviceModel": "iphone",
  "source": "api",
  "projectId": "string",
  "output": {
    "featureName": "string",
    "result": "PASS",
    "blockedReason": {
      "category": "environment",
      "summary": "string",
      "errorCodes": [
        "AUTH_CREDENTIAL_UNAVAILABLE"
      ]
    },
    "description": "string",
    "issues": [
      {
        "type": "issue",
        "name": "string",
        "description": "string",
        "url": "string",
        "severity": 1,
        "reproductionSteps": [
          "string"
        ],
        "expectedBehavior": "string",
        "actualBehavior": "string",
        "screenshotUrl": "string",
        "tMs": 1,
        "accessibility": {
          "ruleId": "string",
          "impact": "minor",
          "helpUrl": "string",
          "wcagTags": [
            "string"
          ],
          "nodeCount": 1,
          "pageCount": 1,
          "urls": [
            "string"
          ],
          "sampleTargets": [
            "string"
          ]
        }
      }
    ],
    "screenshots": [
      "string"
    ],
    "steps": [
      {
        "stepIndex": 1,
        "title": "string",
        "type": "act",
        "status": "passed",
        "summary": "string",
        "error": "string",
        "errorCode": "AUTH_CREDENTIAL_UNAVAILABLE",
        "startedAtMs": 1,
        "completedAtMs": 1,
        "reusableActionTrace": {
          "version": 1,
          "stepKey": "string",
          "stepTitle": "string",
          "stepType": "act",
          "actions": [
            {
              "order": 1,
              "toolName": "string",
              "summary": "string",
              "target": {
                "kind": "role",
                "role": "string",
                "name": "string",
                "nth": 1,
                "selector": "string",
                "element": "string"
              },
              "input": {
                "url": "string",
                "field": "username",
                "option": "string",
                "key": "string",
                "direction": "up",
                "amount": 1,
                "focused": true,
                "sequentially": true
              }
            }
          ],
          "confidence": "medium"
        }
      }
    ],
    "recording": {
      "storageKey": "string",
      "fileName": "string",
      "mediaType": "string"
    }
  },
  "testPlan": {
    "instructions": "string",
    "focusAreas": [
      "string"
    ],
    "complexity": "simple",
    "changeType": "frontend",
    "steps": [
      {
        "title": "string",
        "type": "act"
      }
    ],
    "executionConfig": {
      "viewport": {
        "width": 1,
        "height": 1
      }
    }
  },
  "error": {
    "code": "string",
    "message": "string",
    "stage": "string",
    "retryable": true
  },
  "durationMs": 1.1,
  "webhookUrl": "string",
  "webhookStatus": "pending",
  "testId": "string",
  "stepResults": [
    {
      "stepIndex": 1,
      "status": "pending",
      "startedAt": "string",
      "completedAt": "string",
      "error": "string",
      "retried": true,
      "errorCode": "AUTH_CREDENTIAL_UNAVAILABLE",
      "summary": "string",
      "startedAtMs": 1,
      "completedAtMs": 1
    }
  ],
  "userName": "string",
  "externalRef": {},
  "executionMode": "fast",
  "autoRetryCount": 1,
  "startedAt": "2024-01-15T09:30:00Z",
  "completedAt": "2024-01-15T09:30:00Z"
}

Retrieve the current status and result of a test run. Poll this endpoint to check for completion.

Authentication

AuthorizationBearer

API key authentication using Bearer token format

Path parameters

idstringRequiredformat: "uuid"

Test run ID

Response

Run details

idstringformat: "uuid"

Unique run identifier

typeenum

Run type

statusenum

Current run status

inputmap from strings to any

Original request input

createdAtdatetime

When the run was created

platformenum or nullOptional

Target platform

deviceModelenum or nullOptional

Non-default mobile device variant within the run platform (e.g. ipad on iOS). Null means the platform default phone-sized device; explicitly requested defaults are stored as null.

sourceenum or nullOptional

Run source

projectIdstring or nullOptionalformat: "uuid"

Linked project ID

outputobject or anyOptional

Run output when completed or skipped

testPlanobject or nullOptional

Generated test plan (CI runs only)

errorobject or nullOptional

Error details when failed

durationMsdouble or nullOptional

Execution time in milliseconds

webhookUrlstring or nullOptionalformat: "uri"

Webhook delivery URL

webhookStatusenum or nullOptional

Webhook delivery status

testIdstring or nullOptionalformat: "uuid"

Linked test ID

stepResultslist of objects or nullOptional

Step-level results for structured test runs

userNamestring or nullOptional

Display name of the user who triggered the run

externalRefmap from strings to any or nullOptional

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

executionModeenum or nullOptional

Execution mode used for this run

autoRetryCountinteger or nullOptional

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

startedAtdatetime or nullOptional

When execution started

completedAtdatetime or nullOptional

When execution finished

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

504

Gateway Timeout Error

$	curl https://tester.army/api/v1/runs/id \
>	-H "Authorization: Bearer <token>"