---
title: "List Image Builds"
method: GET
path: "/api/v1/images/builds"
tags: ["Images"]
---

# List Image Builds

`GET /api/v1/images/builds`

List all image builds for the current user.

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

Successful Response

- GenericPaginationResponseListBuildStatusResponse
  - `total_count` integer — Total number of items available in the dataset
  - `offset` integer — Number of items to skip before starting to collect the result set
  - `limit` integer — Maximum number of items to return
  - `data` BuildStatusResponse[], required
    - `id` string, required — Public identifier for the logical build group
    - `imageName` string, required — Name of the image being built
    - `imageTag` string, required — Tag of the image being built
    - `status` 'PENDING' | 'UPLOADING' | 'BUILDING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
    - `createdAt` string, date-time, required — Timestamp when the build was created
    - `startedAt` string, date-time, nullable — Timestamp when the build started
    - `completedAt` string, date-time, nullable — Timestamp when the build completed
    - `artifacts` BuildArtifactStatusResponse[] — Artifact rows associated with this build group
      - `id` string, required — Internal identifier for this artifact build row
      - `artifactType` 'CONTAINER_IMAGE' | 'VM_SANDBOX'
      - `status` 'PENDING' | 'UPLOADING' | 'BUILDING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
      - `fullImagePath` string, nullable — Output reference for this built artifact
      - `errorMessage` string, nullable — Error message if build failed
      - `createdAt` string, date-time, required — Timestamp when the artifact row was created
      - `startedAt` string, date-time, nullable — Timestamp when the artifact row started
      - `completedAt` string, date-time, nullable — Timestamp when the artifact row completed
  - `status` string, nullable — Response status

## Other responses

- `401` — Authorization failed
- `422` — Invalid request data

---

[API](https://skmtc.net/primeintellect/apis/pi-api.md) · [All operations](https://skmtc.net/primeintellect/apis/pi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/primeintellect/pi-api/versions/60efc9b3ff2a/schema)