POST
/
v2
/
memories

The v2 get memories API is powerful and flexible, allowing for more precise memory listing without the need for a search query. It supports complex logical operations (AND, OR) and comparison operators for advanced filtering capabilities. The comparison operators include:

  • in: Matches any of the values specified
  • gte: Greater than or equal to
  • lte: Less than or equal to
  • gt: Greater than
  • lt: Less than

Authorizations

Authorization
string
header
required

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

Query Parameters

filters
object

Filters to apply to the memories. Available fields are: user_id, agent_id, app_id, run_id, created_at, updated_at, categories, keywords. Supports logical operators (AND, OR) and comparison operators (in, gte, lte, gt, lt, ne, contains, icontains)

org_id
string

Filter memories by organization ID.

project_id
string

Filter memories by project ID.

page
integer

Page number for pagination. Default: 1

page_size
integer

Number of items per page. Default: 100

Response

200
application/json
id
string
required
name
string
required
created_at
string
required
updated_at
string
required
total_memories
integer
required
owner
string
required
organization
string
required
type
enum<string>
required
Available options:
user,
agent,
app,
run
metadata
object