Builds

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.

get/gh/{ownerKeyOrId}/projects/{projectKeyOrId}/builds

Request

  • Base URL
    https://api.qlty.sh
  • Auth
    HTTP bearer

Path parameters

ownerKeyOrIdstring required

Repository owner name (login) or workspace ID

Example:acme-corp
projectKeyOrIdstring required

Repository name or project ID

Example:my-repo

Query parameters

page[limit]integer

Maximum number of items to return (1-100)

Example:20
page[offset]integer nullable

Number of items to skip

string[]
OR
'submitted' | 'starting' | 'running' | 'succeeded' | 'failed' | 'skipped' | 'rejected'

Response

List builds for the project

Example response

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "analysis",
      "status": "succeeded",
      "branchName": "main",
      "commitSha": "9c9a4c4a1e6bb01b2fbd7f5e1c0b4a2d3e5f6a7b",
      "commitMessage": "Fix the bug",
      "submittedAt": "2026-01-01T12:00:00Z",
      "finishedAt": "2026-01-01T12:01:35Z",
      "queueSeconds": 5
    }
  ],
  "meta": {
    "hasMore": true
  }
}

Changes