---
title: "List all builds of an app"
method: GET
path: "/apps/{app-slug}/builds"
tags: ["builds"]
---

# List all builds of an app

`GET /apps/{app-slug}/builds`

List all the builds of a specified Bitrise app. Set parameters to filter builds: for example, you can search for builds run with a given workflow or all builds that were triggered by Pull Requests. It returns all the relevant data of the build.

## Path parameters

- `app-slug` string, required

## Query parameters

- `sort_by` 'running_first' | 'created_at'
- `branch` string
- `workflow` string
- `commit_message` string
- `trigger_event_type` string
- `pull_request_id` integer
- `build_number` integer
- `after` integer
- `before` integer
- `status` integer
- `is_pipeline_build` boolean
- `next` string
- `limit` integer

## Response `200`

OK

- V0BuildListResponseModel
  - `data` V0BuildResponseItemModel[]
    - `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
    - `is_status_sent` boolean
    - `log_format` string
    - `machine_type_id` string
    - `original_build_params` object
    - `pipeline_workflow_id` string
    - `pull_request_id` integer
    - `pull_request_target_branch` string
    - `pull_request_view_url` string
    - `rebuildable` boolean
    - `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/versions/89468e4a014b/schema)