---
title: "List builds for a project"
method: GET
path: "/v0/builds"
---

# List builds for a project

`GET /v0/builds`

## Query parameters

- `project` string, required — Project name
- `branch` string — Branch name
- `revision` union
  - string — A config commit SHA used for the build
  - object — Hash of the files used for the build
- `cursor` string — Pagination cursor from a previous response
- `limit` number — Maximum number of builds to return, defaults to 10 (maximum: 100)

## Response `200`

success

- object
  - `data` BuildObject[], required
    - `object` 'build', required
    - `id` string, required
    - `updated_at` string, date-time, required
    - `created_at` string, date-time, required
    - `project` string, required
    - `org` string, required
    - `config_commit` string, required
    - `documented_spec` union, required
      - object
        - `type` 'content', required
        - `content` string, required
      - object
        - `type` 'url', required
        - `url` string, required
        - `expires` string, date-time, required
    - `targets` object, required
      - `node` BuildTarget
        - `object` 'build_target', required
        - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
        - `commit` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `lint` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `test` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `build` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `install_url` string, nullable, required
      - `typescript` BuildTarget
        - `object` 'build_target', required
        - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
        - `commit` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `lint` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `test` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `build` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `install_url` string, nullable, required
      - `python` BuildTarget
        - `object` 'build_target', required
        - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
        - `commit` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `lint` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `test` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `build` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `install_url` string, nullable, required
      - `go` BuildTarget
        - `object` 'build_target', required
        - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
        - `commit` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `lint` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `test` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `build` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `install_url` string, nullable, required
      - `java` BuildTarget
        - `object` 'build_target', required
        - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
        - `commit` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `lint` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `test` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `build` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `install_url` string, nullable, required
      - `kotlin` BuildTarget
        - `object` 'build_target', required
        - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
        - `commit` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `lint` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `test` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `build` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `install_url` string, nullable, required
      - `ruby` BuildTarget
        - `object` 'build_target', required
        - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
        - `commit` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `lint` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `test` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `build` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `install_url` string, nullable, required
      - `terraform` BuildTarget
        - `object` 'build_target', required
        - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
        - `commit` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `lint` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `test` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `build` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `install_url` string, nullable, required
      - `cli` BuildTarget
        - `object` 'build_target', required
        - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
        - `commit` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `lint` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `test` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `build` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `install_url` string, nullable, required
      - `php` BuildTarget
        - `object` 'build_target', required
        - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
        - `commit` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `lint` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `test` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `build` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `install_url` string, nullable, required
      - `csharp` BuildTarget
        - `object` 'build_target', required
        - `status` 'not_started' | 'codegen' | 'postgen' | 'completed', required
        - `commit` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `lint` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `test` union, required
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `build` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
        - `install_url` string, nullable, required
  - `has_more` boolean, required
  - `next_cursor` string

## Changes

- **2025-08-12** `c9dbcee416d3` — 44 breaking, 11 warning, 365 info
  - added `#/components/schemas/Commit, subschema #2` to the `data/items/targets/cli/commit/oneOf[subschema #4]/completed/commit` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/Commit, subschema #2` to the `data/items/targets/csharp/commit/oneOf[subschema #4]/completed/commit` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/Commit, subschema #2` to the `data/items/targets/go/commit/oneOf[subschema #4]/completed/commit` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/Commit, subschema #2` to the `data/items/targets/java/commit/oneOf[subschema #4]/completed/commit` response property `oneOf` list for the response status `200`
  - …416 more
- **2025-07-07** `f8b160dfac6c` — 45 info
  - added the required property `data/items/documented_spec/oneOf[subschema #2]/expires` to the response with the `200` status
  - added the required property `data/items/targets/cli/build/oneOf[subschema #4]/completed/url` to the response with the `200` status
  - added the required property `data/items/targets/cli/lint/oneOf[subschema #4]/completed/url` to the response with the `200` status
  - added the required property `data/items/targets/cli/test/oneOf[subschema #4]/completed/url` to the response with the `200` status
  - …41 more

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

---

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