---
title: "List all builds"
method: GET
path: "/builds"
tags: ["builds"]
---

# List all builds

`GET /builds`

List all the Bitrise builds that can be accessed with the authenticated account. Filter builds based on their owner, using the owner slug, or the status of the build.

## Query parameters

- `owner_slug` string
- `is_on_hold` boolean
- `status` integer
- `next` string
- `limit` integer

## Response `200`

OK

- V0BuildListAllResponseModel
  - `data` V0BuildListAllResponseItemModel[]
    - `abort_reason` string
    - `branch` string
    - `build_number` integer
    - `commit_hash` string
    - `commit_message` string
    - `commit_view_url` string
    - `credit_cost` integer
    - `environment_prepare_finished_at` string
    - `finished_at` string
    - `is_on_hold` boolean
    - `is_processed` boolean
    - `machine_type_id` string
    - `original_build_params` object
    - `pull_request_id` integer
    - `pull_request_target_branch` string
    - `pull_request_view_url` string
    - `repository` V0AppResponseItemModel
      - `avatar_url` string
      - `is_disabled` boolean
      - `is_github_checks_enabled` boolean
      - `is_public` boolean
      - `owner` V0OwnerAccountResponseModel
        - `account_type` string
        - `name` string
        - `slug` string
      - `project_id` string
      - `project_type` string
      - `provider` string
      - `repo_owner` string
      - `repo_slug` string
      - `repo_url` string
      - `slug` string
      - `status` integer
      - `title` string
    - `slug` string
    - `stack_identifier` string
    - `started_on_worker_at` string
    - `status` integer
    - `status_text` string
    - `tag` string
    - `triggered_at` string
    - `triggered_by` string
    - `triggered_workflow` string
    - `utility` boolean
  - `paging` V0PagingResponseModel
    - `next` string — Next is the "anchor" for pagination. This value should be passed to the same endpoint to get the next page. Empty/not included if there's no "next" page. Stop paging when there's no "Next" item in the response!
    - `page_item_limit` integer — PageItemLimit - per-page item count. A given page might include less items if there's not enough items. This value is the "max item count per page".
    - `total_item_count` integer — TotalItemCount - total item count, through "all pages"

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/bitrise/apis/bitrise-api.md) · [All operations](https://skmtc.net/bitrise/apis/bitrise-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitrise/bitrise-api/revisions/89468e4a014b/schema)