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

# Api Get Namespace

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

## Request

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

## Path parameters

- `namespace` string, required

## Response `200`

Successful Response

- APIGetNamespace
  - `data` 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

- **2025-02-03** `8238ba689708`: 1 breaking
  - response property `data/metadata_` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
- **2024-11-26** `da5794d6a672`: 2 breaking
  - response property `message` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `status` response's property type changed from no type to `string` for status `200`
- **2024-03-15** `6642d3ed3fab`: 1 breaking, 2 info
  - the `status` response's property type changed from `string` to no type for status `200`
  - response property `data/metadata_` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `message` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`

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