Skip to main content
GET
/
api
/
v1
/
memories
get memories
curl --request GET \
  --url https://api.evermind.ai/api/v1/memories \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "limit": 20,
  "memory_type": "profile",
  "offset": 0,
  "sort_order": "desc",
  "user_id": "user_123"
}
'
{
  "status": "ok",
  "message": "Memory retrieval successful",
  "result": {
    "memories": [
      {
        "memory_type": "base_memory",
        "user_id": "user_123",
        "timestamp": "2024-01-15T10:30:00",
        "content": "User likes drinking coffee",
        "summary": "Coffee preference"
      }
    ],
    "total_count": 100,
    "has_more": false,
    "metadata": {
      "source": "fetch_mem_service",
      "user_id": "user_123",
      "memory_type": "fetch"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Query parameters for fetching user memories

Used for GET /api/v1/memories endpoint

​
user_id
string
required

User ID

Example:

"user_123"

​
memory_type
string | null
default:episodic_memory

Memory type, enum values from MemoryType:

  • profile: user profile
  • episodic_memory: episodic memory (default)
  • foresight: prospective memory
  • event_log: event log (atomic facts)
Example:

"profile"

​
limit
integer | null
default:10

Maximum number of memories to return

Required range: 1 <= x <= 100
Example:

20

​
offset
integer | null
default:0

Pagination offset

Required range: x >= 0
Example:

0

​
sort_by
string | null

Sort field

Example:

"created_at"

​
sort_order
string | null
default:desc

Sort direction, enum values:

  • asc: ascending order
  • desc: descending order (default)
Example:

"desc"

​
version_range
(string | null)[] | null

Version range filter, format [start, end], closed interval

Example:
["v1.0", "v2.0"]

Response

Successfully retrieved memory data

The response is of type Response Fetch Memories Api V1 Memories Get · object.