Skip to main content
POST
/
v3
/
memories
cURL
curl -X POST 'https://api.mem0.ai/v3/memories/?page=1&page_size=50' \
  -H "Authorization: Token <api-key>" \
  -H "Content-Type: application/json" \
  -d '{"filters": {"user_id": "alice"}}'
{
  "count": 123,
  "next": "https://api.mem0.ai/v3/memories/?page=2&page_size=100",
  "previous": null,
  "results": [
    {
      "id": "mem-uuid",
      "memory": "User moved to San Francisco from New York in January 2026",
      "metadata": {},
      "categories": [
        "location"
      ],
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-01-15T10:30:00Z"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.mem0.ai/llms.txt

Use this file to discover all available pages before exploring further.

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. 
memories = client.get_all(
    filters={
        "AND": [
            {
                "user_id": "alex"
            },
            {
                "created_at": {"gte": "2024-07-01", "lte": "2024-07-31"}
            }
        ]
    },
    page=1,
    page_size=50
)
The response is a paginated envelope with count, next, previous, and results. Use page and page_size query params to step through results.

Query Parameters

​
page
integer
default:1

1-indexed page number.

Required range: x >= 1
​
page_size
integer
default:100

Results per page.

Required range: 1 <= x <= 200

Body

application/json
​
filters
object
required

Entity and metadata filters. Must include at least one entity ID (user_id, agent_id, app_id, or run_id).

Response

Paginated envelope of memories.

​
count
integer
required

Total number of memories matching the filters.

​
next
string<uri> | null
required

URL for the next page, or null if this is the last page.

​
previous
string<uri> | null
required

URL for the previous page, or null if this is the first page.

​
results
object[]
required