Skip to main content
POST
/
serve
/
api
/
v1
/
memories
List Memories
curl --request POST \
  --url https://api.memories.ai/serve/api/v1/memories \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "unique_id": "test1118",
  "page": 1,
  "page_size": 20,
  "filters": {}
}
'
{
  "code": "0000",
  "msg": "success",
  "data": {},
  "success": true,
  "failed": false
}

​
Prerequisites

  • You have created a memories.ai API key.
  • You have a valid unique_id for filtering memories.
unique_id

​
Host URL

https://api.memories.ai

​
Endpoint

POST /serve/api/v1/memories 
/serve/api/v1/memories

​
Request Example

import requests
from typing import Dict, Any, List

headers: Dict[str, str] = {
    "Authorization": "<API_KEY>"
}
payload: Dict[str, Any] = { 
    "page": 1, 
    "page_size": 20, 
    "unique_id": "test1118", 
    "filters": { 
        "AND": [ 
            { "tags": { "contains": "TAG123" } }, 
            { "content": { "icontains": "Changed" } }, 
            { "memories_at": { "gte": 1763398800000 } }, 
            { "created_at": { "gte": 1763390310401, "lte": 1763390310401 } }, 
            { "updated_at": { "gte": 1763430134026 } }, 
            { "geoLocation": { "latitude": 3.2028, "longitude": 73.2207 } } 
        ] 
    }
}
response: requests.Response = requests.post( 
    "https://api.memories.ai/serve/api/v1/memories", 
    headers=headers, 
    json=payload, 
    timeout=3600
)
print(response.text)

​
Request Body

{ 
    "page": 1, 
    "page_size": 20, 
    "unique_id": "string", 
    "filters": { 
        "AND": [ 
            { "tags": { "contains": "string" } }, 
            { "content": { "icontains": "string" } }, 
            { "memories_at": { "gte": 1672531200000, "lte": 1675123200000 } }, 
            { "created_at": { "gte": 1672531200000, "lte": 1675123200000 } }, 
            { "updated_at": { "gt": 1674600000000, "lt": 1675123200000 } }, 
            { "geoLocation": { "latitude": 3.2028, "longitude": 73.2207 } } 
        ] 
    }
}

​
Request Parameters

​
page
integer
default:"1"
Page number.
​
page_size
integer
default:"20"
Number of items per page.
​
unique_id
string
required
Unique identifier for filtering.
​
filters
object
Complex filtering logic (AND/OR).

​
Filter Operators

The following comparison operators are supported for numeric and timestamp fields:
  • gte: Greater than or equal to
  • lte: Less than or equal to
  • gt: Greater than
  • lt: Less than
For text fields:
  • icontains: Case-insensitive substring match
For array fields:
  • contains: Check if array contains the specified value

​
Response Example

Status code 200 
{ 
    "code": "0000", 
    "msg": "success", 
    "data": { 
        "content": [ 
            { 
                "id": "645951624769814528", 
                "content": "Technology has rapidly transformed nearly every aspect of modern life...", 
                "tags": ["TAG123"], 
                "longitude": 73.2207, 
                "latitude": 3.2028, 
                "owner": "test1118", 
                "created_at": "2025-11-18T11:41:08Z", 
                "updated_at": "2025-11-18T11:43:59Z", 
                "memories_at": "2025-11-17T17:00:00Z" 
            } 
        ], 
        "pageable": { 
            "sort": { "sorted": false, "unsorted": true, "empty": true }, 
            "pageNumber": 0, 
            "pageSize": 20, 
            "offset": "0", 
            "paged": true, 
            "unpaged": false 
        }, 
        "totalElements": "1", 
        "totalPages": 1, 
        "last": true, 
        "first": true, 
        "sort": { "sorted": false, "unsorted": true, "empty": true }, 
        "numberOfElements": 1, 
        "size": 20, 
        "number": 0, 
        "empty": false 
    }, 
    "success": true, 
    "failed": false
}

​
Response Structure

Status code 200 
"0000"

Authorizations

​
Authorization
string
header
required

Body

application/json
​
unique_id
string
required
Example:

"test1118"

​
page
integer
default:1
​
page_size
integer
default:20
​
filters
object

Flexible filter object used by memories list and search endpoints.

Response

200 - application/json

Successful response

​
code
Example:

"0000"

​
msg
string
Example:

"success"

​
data
​
success
boolean
Example:

true

​
failed
boolean
Example:

false