GET /memories — List All Memories for a User Agent

The List Memories endpoint returns every memory stored for a given user_id and agent_id, ordered from most recent to oldest. You can use it to build a memory browser in your dashboard, audit what your agent knows about a user, or debug unexpected behaviour. Combine limit and offset to page through large memory sets without loading everything at once.

Endpoint: GET https://api.remem.online/memories

Request Headers

Name	Required	Description
`X-API-Key`	Yes	Your Remem API key

Query Parameters

string

required

The ID of the user whose memories you want to list.

string

required

The ID of the agent whose memories you want to list.

string

Filter results to a specific memory type. Accepted values: episodic, semantic, summary. Omit to return all types.

integer

default:"20"

Number of memories to return per page. Minimum 1, maximum 100.

integer

default:"0"

Zero-based pagination offset. Use in combination with limit to step through pages.

Examples

curl "https://api.remem.online/memories?\
user_id=user_123&agent_id=support_bot&limit=20&offset=0" \
  -H "X-API-Key: rm_live_xxx"

from remem import RememClient

client = RememClient(api_key="rm_live_xxx")

# First page
page = client.list(
    user_id="user_123",
    agent_id="support_bot",
    limit=20,
    offset=0,
)

print(f"Total memories: {page.total}")
for m in page.memories:
    print(m.content, m.created_at)

# Second page
page2 = client.list(
    user_id="user_123",
    agent_id="support_bot",
    limit=20,
    offset=20,
)

Response

200 — Success

{
  "memories": [
    {
      "id":          "775263ee-73af-4416-9804-1f274048ae08",
      "content":     "User prefers concise bullet points",
      "user_id":     "user_123",
      "agent_id":    "support_bot",
      "memory_type": "semantic",
      "importance":  0.8,
      "metadata":    {},
      "created_at":  "2026-06-07T12:00:00Z",
      "last_accessed": "2026-06-07T12:00:00Z",
      "expires_at":  null
    }
  ],
  "total":  47,
  "limit":  20,
  "offset": 0
}

Response Fields

array

Array of Memory objects. See Search Memories for the full Memory object field reference.

integer

Total number of memories stored for this user+agent pair across all pages.

integer

The limit value applied to this response.

integer

The offset value applied to this response.

Error Responses

Code	Meaning	Fix
`401`	Invalid or missing API key	Verify your key is passed in the `X-API-Key` header
`422`	Missing required parameter	Both `user_id` and `agent_id` are required

​Request Headers

​Query Parameters

​Examples

​Response

​200 — Success

​Response Fields

​Error Responses

Request Headers

Query Parameters

Examples

Response

200 — Success

Response Fields

Error Responses