v1

latestSwagger 2.02026-08-06114111152.5 KB

Tests

Get a specific test

Returns the full detail record for a single test session: status, environment (browser/OS or device/platform), assets (video, logs, screenshots), groups, build, and duration. Accepts either the numeric test ID or the WebDriver session_id.

get/v1/tests/{id}

Path parameters

idstring required

Numeric test ID or WebDriver session_id (UUID).

Query parameters

skip_fieldsstring

Comma-separated fields to omit from the response (logs, thumbs, visual_run, groups).

Response

Get a specific test

idinteger required

Unique numeric test ID.

session_idstring required

Selenium / WebDriver session ID (UUID).

namestring required

Human-readable test name set via capabilities or update_test.

statestring required

Lifecycle state (RUNNING, COMPLETE, TIMEOUT, …).

successboolean required

Whether the test passed.

status_idinteger required

Numeric status code (0=fail, 1=pass, 2=unknown).

unknownboolean required

Convenience flag, true when status_id is 2 (the test finished without reporting a pass/fail).

status_messagestring required

Failure reason or arbitrary status set via test[status_message].

created_atstring date-time required

When the test session started.

completed_atstring date-time required

When the session ended; null while running.

durationinteger required

Total run time in seconds.

browserstring required

Browser identifier (e.g. "iexplore", "firefox").

browser_versioninteger required

Browser major version.

osstring required

OS (e.g. "WINDOWS", "MAC").

device_namestring required

Mobile device name when the session ran on a physical device; null otherwise.

platform_namestring required

Mobile OS name; null on desktop.

buildstring required

Build identifier (free-form string set via capabilities).

groupsstring[] required

Tag/group names attached to the test.

videostring required

Signed S3 URL to the recorded video, or false if video was disabled.

thumbsstring[] required

Signed S3 URLs to screenshot thumbnails.

logsobject required

Map of log names → signed S3 URLs (selenium, browser, …).

assets_availableboolean required

Whether assets (video, logs, screenshots) have finished processing.

extrastring required

Arbitrary metadata string set via test[extra].

typestring required

Driver type (WEBDRIVER, APPIUM).

stepsstring required

Rendered HTML of the recorded step list. Omit with skip_fields=steps.

runninginteger required

Completion percentage. Only present while a Codeless test is still running.