---
title: "Api Get Environment"
method: GET
path: "/api/v1/environment/{namespace}/{environment_name}/"
tags: ["api"]
---

# Api Get Environment

`GET /api/v1/environment/{namespace}/{environment_name}/`

## Request

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

## Path parameters

- `namespace` string, required
- `environment_name` string, required

## Response `200`

Successful Response

- APIGetEnvironment
  - `data` Environment, required
    - `current_build` Build
      - `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
    - `current_build_id` integer, required
    - `description` string, nullable
    - `id` integer, required
    - `name` string, required
    - `namespace` Namespace, required
      - `id` integer, required
      - `metadata_` object, nullable
      - `name` string, required
      - `role_mappings` NamespaceRoleMapping[]
        - `entity` string, required
        - `id` integer, required
        - `role` string, required
  - `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/current_build/anyOf[subschema #1: Build]/build_artifacts/anyOf[subschema #1]/items/artifact_type` response property for the response status `200`
- **2025-02-03** `8238ba689708`: 1 breaking
  - response property `data/namespace/metadata_` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
- **2024-12-23** `ba409c79449d`: 1 info
  - removed the `DOCKER_BLOB` enum value from the `data/current_build/anyOf[subschema #1: Build]/build_artifacts/anyOf[subschema #1]/items/artifact_type` response property for the response status `200`
- **2024-11-26** `da5794d6a672`: 9 breaking, 6 warning, 1 info
  - response property `data/description` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `message` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `data/current_build` response's property type changed from `object` to no type for status `200`
  - the `status` response's property type changed from no type to `string` for status `200`
  - …12 more
- …earlier changes not shown

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