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

# Export Memories

> GET /v1/export — Export memories in JSON, CSV, or Markdown format.

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

**Price:** FREE

Export memories in various formats for backup or migration purposes.

## Query Parameters

<ParamField query="format" type="string">
  Output format: `json`, `csv`, or `markdown`. Default: `json`.
</ParamField>

<ParamField query="namespace" type="string">
  Filter by namespace.
</ParamField>

<ParamField query="memory_type" type="string">
  Filter by memory type: `correction`, `preference`, `decision`, `project`, `observation`, or `general`.
</ParamField>

<ParamField query="tags" type="string">
  Comma-separated tags to filter by.
</ParamField>

<ParamField query="session_id" type="string">
  Filter by session ID.
</ParamField>

<ParamField query="agent_id" type="string">
  Filter by agent ID.
</ParamField>

<ParamField query="before" type="string">
  ISO 8601 date string. Only return memories created before this time.
</ParamField>

<ParamField query="after" type="string">
  ISO 8601 date string. Only return memories created after this time.
</ParamField>

<ParamField query="include_deleted" type="string">
  Set to `true` to include soft-deleted memories. Default: `false`.
</ParamField>

## Response (200 OK)

<ResponseField name="format" type="string">
  The format used for export.
</ResponseField>

<ResponseField name="memories" type="array">
  Array of memory objects (JSON) or formatted output (CSV/Markdown).
</ResponseField>

<ResponseField name="count" type="number">
  Total number of exported memories.
</ResponseField>

## Example

<CodeGroup>
  ```bash curl theme={null}
  # Export all memories as JSON
  curl https://api.memoclaw.com/v1/export \
    -H "x-wallet-auth: 0xYourWallet:1699900000:0xSignature..."

  # Export as CSV
  curl "https://api.memoclaw.com/v1/export?format=csv" \
    -H "x-wallet-auth: 0xYourWallet:1699900000:0xSignature..."

  # Export specific namespace
  curl "https://api.memoclaw.com/v1/export?namespace=acme-project" \
    -H "x-wallet-auth: 0xYourWallet:1699900000:0xSignature..."
  ```

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

  // Export as CSV
  const csvResponse = await fetch("https://api.memoclaw.com/v1/export?format=csv", {
    headers: { "x-wallet-auth": await getAuthHeader() },
  });
  const csvText = await csvResponse.text();
  ```

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

  client = MemoClaw()

  # Export all as JSON
  result = client.export()
  print(f"Exported {result.count} memories")

  # Export as CSV
  csv_result = client.export(format="csv")

  # Export specific namespace
  ns_result = client.export(namespace="acme-project")
  ```

  ```typescript TypeScript theme={null}

  import { MemoClawClient } from "memoclaw";

  const client = new MemoClawClient();

  // Export all as JSON
  const result = await client.export();
  console.log(`Exported ${result.count} memories`);

  // Export as CSV
  const csvResult = await client.export({ format: "csv" });

  // Export specific namespace
  const nsResult = await client.export({ namespace: "acme-project" });
  ```
</CodeGroup>

```json Response (JSON) theme={null}
{
  "format": "json",
  "memories": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "content": "User prefers dark mode",
      "importance": 0.8,
      "memory_type": "preference",
      "namespace": "default",
      "tags": ["ui", "preferences"],
      "created_at": "2026-02-13T10:30:00Z",
      "updated_at": "2026-02-13T10:30:00Z"
    }
  ],
  "count": 1
}
```