> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moorcheh.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# moorcheh namespace-list

> List all namespaces with item counts.

## Overview

Lists every namespace on this Moorcheh instance with type, item count, vector dimension, and created time. Prints JSON to stdout.

## Synopsis

```bash theme={null}
moorcheh namespace-list [--base-url URL]
```

## Options

| Flag         | Default                 | Description           |
| ------------ | ----------------------- | --------------------- |
| `--base-url` | `http://localhost:8080` | Moorcheh API base URL |

## Examples

```bash theme={null}
moorcheh namespace-list

moorcheh namespace-list --base-url http://localhost:8081
```

## Output

Prints JSON from `GET /namespaces`:

<ResponseField name="namespaces" type="array">
  List of namespace objects. Empty array when no namespaces exist.
</ResponseField>

<ResponseField name="namespaces[].namespace_name" type="string">
  Unique namespace name.
</ResponseField>

<ResponseField name="namespaces[].type" type="string">
  `"text"` or `"vector"`.
</ResponseField>

<ResponseField name="namespaces[].vector_dimension" type="number | null">
  Vector dimension for vector namespaces; `null` for text.
</ResponseField>

<ResponseField name="namespaces[].item_count" type="number">
  Number of items stored in the namespace.
</ResponseField>

<ResponseField name="namespaces[].created_at" type="string">
  ISO 8601 UTC timestamp when the namespace was created.
</ResponseField>

<ResponseField name="status" type="string">
  `"failure"` on server error (500).
</ResponseField>

<ResponseField name="message" type="string">
  Error description on failure.
</ResponseField>

```json Example output theme={null}
{
  "namespaces": [
    {
      "namespace_name": "my-documents",
      "type": "text",
      "vector_dimension": null,
      "item_count": 42,
      "created_at": "2026-05-21T12:00:00.000Z"
    },
    {
      "namespace_name": "my-embeddings",
      "type": "vector",
      "vector_dimension": 768,
      "item_count": 10,
      "created_at": "2026-05-21T12:05:00.000Z"
    }
  ]
}
```

## Exit codes

| Code | Meaning                                           |
| ---- | ------------------------------------------------- |
| `0`  | Success                                           |
| `1`  | API error — error JSON printed, message on stderr |

## Related

* [API: List namespaces](/on-prem/api-references/namespaces/list)
* [Python: namespaces.list()](/on-prem/python-client/namespaces/list)