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"
    }
  ]
}

​
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