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.
OAuth 2.1 authorization code flow with PKCE (required of every client, public or confidential). Scopes are a ceiling on the credential, not a grant of access: a token also cannot exceed what the user who approved it may already do. A write scope does not imply its matching read — ask for both.
In: header
Scope: assets:read
Path Parameters
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$uuidQuery Parameters
"30d"Value in
- "7d"
- "30d"
- "90d"
"visibility"Value in
- "visibility"
- "referrerHost"
- "country"
- "userAgentClass"
- "day"
Value in
- "play_started"
- "play_completed"
- "download"
- "embed_resolved"
1 <= value <= 5010Response 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"}