Get test run status | TesterArmy

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

{
  "id": "string",
  "type": "ci",
  "status": "queued",
  "input": {},
  "createdAt": "2024-01-15T09:30:00Z",
  "platform": "web",
  "source": "api",
  "projectId": "string",
  "output": {
    "featureName": "string",
    "result": "PASS",
    "description": "string",
    "screenshots": [
      "string"
    ],
    "issues": [
      {
        "name": "string",
        "description": "string",
        "url": "string",
        "type": "issue",
        "severity": 1,
        "reproductionSteps": [
          "string"
        ],
        "expectedBehavior": "string",
        "actualBehavior": "string",
        "screenshotUrl": "string",
        "tMs": 1
      }
    ],
    "steps": [
      {
        "stepIndex": 1,
        "title": "string",
        "status": "passed",
        "type": "act",
        "summary": "string",
        "error": "string",
        "startedAtMs": 1,
        "completedAtMs": 1
      }
    ]
  },
  "testPlan": {
    "instructions": "string",
    "focusAreas": [
      "string"
    ],
    "complexity": "simple",
    "changeType": "frontend",
    "steps": [
      {
        "title": "string",
        "type": "act"
      }
    ]
  },
  "error": {
    "code": "string",
    "message": "string"
  },
  "durationMs": 1.1,
  "webhookUrl": "string",
  "webhookStatus": "pending",
  "testId": "string",
  "stepResults": [
    {}
  ],
  "userName": "string",
  "externalRef": {},
  "executionMode": "fast",
  "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

Allowed values:

statusenum

Current run status

Allowed values:

inputmap from strings to any

Original request input

createdAtdatetime

When the run was created

platformenum or null

Target platform

Allowed values:

sourceenum or null

Run source

projectIdstring or nullformat: "uuid"

Linked project ID

outputobject or null

Test result when completed

testPlanobject or null

Generated test plan (CI runs only)

errorobject or null

Error details when failed

durationMsdouble or null

Execution time in milliseconds

webhookUrlstring or nullformat: "uri"

Webhook delivery URL

webhookStatusenum or null

Webhook delivery status

Allowed values:

testIdstring or nullformat: "uuid"

Linked test ID

stepResultslist of maps from strings to any or null

Step-level results for structured test runs

userNamestring or null

Display name of the user who triggered the run

externalRefmap from strings to any or null

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

executionModeenum or null

Execution mode used for this run

Allowed values:

startedAtdatetime or null

When execution started

completedAtdatetime or null

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