> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://tester.army/docs/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://tester.army/_mcp/server. # List test runs GET https://tester.army/api/v1/runs List test runs for the authenticated team with optional project/status filtering and cursor pagination. Reference: https://tester.army/docs/api-reference/tester-army-api/test-runs/list-test-runs ## Authentication - `Authorization` header (bearer token, required) — API key authentication using Bearer token format ## Request ### Query parameters - `limit` (string, optional) — Max results per page (default 20, max 100) - `status` (enum, optional) — Filter by status - Allowed values: `queued`, `running`, `completed`, `failed`, `cancelled` - `projectId` (string, optional) — Filter by project ID - `testId` (string, optional) — Filter by test ID - `batchId` (string, optional) — Filter by group-run batch ID - `cursor` (string, optional) — Cursor for pagination ## Response ### 200 List of runs - `runs` (list of object, required) — List of runs - `id` (string, required) — Unique run identifier - `type` (enum, required) — Run type - Allowed values: `ci`, `test` - `status` (enum, required) — Current run status - Allowed values: `queued`, `running`, `completed`, `failed`, `cancelled` - `input` (map from string to any, required) — Original request input - `createdAt` (datetime, required) — When the run was created - `platform` (enum, optional, nullable) — Target platform - Allowed values: `web`, `ios`, `android` - `deviceModel` (enum, optional, nullable) — 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. - Allowed values: `iphone`, `ipad` - `source` (enum, optional, nullable) — Run source - Allowed values: `api`, `github_action`, `github_app`, `scheduled`, `webhook`, `structured_test` - `projectId` (string, optional, nullable) — Linked project ID - `output` (object or object or any, optional) — Run output when completed or skipped - object - `featureName` (string, required) — Name of the feature being tested - `result` (enum, required) — Test result - PASS if no issues found, FAILED if any issues were reported, BLOCKED if an environment/setup problem or an agent automation limit prevented a product verdict - Allowed values: `PASS`, `FAILED`, `BLOCKED` - `description` (string, required) — Short summary of what was tested and the final result; include a compact grouped issue summary only when the user explicitly asks for one - `screenshots` (list of string, required) — Array of screenshot URLs captured during testing - `blockedReason` (object, optional) — Structured explanation, present only when result is BLOCKED - `category` (enum, required) — Why the run was blocked: environment outage, missing seed data, or an agent automation limit - Allowed values: `environment`, `seed_data`, `credentials`, `test_setup`, `automation` - `summary` (string, required) — Plain-language explanation of what blocked the run - `errorCodes` (list of enum, required) — Step error codes that produced the blocked verdict - Allowed values: `AUTH_CREDENTIAL_UNAVAILABLE`, `AUTH_CREDENTIAL_INVALID`, `AUTH_BASIC_REQUIRED`, `VERCEL_BYPASS_REQUIRED`, `ENVIRONMENT_UNAVAILABLE`, `SEED_DATA_MISSING`, `MOBILE_RELEASE_BUILD_REQUIRED`, `VIEWPORT_RESIZE_UNSUPPORTED`, `STEP_TOOL_LIMIT_EXHAUSTED`, `STEP_DEADLINE_EXHAUSTED`, `STEP_NO_CONCLUSION` - `issues` (list of object, optional) — Issues reported during the session via the report_issue tool - `name` (string, required) — Short name of the issue (e.g. 'Login form rejects valid email') - `description` (string, required) — What was tested, what happened, and what was expected - `url` (string, required) — Where the issue happened: the exact page URL on web, or the app identifier and screen on mobile (e.g. com.example.app/login) - `type` (enum, optional, default: issue) — issue = confirmed bug, warning = non-blocking observation - Allowed values: `issue`, `warning` - `severity` (integer, optional) — Issue severity from 1 (minor) to 5 (critical) - `reproductionSteps` (list of string, optional) — Short reproduction steps in execution order - `expectedBehavior` (string, optional) — What should have happened - `actualBehavior` (string, optional) — What actually happened - `screenshotUrl` (string, optional) — Screenshot URL showing the issue - `tMs` (integer, optional) — Milliseconds elapsed since the recording reference time when the issue was reported - `accessibility` (object, optional) — Structured detail present on warnings produced by the automated axe-core accessibility audit - `ruleId` (string, required) — axe-core rule id, e.g. image-alt - `impact` (enum, required) - Allowed values: `minor`, `moderate`, `serious`, `critical` - `helpUrl` (string, required) — Deque University fix-guidance URL - `wcagTags` (list of string, required) — axe rule tags (wcag2a, wcag21aa, ...) - `nodeCount` (integer, required) — Total failing nodes across pages - `urls` (list of string, required) — Pages where the rule failed (bounded sample) - `sampleTargets` (list of string, required) — CSS selector paths to example failing elements (bounded sample) - `pageCount` (integer, optional) — Total distinct pages where the rule failed; `urls` is a bounded sample - `steps` (list of object, optional) — Per-step summaries with timing information - `stepIndex` (integer, required) - `title` (string, required) - `status` (enum, required) - Allowed values: `passed`, `failed` - `type` (enum, optional) - Allowed values: `act`, `assert`, `login`, `files`, `screenshot`, `javascript`, `microphone` - `summary` (string, optional) - `error` (string, optional, nullable) - `errorCode` (enum, optional) - Allowed values: `AUTH_CREDENTIAL_UNAVAILABLE`, `AUTH_CREDENTIAL_INVALID`, `AUTH_BASIC_REQUIRED`, `VERCEL_BYPASS_REQUIRED`, `ENVIRONMENT_UNAVAILABLE`, `SEED_DATA_MISSING`, `MOBILE_RELEASE_BUILD_REQUIRED`, `VIEWPORT_RESIZE_UNSUPPORTED`, `STEP_TOOL_LIMIT_EXHAUSTED`, `STEP_DEADLINE_EXHAUSTED`, `STEP_NO_CONCLUSION` - `startedAtMs` (integer, optional) — Milliseconds elapsed since recording reference when the step started - `completedAtMs` (integer, optional) — Milliseconds elapsed since recording reference when the step completed - `reusableActionTrace` (object, optional) - `version` (enum, required) - Allowed values: `1` - `stepKey` (string, required) - `stepTitle` (string, required) - `actions` (list of object, required) - `order` (integer, required) - `toolName` (string, required) - `summary` (string, required) - `target` (object, optional) - `input` (object, optional) - `confidence` (enum, required) - Allowed values: `medium`, `high` - `stepType` (enum, optional) - Allowed values: `act`, `assert`, `login`, `files`, `screenshot`, `javascript`, `microphone` - `recording` (object, optional) — Pointer to the run's video recording artifact, present on completed runs that captured a recording. The bytes are not fetchable through the public API; use the dashboard or a share link to view the recording. - `storageKey` (string, required) — Internal storage key of the recording artifact - `fileName` (string, required) — Recording file name - `mediaType` (string, required) — Recording media type (video/mp4) - object - `kind` (enum, required) - Allowed values: `planner_skipped` - `reason` (string, required) - `testPlan` (object, optional, nullable) — Generated test plan (CI runs only) - `instructions` (string, required) — Natural language instructions for the QA agent - `focusAreas` (list of string, required) — Focus areas derived from changed files - `complexity` (enum, required) — Estimated test complexity (affects timeout) - Allowed values: `simple`, `moderate`, `complex` - `changeType` (enum, required) — Classify this PR: frontend = UI/component changes, backend = API/DB/service changes with no visible UI effect, mixed = both, infra = CI/config/docs only - Allowed values: `frontend`, `backend`, `mixed`, `infra` - `steps` (list of object or object or object or object, required) — Ordered list of concrete test steps the agent must execute one-by-one - object - `title` (string, required) — Concise description of what to do or verify - `type` (enum, required) — Perform an action - Allowed values: `act` - object - `title` (string, required) — Concise description of what to do or verify - `type` (enum, required) — Verify a condition - Allowed values: `assert` - object - `title` (string, required) — Concise description of the login step - `type` (enum, required) — Authenticate using a credential - Allowed values: `login` - `credentialId` (string, optional) — ID of the credential to use - `temporaryEmail` (boolean, optional) — Set to true to create a temporary email inbox at run time - object - `title` (string, required) — Description of what page state to capture - `type` (enum, required) — Capture visual evidence of the current page state - Allowed values: `screenshot` - `executionConfig` (object, optional) — Pre-run execution configuration selected by the planner. - `viewport` (object, optional) - `width` (integer, required) - `height` (integer, required) - `error` (object, optional, nullable) — Error details when failed - `code` (string, required) — Stable machine-readable error code - `message` (string, required) — Human-readable error message - `stage` (string, optional) — Run lifecycle stage where the error occurred (e.g. provider_acquisition) - `retryable` (boolean, optional) — Whether re-running the test could succeed without changes - `durationMs` (double, optional, nullable) — Execution time in milliseconds - `webhookUrl` (string, optional, nullable) — Webhook delivery URL - `webhookStatus` (enum, optional, nullable) — Webhook delivery status - Allowed values: `pending`, `delivered`, `failed` - `testId` (string, optional, nullable) — Linked test ID - `stepResults` (list of object, optional, nullable) — Step-level results for structured test runs - `stepIndex` (integer, required) — Zero-based index of the saved test step - `status` (enum, required) — Step execution status - Allowed values: `pending`, `running`, `passed`, `failed`, `skipped`, `cancelled` - `startedAt` (string, required, nullable) — ISO timestamp when the step started - `completedAt` (string, required, nullable) — ISO timestamp when the step completed - `error` (string, required, nullable) — Human-readable step failure description - `retried` (boolean, required) — Whether the step was retried - `errorCode` (enum, optional, nullable) — Machine-readable step failure code - Allowed values: `AUTH_CREDENTIAL_UNAVAILABLE`, `AUTH_CREDENTIAL_INVALID`, `AUTH_BASIC_REQUIRED`, `VERCEL_BYPASS_REQUIRED`, `ENVIRONMENT_UNAVAILABLE`, `SEED_DATA_MISSING`, `MOBILE_RELEASE_BUILD_REQUIRED`, `VIEWPORT_RESIZE_UNSUPPORTED`, `STEP_TOOL_LIMIT_EXHAUSTED`, `STEP_DEADLINE_EXHAUSTED`, `STEP_NO_CONCLUSION` - `summary` (string, optional, nullable) — Agent summary of what happened - `startedAtMs` (integer, optional, nullable) — Milliseconds elapsed since recording reference when the step started - `completedAtMs` (integer, optional, nullable) — Milliseconds elapsed since recording reference when the step completed - `userName` (string, optional, nullable) — Display name of the user who triggered the run - `externalRef` (map from string to any, optional, nullable) — External integration metadata (e.g. GitHub PR/deployment IDs) - `executionMode` (enum, optional, nullable) — Execution mode used for this run - Allowed values: `fast`, `deep` - `autoRetryCount` (integer, optional, nullable) — Number of times the run was automatically retried after a temporary failure. Failed attempts are not counted toward usage. - `startedAt` (datetime, optional, nullable) — When execution started - `completedAt` (datetime, optional, nullable) — When execution finished - `nextCursor` (string, optional, nullable) — Cursor for fetching the next page ## Examples **Response** ```json { "runs": [ { "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" } ], "nextCursor": "string" } ``` **SDK Code** ```python import requests url = "https://tester.army/api/v1/runs" headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript const url = 'https://tester.army/api/v1/runs'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://tester.army/api/v1/runs" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://tester.army/api/v1/runs") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://tester.army/api/v1/runs") .header("Authorization", "Bearer ") .asString(); ``` ```php request('GET', 'https://tester.army/api/v1/runs', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://tester.army/api/v1/runs"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://tester.army/api/v1/runs")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```