---
title: "Api List Builds"
method: GET
path: "/api/v1/build/"
tags: ["api"]
---

# Api List Builds

`GET /api/v1/build/`

## Request

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

## Query parameters

- `status` 'QUEUED' | 'BUILDING' | 'COMPLETED' | 'FAILED' | 'CANCELED'
- `packages` string[], nullable
- `artifact` 'DIRECTORY' | 'LOCKFILE' | 'LOGS' | 'YAML' | 'CONDA_PACK' | 'DOCKER_MANIFEST' | 'CONSTRUCTOR_INSTALLER' | 'CONTAINER_REGISTRY' | 'DOCKER_BLOB'
- `environment_id` integer, nullable
- `name` string, nullable
- `namespace` string, nullable
- `page` integer
- `order` string, nullable
- `size` integer, nullable
- `sort_by` string[]

## Response `200`

Successful Response

- APIListBuild
  - `count` integer, required
  - `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
  - `page` integer, required
  - `size` integer, required
  - `status` 'ok' | 'error', required

## Other responses

- `422`: Validation Error

## Changes

- **2026-07-17** `1045c7d5b017`: 1 warning, 1 info
  - added the new `DOCKER_BLOB` enum value to the `data/items/build_artifacts/anyOf[subschema #1]/items/artifact_type` response property for the response status `200`
  - added the enum value `DOCKER_BLOB` to the property `anyOf[subschema #1: BuildArtifactType]/` of the `query` request parameter `artifact`
- **2024-12-23** `ba409c79449d`: 1 breaking, 1 info
  - removed the enum value `DOCKER_BLOB` from the property `anyOf[subschema #1: BuildArtifactType]/` of the `query` request parameter `artifact`
  - removed the `DOCKER_BLOB` enum value from the `data/items/build_artifacts/anyOf[subschema #1]/items/artifact_type` response property for the response status `200`
- **2024-11-26** `da5794d6a672`: 28 breaking, 13 info
  - removed the enum value `BUILDING` from the `query` request parameter `status`
  - removed the enum value `CANCELED` from the `query` request parameter `status`
  - removed the enum value `COMPLETED` from the `query` request parameter `status`
  - removed the enum value `CONDA_PACK` from the `query` request parameter `artifact`
  - …37 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/conda-incubator/apis/conda-store/changes/api/v1/build/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)