NEneosapien
Users

Get User Memory Stats

Changed on

Get memory statistics for all users in the organization.

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

Device active time is the pendant powered on and paired, whether or not it was recording, clipped to the 08:00-19:00 IST workday of each day in the range. Memory duration is recording time only, so the two differ.

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), device_active_hours, 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

Request

  • Base URL
    https://api.neosapien.xyz (the document declares no server; this is the origin it was published from)
  • URL
    https://api.neosapien.xyz/api/v1/users/memory-stats
  • Auth
    HTTP bearer

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)

end_datestring nullable

End date for custom range (ISO 8601)

sort_by'name' | 'device_active_hours' | 'total_hours' | 'sales_memory_hours' | 'memory_count' | 'last_online'

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

sort_orderstring

Sort direction: asc or desc

pageinteger

Page number (1-based)

per_pageinteger

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.

searchstring nullable

Filter to members matching this term: DSR/TSE/ASM code (exact or prefix) or name/email (substring). Ignored below 3 characters.

Response

Successful Response

time_rangestring required
start_datestring nullable

Filter start date (ISO 8601)

end_datestring nullable

Filter end date (ISO 8601)

Changes

  • c5feb2f431cfRevision changes
    • info

      added the new optional query request parameter search

  • e3da287dd1f3Revision changes
    • info

      added the new enum value device_active_hours to the query request parameter sort_by

    • info

      added the new enum value sales_memory_hours to the query request parameter sort_by

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status