Skip to main content
GET
/
namespaces
curl http://localhost:8080/namespaces
{
  "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"
    }
  ]
}

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.

Overview

Returns every namespace on this Moorcheh instance, including how many items each namespace contains and when it was created.
On-prem does not use API keys. No request body or special headers are required.
curl http://localhost:8080/namespaces

Response fields

namespaces
array
List of namespace objects. Empty array [] when no namespaces exist yet.
namespaces[].namespace_name
string
Unique name of the namespace.
namespaces[].type
string
"text" or "vector".
namespaces[].vector_dimension
number | null
Fixed vector length for vector namespaces. null for text namespaces.
namespaces[].item_count
number
Number of items stored in this namespace.
namespaces[].created_at
string
ISO 8601 UTC timestamp when the namespace was created, with millisecond precision (for example "2026-05-21T12:00:00.000Z").
status
string
"failure" on server error responses.
message
string
Error description when the request fails.
{
  "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"
    }
  ]
}

Next Steps