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

# List Namespaces

> GET /v1/namespaces — List all namespaces with memory counts.

<Snippet file="snippets/wallet-auth-callout.mdx" />

**Price:** FREE

Returns all namespaces for the authenticated wallet with memory counts.

## Query Parameters

<ParamField query="-" type="none">
  No query parameters required.
</ParamField>

## Response (200 OK)

<ResponseField name="namespaces" type="array">
  List of namespace objects.

  <Expandable title="Namespace object">
    <ResponseField name="name" type="string">
      Namespace name.
    </ResponseField>

    <ResponseField name="count" type="number">
      Number of non-deleted, non-expired memories in this namespace.
    </ResponseField>

    <ResponseField name="last_memory_at" type="string">
      ISO 8601 timestamp of the most recent memory in this namespace.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="number">
  Total number of namespaces.
</ResponseField>

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl https://api.memoclaw.com/v1/namespaces \
    -H "x-wallet-auth: 0xYourWallet:1699900000:0xSignature..."
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://api.memoclaw.com/v1/namespaces", {
    headers: { "x-wallet-auth": await getAuthHeader() },
  });
  const data = await response.json();
  ```

  ```python Python theme={null}
  from memoclaw import MemoClaw

  client = MemoClaw()
  result = client.list_namespaces()
  for ns in result.namespaces:
      print(f"{ns.name}: {ns.count} memories")
  ```

  ```typescript TypeScript theme={null}

  import { MemoClawClient } from "memoclaw";

  const client = new MemoClawClient();
  const result = await client.listNamespaces();
  result.namespaces.forEach(ns => {
    console.log(`${ns.name}: ${ns.count} memories`);
  });
  ```
</CodeGroup>

```json Response theme={null}
{
  "namespaces": [
    {
      "name": "default",
      "count": 42,
      "last_memory_at": "2026-02-13T10:30:00Z"
    },
    {
      "name": "acme-project",
      "count": 15,
      "last_memory_at": "2026-02-12T16:45:00Z"
    }
  ],
  "total": 2
}
```