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

# List Namespaces

> List all namespaces with type, vector dimension, item count, and created time.

## Overview

Returns every namespace on this Moorcheh instance, including how many items each namespace contains and when it was created.

<Note>
  On-prem does not use API keys. No request body or special headers are required.
</Note>

<RequestExample>
  ```bash theme={null}
  curl http://localhost:8080/namespaces
  ```
</RequestExample>

## Response fields

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

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

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

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

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

<ResponseField name="namespaces[].created_at" type="string">
  ISO 8601 UTC timestamp when the namespace was created, with millisecond precision (for example `"2026-05-21T12:00:00.000Z"`).
</ResponseField>

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

<ResponseField name="message" type="string">
  Error description when the request fails.
</ResponseField>

<ResponseExample>
  ```json 200 - With namespaces 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"
      }
    ]
  }
  ```

  ```json 200 - No namespaces yet theme={null}
  {
    "namespaces": []
  }
  ```

  ```json 500 - Server Error theme={null}
  {
    "status": "failure",
    "message": "Internal Server Error fetching namespaces."
  }
  ```
</ResponseExample>

## Next Steps

* [Create namespace](/on-prem/api-references/namespaces/create)
* [Upload documents](/on-prem/api-references/data/upload-documents) or [Upload vectors](/on-prem/api-references/data/upload-vectors)
* [Delete namespace](/on-prem/api-references/namespaces/delete)

## Related

* [CLI: moorcheh namespace-list](/on-prem/cli/namespaces/list)
* [Python: namespaces.list()](/on-prem/python-client/namespaces/list)