---
title: "Get tests for a build"
method: GET
path: "/v1/builds/*id"
tags: ["Builds"]
---

# Get tests for a build

`GET /v1/builds/*id`

Returns all test cases that belong to a single build, with pagination. The build can be referenced by either its numeric internal ID or the string identifier you set via `capabilities.build`.

## Query parameters

- `id` string, required
- `offset` integer
- `count` integer
- `skip_fields` string

## Response `200`

Get tests for a build

- TestingbotEntitiesTestCaseList — Testingbot_Entities_TestCaseList model
  - `data` TestingbotEntitiesTestCase[], required — Test sessions for this page.
    - `id` integer, required — Unique numeric test ID.
    - `session_id` string, required — Selenium / WebDriver session ID (UUID).
    - `name` string, required — Human-readable test name set via capabilities or `update_test`.
    - `state` string, required — Lifecycle state (RUNNING, COMPLETE, TIMEOUT, …).
    - `success` boolean, required — Whether the test passed.
    - `status_id` integer, required — Numeric status code (0=fail, 1=pass, 2=unknown).
    - `unknown` boolean, required — Convenience flag, true when `status_id` is 2 (the test finished without reporting a pass/fail).
    - `status_message` string, required — Failure reason or arbitrary status set via `test[status_message]`.
    - `created_at` string, date-time, required — When the test session started.
    - `completed_at` string, date-time, required — When the session ended; null while running.
    - `duration` integer, required — Total run time in seconds.
    - `browser` string, required — Browser identifier (e.g. "iexplore", "firefox").
    - `browser_version` integer, required — Browser major version.
    - `os` string, required — OS (e.g. "WINDOWS", "MAC").
    - `device_name` string, required — Mobile device name when the session ran on a physical device; null otherwise.
    - `platform_name` string, required — Mobile OS name; null on desktop.
    - `build` string, required — Build identifier (free-form string set via capabilities).
    - `groups` string[], required — Tag/group names attached to the test.
    - `video` string, required — Signed S3 URL to the recorded video, or false if video was disabled.
    - `thumbs` string[], required — Signed S3 URLs to screenshot thumbnails.
    - `logs` object, required — Map of log names → signed S3 URLs (selenium, browser, …).
    - `assets_available` boolean, required — Whether assets (video, logs, screenshots) have finished processing.
    - `extra` string, required — Arbitrary metadata string set via `test[extra]`.
    - `type` string, required — Driver type (WEBDRIVER, APPIUM).
    - `steps` string, required — Rendered HTML of the recorded step list. Omit with `skip_fields=steps`.
    - `running` integer, required — Completion percentage. Only present while a Codeless test is still running.
  - `meta` TestingbotEntitiesMeta, required
    - `offset` integer, required — Number of items skipped from the start of the result set.
    - `count` integer, required — Items returned in this page (matches the requested `count` query param).
    - `total` integer, required — Total number of items available across all pages.
  - `realtime` object, required — ActionCable channel details for live updates. Only present on the `since`-polling form of this endpoint.

## Other responses

- `401` — Authentication required
- `404` — Build not found

---

[API](https://skmtc.net/testingbot/apis/testingbot-rest-api.md) · [All operations](https://skmtc.net/testingbot/apis/testingbot-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/testingbot/testingbot-rest-api/versions/eff607a49246/schema)