---
title: "List your Codeless tests"
method: GET
path: "/v1/lab"
tags: ["Codeless tests"]
---

# List your Codeless tests

`GET /v1/lab`

Paginated list of every Codeless test (a.k.a. Lab test) on the account. Codeless tests are recorded in TestingBot's in-browser recorder and can be scheduled on a cron, fired via API, or chained into suites.

## Query parameters

- `offset` integer
- `count` integer

## Response `200`

List your Codeless tests

- TestingbotEntitiesLabTestList — Testingbot_Entities_LabTestList model
  - `data` TestingbotEntitiesLabTest[], required
    - `id` integer, required — Unique numeric Codeless test ID.
    - `name` string, required — Test name.
    - `url` string, required — Target URL the test runs against.
    - `enabled` boolean, required — Whether scheduled runs are active.
    - `cron` string, required — Cron expression for scheduled runs; null if unscheduled.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `last_run` string, date-time, required — Most recent run timestamp.
    - `alerts` TestingbotEntitiesLabAlert[], required — Configured alert destinations.
      - `type` string, required — Alert channel (EMAIL, API, SMS).
      - `value` string, required — Channel value: email address, callback URL, or phone number.
      - `level` string, required — When to send (IMMEDIATELY, DAILY).
    - `browsers` TestingbotEntitiesBrowser[], required — Browsers this test is configured to run on.
      - `selenium_name` string, required — Capability value to send as `browserName` in WebDriver.
      - `name` string, required — Human-readable browser identifier (e.g. "firefox", "iexplore").
      - `version` integer, required — Major version number.
      - `long_version` string, required — Full version string (e.g. "121.0.6167.184").
      - `platform` string, required — Operating system (e.g. "WINDOWS", "MAC", "LINUX").
      - `browser_id` integer, required — Unique TestingBot browser ID used to attach browsers to Codeless tests.
  - `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.

## Other responses

- `401` — Authentication required

---

[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)