GET
/
v1
/
memories
# To use the Python SDK, install the package:
# pip install mem0ai

from mem0 import MemoryClient
client = MemoryClient(api_key="your_api_key", org_id="your_org_id", project_id="your_project_id")

# Retrieve memories for a specific user
user_memories = client.get_all(user_id="<user_id>")

print(user_memories)
[
  {
    "id": "<string>",
    "name": "<string>",
    "input": [
      {
        "role": "<string>",
        "content": "<string>"
      }
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "owner": "<string>",
    "immutable": false,
    "expiration_date": null,
    "organization": "<string>",
    "metadata": {}
  }
]

Authorizations

​
Authorization
string
header
required

API key authentication. Prefix your Mem0 API key with 'Token '. Example: 'Token your_api_key'

Query Parameters

​
user_id
string

Filter memories by user ID

​
agent_id
string

Filter memories by agent ID

​
app_id
string

Filter memories by app ID

​
run_id
string

Filter memories by run ID

​
metadata
object

Filter memories by metadata (JSON string)

​
categories
string[]

Filter memories by categories

​
org_id
string

Filter memories by organization ID.

​
project_id
string

Filter memories by project ID.

​
fields
string[]

Filter memories by fields

​
keywords
string

Filter memories by keywords

​
page
integer

Page number for pagination. Default: 1

​
page_size
integer

Number of items per page. Default: 100

​
start_date
string

Filter memories by start date

​
end_date
string

Filter memories by end date

Response

200
application/json
​
id
string
required
​
name
string
required
​
created_at
string
required
​
updated_at
string
required
​
owner
string
required
​
organization
string
required
​
input
object[]
​
immutable
boolean
default:false

Whether the memory is immutable.

​
expiration_date
string | null

The date and time when the memory will expire. Format: YYYY-MM-DD

​
metadata
object