Skip to content
Products

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.

Terminal window
GET /api/ott/sessions

Example:

Terminal window
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: active or paused. A paused session closes after the timeout set in HLS Settings.
Terminal window
GET /api/ott/sessions/status

Returns 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.