Sign in
Users

Get User Memory Stats

Get memory statistics for all users in the organization.

Returns per user: name, user_id, total hours of memory duration, number of memories, last online timestamp, and device status.

Only non-archived, non-deleted memories are counted.

Filter Options:

  • today - current day's data
  • week - past 7 days (default)
  • month - past 30 days
  • all_time - complete historical data
  • custom - user-defined date range (requires start_date and end_date)

Sorting:

  • sort_by: total_hours (default), name, memory_count, last_online
  • sort_order: desc (default) or asc

Pagination:

  • page: Page number, 1-based (default: 1)
  • per_page: Items per page, 1-100 (default: 10)
get/api/v1/users/memory-stats

Query parameters

time_range'today' | 'week' | 'month' | 'all_time' | 'custom'

Time range filter: today, week, month, all_time, custom

start_datestring nullable

Start date for custom range (ISO 8601)

Start date for custom range (ISO 8601)

end_datestring nullable

End date for custom range (ISO 8601)

End date for custom range (ISO 8601)

sort_by'name' | 'total_hours' | 'memory_count' | 'last_online'

Field to sort by: name, total_hours, memory_count, last_online

sort_orderstring

Sort direction: asc or desc

Sort direction: asc or desc

pageinteger

Page number (1-based)

Page number (1-based)

per_pageinteger

Items per page (1-100)

Items per page (1-100)

tz_infostring nullable

User's IANA timezone (e.g. Asia/Kolkata). Used to align date boundaries to the user's local midnight.

User's IANA timezone (e.g. Asia/Kolkata). Used to align date boundaries to the user's local midnight.

Response

Successful Response

time_rangestring required
start_datestring nullable

Filter start date (ISO 8601)

end_datestring nullable

Filter end date (ISO 8601)

Changes

No recorded changes to this endpoint across all 1 revision of this API.