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

# Api List Builds

`GET /api/v1/build/`

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

---

[API](https://skmtc.net/conda-incubator/apis/conda-store.md) · [All operations](https://skmtc.net/conda-incubator/apis/conda-store/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conda-incubator/conda-store/revisions/1045c7d5b017/schema)