Stream Viewer List
Returns a paginated list of viewers watching a specific stream.
Request
| Property | Value |
|---|---|
| Method | GET |
| URL | /api/streams/{appName}/{streamKey}/viewers |
| Content-Type | application/json |
| Authentication | Bearer Token |
Request
bashcurl -X GET "{BASE_URL}/api/streams/{appName}/{streamKey}/viewers" \
-H "Authorization: Bearer YOUR_TOKEN"
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
appName | string | Yes | Application name |
streamKey | string | Yes | Stream key |
Request
bashcurl -X GET "{BASE_URL}/api/streams/{appName}/{streamKey}/viewers" \
-H "Authorization: Bearer YOUR_TOKEN"
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | integer | No | 1 | Page number |
rowsPerPage | integer | No | 10 | Number of items per page |
search | string | No | - | Filter results by search term |
streamKey | string | No | - | Filter by substream variant via substream stream key |
harnessType | string | No | - | Filter by harness type (see allowed values below) |
systemClients | "true" | "false" | No | - | Include system clients |
Allowed values for harnessType
"STORM_MSE_VIEWER""STORM_HLS_VIEWER""CLUSTER_DATA_CLIENT""GENERIC_HLS_VIEWER""GENERIC_DASH_VIEWER""RTMP_VIEWER""RTMP_PUSH""TRANSCODER""FILE_WRITER"
With query parameters
bashcurl -X GET "{BASE_URL}/api/streams/{appName}/{streamKey}/viewers?page=value&rowsPerPage=value&search=value" \
-H "Authorization: Bearer YOUR_TOKEN"
Response Body
Pagination
| Parameter | Type | Description |
|---|---|---|
data.totalItems | integer | Total number of viewers |
data.itemsPerPage | integer | Number of items per page |
data.totalPages | integer | Total number of pages |
data.currentPage | integer | Current page number |
data.hasPrevious | boolean | Indicates if a previous page exists |
data.hasNext | boolean | Indicates if a next page exists |
Viewer Object
| Parameter | Type | Description |
|---|---|---|
data.list[].id | string | Unique identifier of the viewer session |
data.list[].state | string | Connection state |
data.list[].class | string | Internal class name of the playback harness |
data.list[].pipelineType | string | Pipeline type |
data.list[].harnessType | string | Harness type |
data.list[].applicationName | string | Application name |
data.list[].streamKey | string | Stream key being viewed |
data.list[].subStream | string | Sub-stream variant |
data.list[].remoteAddress | string | Client IP address |
data.list[].deviceType | string | Device type ` |
data.list[].osName | string | Operating system name |
data.list[].browserName | string | Browser name |
data.list[].startTime | integer | Connection start time (Unix timestamp in ms) |
data.list[].duration | integer | Connection duration in milliseconds |
data.list[].inBandwidth | integer | Incoming bandwidth transfer speed |
data.list[].outBandwidth | integer | Outgoing bandwidth transfer speed |
data.list[].inTotalBytes | integer | Total incoming bytes |
data.list[].outTotalBytes | integer | Total outgoing bytes |
data.list[].healthScore | integer | Connection health score (0-100%) |
data.list[].healthGrade | string | Connection health grade |
Metadata
| Parameter | Type | Description |
|---|---|---|
meta.executionTime | integer | Request processing time in milliseconds |
meta.generatedAt | integer | Response generation timestamp (Unix timestamp in ms) |
Successful Response (200)
json{
"data": {
"totalItems": 1,
"itemsPerPage": 10,
"totalPages": 1,
"currentPage": 1,
"hasPrevious": false,
"hasNext": false,
"list": [
{
"id": "v_kf2v43ddmipwuybw",
"state": "PUBLISHED",
"class": "MSEPlaybackHarness",
"pipelineType": "CLIENT_OUTPUT",
"harnessType": "STORM_MSE_VIEWER",
"applicationName": "edge",
"streamKey": "f1",
"subStream": "native",
"remoteAddress": "83.11.204.8",
"deviceType": "DESKTOP",
"osName": "Windows 10/11",
"browserName": "Chrome",
"startTime": 1764760538538,
"duration": 194955,
"inBandwidth": 0,
"outBandwidth": 420485,
"inTotalBytes": 8902,
"outTotalBytes": 58597740,
"healthScore": 90,
"healthGrade": "Very Good"
}
]
},
"meta": {
"executionTime": 1,
"generatedAt": 1764760733493
}
}
Error Response (4xx/5xx)
| Parameter | Type | Description |
|---|---|---|
message | string | Human-readable error message |
json{
"message": "Error message"
}
Support Needed?
Create a free ticket and our support team will provide you necessary assistance.