in
: Matches any of the values specifiedgte
: Greater than or equal tolte
: Less than or equal togt
: Greater thanlt
: Less thanne
: Not equal toicontains
: Case-insensitive containment check*
: Wildcard character that matches everything
Graph Memory
To retrieve memories with graph-based relationships, pass theenable_graph=True
parameter. This includes relationship data in the response for more contextual results.
Authorizations
API key authentication. Prefix your Mem0 API key with 'Token '. Example: 'Token your_api_key'
Body
A dictionary of filters to apply to retrieve 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, *). For categories field, use 'contains' for partial matching (e.g., {"categories": {"contains": "finance"}}) or 'in' for exact matching (e.g., {"categories": {"in": ["personal_information"]}}).
A list of field names to include in the response. If not provided, all fields will be returned.
Page number for pagination. Default: 1
Number of items per page. Default: 100
The unique identifier of the organization associated with the memory.
The unique identifier of the project associated with the memory.
Response
Successfully retrieved memories.
Whether the memory is immutable.
The date and time when the memory will expire. Format: YYYY-MM-DD.