Back to Mem0

Get Memories

docs/api-reference/memory/get-memories.mdx

2.0.11.7 KB
Original Source

List memories scoped by filters with paginated results. Entity IDs (user_id, agent_id, app_id, run_id) must be passed inside the filters object — top-level entity IDs are rejected with 400.

The filters object supports complex logical operations (AND, OR, NOT) and comparison operators:

  • 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
  • ne: Not equal to
  • icontains: Case-insensitive containment check
  • *: Wildcard character that matches everything

Pass page and page_size as query parameters to paginate through results.

<CodeGroup> ```python Code memories = client.get_all( filters={ "AND": [ { "user_id": "alex" }, { "created_at": {"gte": "2024-07-01", "lte": "2024-07-31"} } ] }, page=1, page_size=50 ) ```
python
{
    "count": 2,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": "f4cbdb08-7062-4f3e-8eb2-9f5c80dfe64c",
            "memory": "Alex is planning a trip to San Francisco from July 1st to July 10th",
            "created_at": "2024-07-01T12:00:00Z",
            "updated_at": "2024-07-01T12:00:00Z"
        },
        {
            "id": "a2b8c3d4-5e6f-7g8h-9i0j-1k2l3m4n5o6p",
            "memory": "Alex prefers vegetarian restaurants",
            "created_at": "2024-07-05T15:30:00Z",
            "updated_at": "2024-07-05T15:30:00Z"
        }
    ]
}
</CodeGroup> <Info> The response is a paginated envelope with `count`, `next`, `previous`, and `results`. Use `page` and `page_size` query params to step through results. </Info>