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

# Api Get Build

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

## Request

- The document declares no server URL.
- Auth: none declared

## Path parameters

- `build_id` integer, required

## Response `200`

Successful Response

- APIGetBuild
  - `data` Build, required
    - `build_artifacts` BuildArtifact[], nullable
      - `artifact_type` 'DIRECTORY' | 'LOCKFILE' | 'LOGS' | 'YAML' | 'CONDA_PACK' | 'DOCKER_MANIFEST' | 'CONSTRUCTOR_INSTALLER' | 'CONTAINER_REGISTRY' | 'DOCKER_BLOB', required
      - `id` integer, required
      - `key` string, required
    - `ended_on` string, date-time, nullable
    - `environment_id` integer, required
    - `id` integer, required
    - `packages` CondaPackage[], nullable
      - `channel` CondaChannel, required
        - `id` integer, required
        - `last_update` string, date-time, nullable
        - `name` string, required
      - `id` integer, required
      - `license` string, nullable
      - `name` string, required
      - `summary` string, nullable
      - `version` string, required
    - `scheduled_on` string, date-time, required
    - `size` integer, required
    - `specification` Specification
      - `created_on` string, date-time, required
      - `id` integer, required
      - `name` string, required
      - `sha256` string, required
      - `spec` object, required
    - `started_on` string, date-time, nullable
    - `status` 'QUEUED' | 'BUILDING' | 'COMPLETED' | 'FAILED' | 'CANCELED', required
    - `status_info` string, nullable
  - `message` string, nullable
  - `status` 'ok' | 'error', required

## Other responses

- `422`: Validation Error

## Changes

- **2026-07-17** `1045c7d5b017`: 1 warning
  - added the new `DOCKER_BLOB` enum value to the `data/build_artifacts/anyOf[subschema #1]/items/artifact_type` response property for the response status `200`
- **2024-12-23** `ba409c79449d`: 1 info
  - removed the `DOCKER_BLOB` enum value from the `data/build_artifacts/anyOf[subschema #1]/items/artifact_type` response property for the response status `200`
- **2024-11-26** `da5794d6a672`: 14 breaking, 1 info
  - response property `data/build_artifacts` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/ended_on` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/packages` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/started_on` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - …11 more
- **2024-08-29** `72805cdb69bc`: 2 warning, 1 info
  - added the new `CANCELED` enum value to the `data/status` response property for the response status `200`
  - added the new `CONSTRUCTOR_INSTALLER` enum value to the `data/build_artifacts/items/artifact_type` response property for the response status `200`
  - added the optional property `data/status_info` to the response with the `200` status
- …earlier changes not shown

[Operation history](https://skmtc.dev/conda-incubator/apis/conda-store/changes/api/v1/build/:build_id/get.md)

---

[API](https://skmtc.dev/conda-incubator/apis/conda-store.md) - [All operations](https://skmtc.dev/conda-incubator/apis/conda-store/llms.txt) - [OpenAPI document](https://skmtc.dev/conda-incubator/apis/conda-store/revisions/1045c7d5b017?raw)
