---
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
    - `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
    - `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
              - …
        - `upload` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, 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
              - …
        - `upload` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, 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
              - …
        - `upload` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, 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
              - …
        - `upload` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, 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
              - …
        - `upload` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, 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
              - …
        - `upload` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, 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
              - …
        - `upload` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, 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
              - …
        - `upload` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, 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
              - …
        - `upload` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, 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
              - …
        - `upload` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, 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
              - …
        - `upload` union
          - object
            - `status` 'not_started', required
          - object
            - `status` 'queued', required
          - object
            - `status` 'in_progress', required
          - object
            - `status` 'completed', required
            - `completed` object, required
              - …
  - `has_more` boolean, required
  - `next_cursor` string

---

[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/0eed0c3c47bb/schema)