Sign in
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, without the version (e.g. "googlechrome", "iexplore", "firefox", "safari"). Stable across versions, so it is the field to match on.

browser_versionstring required

Browser version as a string, not a number: it may carry minor/patch components (e.g. "150", "11.4"), and is "0" for environments with no meaningful version.

browser_long_versionstring required

Full version string when known (e.g. "121.0.6167.184"); null otherwise.

browser_display_namestring required

Human-readable label for UIs (e.g. "Chrome 150", "IE11", "Safari 11"), with the device and OS appended on mobile. Presentation only: the format is not stable, so build UI strings from it but never match on it.

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.

Changes