Skip to main content
GET
/
api
/
v0
/
memories
Python
# To use the Python SDK, install the package:
# pip install evermemos

from evermemos import EverMemOS

memory = EverMemOS(api_key="<api_key>").v0.memories

response = memory.get(extra_query={"user_id": "<user_id>"})
print(response.result.memories)
{
  "message": "Memory retrieval successful, retrieved 1 memories",
  "result": {
    "count": 1,
    "memories": [
      {
        "content": "User discussed coffee during the project sync",
        "memory_type": "episodic_memory",
        "summary": "Project sync coffee note",
        "timestamp": "2024-01-15T10:30:00+00:00",
        "user_id": "user_123"
      }
    ],
    "metadata": {
      "memory_type": "fetch",
      "source": "fetch_mem_service",
      "user_id": "user_123"
    },
    "total_count": 100
  },
  "status": "ok"
}

Authorizations

​
Authorization
string
header
default:Bearer <api_key>
required

Bearer authentication header of the form Bearer 'api_key', where 'api_key' is your EverMemOS auth api key.

Body

application/json
​
user_id
string | null

User ID

Example:

"user_123"

​
group_ids
string[] | null

List of Group IDs for batch query. Single group also needs array format. Max 50.

Example:
["group_1"]
​
page
integer
default:1

Page number, starts from 1

Required range: x >= 1
Example:

1

​
page_size
integer
default:20

Number of records per page, default 20, max 100

Required range: 1 <= x <= 100
Example:

20

​
memory_type
enum<string> | null
default:episodic_memory

Memory type, enum values from MemoryType:

  • profile: user profile
  • episodic_memory: episodic memory (default)
  • foresight: prospective memory
  • event_log: event log (atomic facts)
Available options:
profile,
episodic_memory,
foresight,
event_log
Example:

"episodic_memory"

​
start_time
string | null

Start time for time range filtering (ISO 8601 format with Timezone is required)

Example:

"2024-01-01T00:00:00+00:00"

​
end_time
string | null

End time for time range filtering (ISO 8601 format with Timezone is required)

Example:

"2024-12-31T23:59:59+00:00"

Response

Successful Response

​
result
FetchMemResponse · object
required

Memory fetch result

​
status
string
default:ok

Response status

Examples:

"ok"

"failed"

​
message
string
default:""

Response message

Example:

"Operation successful"