---
title: "Get a build"
method: GET
path: "/gh/{ownerKeyOrId}/projects/{projectKeyOrId}/builds/{buildId}"
tags: ["Builds"]
---

# Get a build

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

## Request

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

Retrieves details about a specific Build

## Path parameters

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

## Response `200`

Retrieve the build

- Build
  - `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
  - `statusReason` string, nullable, required: Explanation for the current status, when one was reported
  - `conclusion` 'succeeded' | 'failed', nullable, required: Terminal outcome, or null while the build is unfinished
  - `exitCode` integer, nullable, required
  - `source` string, nullable, required
  - `pullRequestNumber` integer, nullable, required
  - `committerLogin` string, nullable, required
  - `startedAt` string, date-time, nullable, required
  - `executionSeconds` integer, nullable, required

## 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/:buildId/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)