v3

latestOpenAPI 3.1.02026-08-0712650111.6 KB

List Event Views

List views paginated from video_views (one row per completed view).

Using video_views instead of aggregating from events drops page-1 latency from ~5s to ~0.45s and count from ~17s to ~0.5s for large orgs.

Pass count_only=true to get only the total count without fetching rows. The frontend fires both in parallel so the table renders immediately while the count resolves in the background.

Note: views where viewEnd never fired are omitted (no video_views row). Tracked in SHO-63.

get/v1/events/views

Query parameters

event_typestring[] nullable
content_idstring nullable
viewer_idstring nullable
limitinteger
pageinteger
count_onlyboolean

Response

Successful Response

{"stackTrail":"paths:/v1/events/views:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}