---
title: "List builds"
method: GET
path: "/v1/builds"
---

# List builds

`GET /v1/builds`

Retrieve a list of builds for a project

## Query parameters

- `project` string, required
- `spec_hash` string
- `config_hash` string
- `branch` string
- `limit` integer

## Response `200`

Successful response

- BuildResponse[]
  - `id` string, required
  - `targets` SupportedTarget[], required

## Other responses

- `401` — Unauthorized
- `404` — Project not found

## Changes

- **2025-01-17** `2a7bd26881d5` — 1 info
  - added the required property `items/targets` to the response with the `200` status
- **2025-01-16** `cc7f1786eda1` — 1 info
  - added the new optional `query` request parameter `branch`
- **2025-01-14** `e59327cb205b` — 1 info
  - endpoint added
- **2025-01-14** `91fceb4b1347` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/stainless-api/apis/builds-api/changes/v1/builds/get.md)

---

[API](https://skmtc.dev/stainless-api/apis/builds-api.md) · [All operations](https://skmtc.dev/stainless-api/apis/builds-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stainless-api/builds-api/revisions/efd1aba15824/schema)