Skip to main content
GET
/
v1
/
memories
List Memories
curl --request GET \
  --url https://api.memoclaw.com/v1/memories
{
  "memories": [
    {
      "memories[].id": "<string>",
      "memories[].user_id": "<string>",
      "memories[].namespace": "<string>",
      "memories[].content": "<string>",
      "memories[].metadata": {},
      "memories[].importance": 123,
      "memories[].memory_type": "<string>",
      "memories[].session_id": "<string>",
      "memories[].agent_id": "<string>",
      "memories[].pinned": true,
      "memories[].expires_at": "<string>",
      "memories[].created_at": "<string>",
      "memories[].updated_at": "<string>",
      "memories[].accessed_at": "<string>",
      "memories[].access_count": 123
    }
  ],
  "total": 123,
  "limit": 123,
  "offset": 123
}

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.

Price: FREE

Query Parameters

limit
integer
Maximum number of results, 1–100. Default: 20.
offset
integer
Pagination offset. Default: 0.
tags
string
Comma-separated tags. Filter memories matching any of the specified tags.
namespace
string
Filter by namespace.
session_id
string
Filter by session ID.
agent_id
string
Filter by agent ID.

Response (200)

memories
array
Array of memory objects.
total
number
Total number of matching memories.
limit
number
Applied limit.
offset
number
Applied offset.

Example

curl "https://api.memoclaw.com/v1/memories?limit=10&offset=0&tags=preferences,ui"
Response
{
  "memories": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "namespace": "default",
      "content": "User prefers dark mode and vim keybindings",
      "metadata": {
        "tags": ["preferences", "ui"]
      },
      "importance": 0.8,
      "created_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-01-15T10:30:00Z",
      "accessed_at": "2025-01-20T14:22:00Z",
      "access_count": 3
    }
  ],
  "total": 1,
  "limit": 10,
  "offset": 0
}