---
title: "Api List Namespaces"
method: GET
path: "/api/v1/namespace/"
tags: ["api"]
---

# Api List Namespaces

`GET /api/v1/namespace/`

## Request

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

## Query parameters

- `page` integer
- `order` string, nullable
- `size` integer, nullable
- `sort_by` string[]

## Response `200`

Successful Response

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

## Other responses

- `422`: Validation Error

## Changes

- **2025-02-03** `8238ba689708`: 1 breaking
  - response property `data/items/metadata_` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
- **2024-11-26** `da5794d6a672`: 2 breaking, 4 info
  - 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`
  - `query` request parameter `order` list-of-types was widened by adding types `null`
  - `query` request parameter `size` list-of-types was widened by adding types `null`
  - …2 more
- **2024-03-15** `6642d3ed3fab`: 4 breaking, 3 info
  - `query` request parameter `order` list-of-types was narrowed by removing types `null`
  - `query` request parameter `size` list-of-types was narrowed by removing types `null`
  - for the `query` request parameter `size`, the type changed from no type to `integer`
  - the `status` response's property type changed from `string` to no type for status `200`
  - …3 more

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