---
title: "List your builds"
method: GET
path: "/v1/builds"
tags: ["Builds"]
---

# List your builds

`GET /v1/builds`

Returns a paginated list of test builds. A build is an aggregation of test cases that share the same `capabilities.build` identifier, useful for grouping CI runs.

## Query parameters

- `offset` integer
- `count` integer

## Response `200`

List your builds

- TestingbotEntitiesBuildList — Testingbot_Entities_BuildList model
  - `data` TestingbotEntitiesBuild[], required — Builds for this page.
    - `id` integer, required — Unique numeric build ID.
    - `build_identifier` string, required — User-supplied build identifier (capabilities.build).
    - `created_at` string, date-time, required — When the first test in the build started.
    - `updated_at` string, date-time, required — When the build was last touched by a test.
  - `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/revisions/eff607a49246/schema)