## List project builds

`builds().list(BuildListParamsparams = BuildListParams.none(), RequestOptionsrequestOptions = RequestOptions.none()) : BuildListPage`

**get** `/v0/builds`

List user-triggered builds for a given project.

An optional revision can be specified to filter by config commit SHA, or
hashes of file contents.

### Parameters

- `params: BuildListParams`

  - `project: Optional<String>`

    Project name

  - `branch: Optional<String>`

    Branch name

  - `cursor: Optional<String>`

    Pagination cursor from a previous response.

  - `limit: Optional<Double>`

    Maximum number of builds to return, defaults to 10 (maximum: 100).

  - `revision: Optional<Revision>`

    A config commit SHA used for the build

    - `String`

    - `class UnionMember1:`

      Hash of the files used for the build

      - `hash: String`

        File content hash

### Returns

- `class Build:`

  - `id: String`

    Build ID

  - `configCommit: String`

  - `createdAt: LocalDateTime`

  - `documentedSpec: Optional<DocumentedSpec>`

    - `class UnionMember0:`

      - `content: String`

      - `type: Type`

        - `CONTENT("content")`

    - `class UnionMember1:`

      - `expires: LocalDateTime`

      - `type: Type`

        - `URL("url")`

      - `url: String`

  - `object_: Object`

    - `BUILD("build")`

  - `org: String`

  - `project: String`

  - `targets: Targets`

    - `cli: Optional<BuildTarget>`

      - `commit: Commit`

        - `JsonValue;`

          - `status: JsonValue; "not_started"constant`

            - `NOT_STARTED("not_started")`

        - `JsonValue;`

          - `status: JsonValue; "queued"constant`

            - `QUEUED("queued")`

        - `JsonValue;`

          - `status: JsonValue; "in_progress"constant`

            - `IN_PROGRESS("in_progress")`

        - `class Completed:`

          - `commit: Optional<Commit>`

            - `repo: Repo`

              - `branch: String`

              - `host: String`

              - `name: String`

              - `owner: String`

            - `sha: String`

            - `stats: Optional<Stats>`

              - `additions: Long`

              - `deletions: Long`

              - `total: Long`

            - `treeOid: Optional<String>`

          - `completed: InnerCompleted`

            deprecated

            - `commit: Optional<Commit>`

            - `completedAt: LocalDateTime`

            - `conclusion: Conclusion`

              - `ERROR("error")`

              - `WARNING("warning")`

              - `NOTE("note")`

              - `SUCCESS("success")`

              - `MERGE_CONFLICT("merge_conflict")`

              - `UPSTREAM_MERGE_CONFLICT("upstream_merge_conflict")`

              - `FATAL("fatal")`

              - `PAYMENT_REQUIRED("payment_required")`

              - `CANCELLED("cancelled")`

              - `TIMED_OUT("timed_out")`

              - `NOOP("noop")`

              - `VERSION_BUMP("version_bump")`

            - `mergeConflictPr: Optional<MergeConflictPr>`

              - `number: Double`

              - `repo: Repo`

                - `host: String`

                - `name: String`

                - `owner: String`

          - `completedAt: LocalDateTime`

          - `conclusion: Conclusion`

            - `ERROR("error")`

            - `WARNING("warning")`

            - `NOTE("note")`

            - `SUCCESS("success")`

            - `MERGE_CONFLICT("merge_conflict")`

            - `UPSTREAM_MERGE_CONFLICT("upstream_merge_conflict")`

            - `FATAL("fatal")`

            - `PAYMENT_REQUIRED("payment_required")`

            - `CANCELLED("cancelled")`

            - `TIMED_OUT("timed_out")`

            - `NOOP("noop")`

            - `VERSION_BUMP("version_bump")`

          - `mergeConflictPr: Optional<MergeConflictPr>`

            - `number: Double`

            - `repo: Repo`

              - `host: String`

              - `name: String`

              - `owner: String`

          - `status: JsonValue; "completed"constant`

            - `COMPLETED("completed")`

      - `installUrl: Optional<String>`

      - `object_: Object`

        - `BUILD_TARGET("build_target")`

      - `status: Status`

        - `NOT_STARTED("not_started")`

        - `CODEGEN("codegen")`

        - `POSTGEN("postgen")`

        - `COMPLETED("completed")`

      - `build: Optional<CheckStep>`

        - `JsonValue;`

          - `status: JsonValue; "not_started"constant`

            - `NOT_STARTED("not_started")`

        - `Queued`

          - `status: JsonValue; "queued"constant`

            - `QUEUED("queued")`

          - `url: Optional<String>`

        - `InProgress`

          - `status: JsonValue; "in_progress"constant`

            - `IN_PROGRESS("in_progress")`

          - `url: Optional<String>`

        - `Completed`

          - `completed: InnerCompleted`

            deprecated

            - `conclusion: Conclusion`

              - `SUCCESS("success")`

              - `FAILURE("failure")`

              - `SKIPPED("skipped")`

              - `CANCELLED("cancelled")`

              - `ACTION_REQUIRED("action_required")`

              - `NEUTRAL("neutral")`

              - `TIMED_OUT("timed_out")`

            - `url: Optional<String>`

          - `conclusion: Conclusion`

            - `SUCCESS("success")`

            - `FAILURE("failure")`

            - `SKIPPED("skipped")`

            - `CANCELLED("cancelled")`

            - `ACTION_REQUIRED("action_required")`

            - `NEUTRAL("neutral")`

            - `TIMED_OUT("timed_out")`

          - `status: JsonValue; "completed"constant`

            - `COMPLETED("completed")`

          - `url: Optional<String>`

      - `lint: Optional<CheckStep>`

      - `test: Optional<CheckStep>`

    - `csharp: Optional<BuildTarget>`

    - `go: Optional<BuildTarget>`

    - `java: Optional<BuildTarget>`

    - `kotlin: Optional<BuildTarget>`

    - `node: Optional<BuildTarget>`

    - `openAPI: Optional<BuildTarget>`

    - `php: Optional<BuildTarget>`

    - `python: Optional<BuildTarget>`

    - `ruby: Optional<BuildTarget>`

    - `sql: Optional<BuildTarget>`

    - `terraform: Optional<BuildTarget>`

    - `typescript: Optional<BuildTarget>`

  - `updatedAt: LocalDateTime`

### Example

```kotlin
package com.configure_me_stainless_v0.api.example

import com.configure_me_stainless_v0.api.client.StainlessClient
import com.configure_me_stainless_v0.api.client.okhttp.StainlessOkHttpClient
import com.configure_me_stainless_v0.api.models.builds.BuildListPage
import com.configure_me_stainless_v0.api.models.builds.BuildListParams

fun main() {
    val client: StainlessClient = StainlessOkHttpClient.builder()
        .fromEnv()
        .project("example-project")
        .build()

    val page: BuildListPage = client.builds().list()
}
```

#### Response

```json
{
  "data": [
    {
      "id": "id",
      "config_commit": "config_commit",
      "created_at": "2019-12-27T18:11:19.117Z",
      "documented_spec": {
        "content": "content",
        "type": "content"
      },
      "object": "build",
      "org": "org",
      "project": "project",
      "targets": {
        "cli": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "csharp": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "go": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "java": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "kotlin": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "node": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "openapi": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "php": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "python": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "ruby": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "sql": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "terraform": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        },
        "typescript": {
          "commit": {
            "status": "not_started"
          },
          "install_url": "install_url",
          "object": "build_target",
          "status": "not_started",
          "build": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "test": {
            "status": "not_started"
          }
        }
      },
      "updated_at": "2019-12-27T18:11:19.117Z"
    }
  ],
  "has_more": true,
  "next_cursor": "next_cursor"
}
```