Skip to main content
GET
https://api.agent-mind.com
/
api
/
v1
/
memories
/
list
List Memories
curl --request GET \
  --url https://api.agent-mind.com/api/v1/memories/list \
  --header 'Authorization: Bearer <token>'

​
Overview

List all memories stored, with optional filtering by user_id. This endpoint supports pagination for large memory collections.

​
Query Parameters

​
limit
integer
default:"50"
Maximum number of memories to return per page. Default is 50.
​
offset
integer
default:"0"
Number of memories to skip for pagination. Default is 0.
​
user_id
string
Optional filter to list memories for a specific user only.

​
Response

Returns a paginated list of memories with their metadata and content.

​
Examples

​
List All Memories

import requests

url = "https://api.agent-mind.com/api/v1/memories/list"
headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}
params = {
    "limit": 50,
    "offset": 0
}

response = requests.get(url, headers=headers, params=params)
memories = response.json()

​
List User-Specific Memories

params = {
    "user_id": "user_123",
    "limit": 20,
    "offset": 0
}

response = requests.get(url, headers=headers, params=params)

​
Pagination Example

# Get second page of results (memories 51-100)
params = {
    "limit": 50,
    "offset": 50
}

response = requests.get(url, headers=headers, params=params)

​
Response Example

{
  "memories": [
    {
      "id": "mem_abc123",
      "content": "User prefers email notifications",
      "user_id": "user_123",
      "session_id": "session_456",
      "metadata": {
        "category": "preferences",
        "type": "communication"
      },
      "created_at": "2024-03-20T10:30:00Z",
      "updated_at": "2024-03-20T10:30:00Z"
    },
    {
      "id": "mem_def456",
      "content": "Customer interested in premium features",
      "user_id": "user_789",
      "metadata": {
        "category": "sales",
        "priority": "high"
      },
      "created_at": "2024-03-19T15:45:00Z",
      "updated_at": "2024-03-19T15:45:00Z"
    }
  ],
  "total": 125,
  "limit": 50,
  "offset": 0,
  "has_more": true
}

​
Error Responses

​
400 Bad Request

{
  "error": "Invalid limit or offset parameter"
}

​
401 Unauthorized

{
  "error": "Invalid or missing API key"
}

​
500 Internal Server Error

{
  "error": "Failed to list memories"
}