---
title: "List Builds"
method: GET
path: "/apps/{app_id}/builds"
tags: ["Builds"]
---

# List Builds

`GET /apps/{app_id}/builds`

## Path parameters

- `app_id` string, required

## Query parameters

- `page` integer
- `per_page` integer
- `branch` string
- `tag` string

## Response `200`

Successful response

- BuildIndex
  - `total_count` integer
  - `current_page` integer
  - `per_page` integer
  - `total_pages` integer
  - `items` Build[]
    - `id` integer
    - `name` string
    - `branch` string
    - `tag` string
    - `aasm_state` string
    - `message` string
    - `created_at` string
    - `started_at` string
    - `total_duration` number
    - `commit_long` string
    - `commit_short` string
    - `commit_date` string
    - `commit_message` string
    - `commit_user` string

## Other responses

- `401` — Unauthorized — missing or invalid credentials
- `404` — Not found

---

[API](https://skmtc.net/release/apis/release-com-platform-api.md) · [All operations](https://skmtc.net/release/apis/release-com-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/release/release-com-platform-api/versions/ef3098ae3d2d/schema)