---
title: "Get Build Status"
method: GET
path: "/api/v1/images/build/{build_id}"
tags: ["Images"]
---

# Get Build Status

`GET /api/v1/images/build/{build_id}`

Get the status of an image build.

## Path parameters

- `build_id` string, required

## Response `200`

Successful Response

- BuildStatusResponse — Response model for a logical build group.
  - `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

## 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)