Query a Stream
Query a stream by stream ID
Request
Request-Line
GET /lls/v1.0/stream/{streamId}
Request
Path Parameters
Name | Type | Required | Description |
---|---|---|---|
streamId | String | Mandatory | Stream id. |
Response
Response Body
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. Default is now. |
updated | Timestamp | Optional | Timestamp of updated time in UTC timezone. |
status | String | Mandatory | Status of domain. Valid values: banned. |
latestStreamingAt | Timestamp | Mandatory | Timestamp in UTC timezone when latest streaming began. |
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
Query a Stream
Request
GET /lls/v1.0/stream/d290f1ee-6c54-4b01-90e6-d701748f0851 HTTP/1.1
Successful Response Body
{
"id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
"domain": "live.example.com",
"app": "live",
"stream": "stream101",
"created": "2025-07-11T14:20:00Z",
"updated": "2025-07-11T14:20:00Z",
"status": "active",
"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"
}
]
}
Best Practices
Rate Limiting
Rate Limits
Rate limiting is posed upon the API, please kindly check your API calls to ensure complying with the rate limit below:
- 100 requests per minute
- 1000 requests per hour