List Streams
List streams of a domain, or an app.
Request
Request-Line
GET /lls/v1.0/stream
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| domain | String | Optional | Ingest domain name. |
| app | String | Optional | App name. |
| status | String | Optional | status of stream. valid values: banned, active. |
| streamingStatus | String | Optional | status of streaming. valid values: streaming, ended. |
Response
Response Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| streams | Array | Mandatory | Array of Stream Object. |
Object: Stream
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | String | Mandatory | Stream id. |
| domain | String | Mandatory | Domain name. |
| app | String | Mandatory | App name. |
| stream | String | Mandatory | Stream name. |
| created | Timestamp | Mandatory | Timestamp of created time in UTC timezone. |
| updated | Timestamp | Optional | Timestamp of updated time in UTC timezone. |
| latestStreamingAt | Timestamp | Mandatory | Timestamp in UTC timezone when latest streaming began. |
| status | String | Mandatory | Status of stream. Valid values: active, banned. |
| status | String | Mandatory | Status of streaming. Valid values: streaming, ended. |
| ingestURL | String | Mandatory | URL of ingest stream. |
| deliveryURLs | Array | Mandatory | Array of Delivery URL Object. |
Object: Delivery URL
| Parameter | Type | Required | Description |
|---|---|---|---|
| protocol | String | Mandatory | Protocol name, invalid values are: hls, dash, ll-hls, http-flv. |
| preset | String | Optional | Preset name. When protocol is 'http-flv', preset is mandatory. |
| url | String | Mandatory | Delivery URL of manifest playlist .m3u8, .mpd for HLS/DASH, or .flv for the HTTP-FLV of the specified protocol and preset. |
Examples
List All Streams for a Domain
Request
GET /lls/v1.0/stream?domain=live.example.com&streamingStatus=streaming HTTP/1.1
Successful Response Body
{
"streams": [
{
"id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
"domain": "live.example.com",
"app": "live",
"stream": "stream101",
"created": "2025-07-11T14:20:00Z",
"latestStreamingAt": "2025-07-11T14:20:00Z",
"status": "active",
"streamingStatus": "streaming",
"ingestURL": "ingest.example.com/live/stream101?token=1234567890",
"deliveryURLs": [
{
"protocol": "hls",
"url": "live.example.com/han/live/stream101/manifest.m3u8"
},
{
"protocol": "dash",
"url": "live.example.com/han/live/stream101/manifest.mpd"
}
]
},
{
"id": "f8b5c1a0-3d2e-5f4a-9b8c-1a2b3c4d5e6f",
"domain": "live.example.com",
"app": "vod",
"stream": "movienight",
"created": "2025-07-11T14:25:00Z",
"updated": "2025-07-11T14:28:00Z",
"latestStreamingAt": "2025-07-11T14:28:00Z",
"status": "banned",
"streamingStatus": "streaming",
"ingestURL": "ingest.example.com/live/movienight?token=d238d2dh2",
"deliveryURLs": [
{
"protocol": "flv",
"preset": "transmux",
"url": "live.example.com/han/live/movienight/transmux.flv"
},
{
"protocol": "flv",
"preset": "1080p",
"url": "live.example.com/han/live/movienight/1080p.flv"
}
]
}
]
}
List All Active Streams for an Application
Request
GET /lls/v1.0/stream?domain=live.example.com&app=live&status=active HTTP/1.1
Successful Response Body
{
"streams": [
{
"id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
"domain": "live.example.com",
"app": "live",
"stream": "stream101",
"created": "2025-07-11T14:20:00Z",
"latestStreamingAt": "2025-07-11T14:20:00Z",
"status": "active"
}
]
}
List All Banned Streams
This example shows how to list all streams across all domains and apps that have a banned status.
Request
GET /lls/v1.0/stream?status=banned HTTP/1.1
Successful Response Body
{
"streams": [
{
"id": "f8b5c1a0-3d2e-5f4a-9b8c-1a2b3c4d5e6f",
"domain": "live.example.com",
"app": "vod",
"stream": "movie-night",
"created": "2025-07-11T14:25:00Z",
"updated": "2025-07-11T14:28:00Z",
"status": "banned"
}
]
}
Best Practices
Rate Limiting
Rate Limits
Rate limiting is posed upon the API, check API calls to comply with the rate limit below:
- 100 requests per minute
- 1000 requests per hour