AccessActivity
Read aggregated access activity for one asset
Returns totals per eventType, a top-N breakdown for one dimension, and a zero-filled daily series for the requested eventType. Gated by `canGetAccessActivity` — granted to the same roles that hold `canGetPublicLinks`.
Returns totals per eventType, a top-N breakdown for one dimension,
and a zero-filled daily series for the requested eventType. Gated
by canGetAccessActivity — granted to the same roles that hold
canGetPublicLinks.
Authorization
bearerAuth AuthorizationBearer <token>
In: header
Path Parameters
assetId*string
Format
uuidQuery Parameters
range?string
Default
"30d"Value in
- "7d"
- "30d"
- "90d"
groupBy?string
Default
"visibility"Value in
- "visibility"
- "referrerHost"
- "country"
- "userAgentClass"
- "day"
eventType?string
Value in
- "play_started"
- "play_completed"
- "download"
- "embed_resolved"
limit?integer
Range
1 <= value <= 50Default
10Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/assets/497f6eca-6276-4993-bfeb-53cbbbba6f08/access-activity"{ "range": "30d", "from": "2026-04-13", "to": "2026-05-13", "totals": [ { "eventType": "string", "count": 0 } ], "breakdown": [ { "value": "string", "label": "Unknown", "count": 0 } ], "series": [ { "date": "2026-05-13", "eventType": "string", "count": 0 } ], "groupBy": "string", "eventType": "string"}