Sessions API
A session is a viewer who requested the playlist of a channel. Read more about sessions in Sessions.
All requests of this page are available to the admin role only.
List Sessions
Section titled “List Sessions”GET /api/ott/sessionsExample:
curl -sS -H "Authorization: Bearer $TOKEN" 'http://alta.example.com:8100/api/ott/sessions'Response:
[ { "ip": "203.0.113.5", "name": "news", "start": "2026-11-07 12:34:56", "status": "active" }, { "ip": "203.0.113.9", "name": "news", "start": "2026-11-07 12:20:10", "status": "paused" }]- ip: IP address of the viewer.
- name: The channel of the session.
- start: Start time of the session in the time zone of the server.
- status:
activeorpaused. A paused session closes after the timeout set in HLS Settings.
Sessions by Channel
Section titled “Sessions by Channel”GET /api/ott/sessions/statusReturns the number of sessions for each channel. Channels without sessions are not in the response.
Response:
{ "sessions": { "news": { "connections": "2" } }}- connections: Number of sessions as a string.