---
title: "List builds"
method: GET
path: "/gh/{ownerKeyOrId}/projects/{projectKeyOrId}/builds"
tags: ["Builds"]
---

# List builds

`GET /gh/{ownerKeyOrId}/projects/{projectKeyOrId}/builds`

## Request

- Base URL: `https://api.qlty.sh`
- URL: `https://api.qlty.sh/gh/{ownerKeyOrId}/projects/{projectKeyOrId}/builds`
- Auth: HTTP bearer

Retrieves a Project's Builds, most recently submitted first. Each entry carries a subset of the fields returned when retrieving a single Build. Supports JSON, newline-delimited JSON (`application/x-ndjson`), and CSV (`text/csv`) response formats via the `Accept` header.

## Path parameters

- `ownerKeyOrId` string, required: Repository owner name (login) or workspace ID
- `projectKeyOrId` string, required: Repository name or project ID

## Query parameters

- `page[limit]` integer: Maximum number of items to return (1-100)
- `page[offset]` integer, nullable: Number of items to skip
- `status` union: Filter by build status
  - string[]
  - 'submitted' | 'starting' | 'running' | 'succeeded' | 'failed' | 'skipped' | 'rejected'

## Response `200`

List builds for the project

- BuildList
  - `data` BuildSummary[], required
    - `id` string, required
    - `type` 'analysis' | 'format' | 'ssh' | 'coverage_setup', required
    - `status` 'submitted' | 'starting' | 'running' | 'succeeded' | 'failed' | 'skipped' | 'rejected', required: Most recent status reported for the build
    - `branchName` string, nullable, required
    - `commitSha` string, nullable, required
    - `commitMessage` string, nullable, required
    - `submittedAt` string, date-time, required
    - `finishedAt` string, date-time, nullable, required
    - `queueSeconds` integer, nullable, required
  - `meta` object, required
    - `hasMore` boolean, required: Whether there are more items available beyond this page

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Rate Limit Exceeded
- `500`: Internal Server Error

## Changes

- **2026-09-10** `05ad3b3406e7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/qlty/apis/qlty-api/changes/gh/:ownerKeyOrId/projects/:projectKeyOrId/builds/get.md)

---

[API](https://skmtc.dev/qlty/apis/qlty-api.md) - [All operations](https://skmtc.dev/qlty/apis/qlty-api/llms.txt) - [OpenAPI document](https://skmtc.dev/qlty/apis/qlty-api/revisions/ebb6d6805741?raw)