Skip to main content

Query a Stream

Query a stream by stream ID

Request

Request-Line

GET /lls/v1.0/stream/{streamId}

Request

Path Parameters

NameTypeRequiredDescription
streamIdStringMandatoryStream id.

Response

Response Body

ParameterTypeRequiredDescription
idStringMandatoryStream id.
domainStringMandatoryDomain name.
appStringMandatoryApp name.
streamStringMandatoryStream name.
createdTimestampMandatoryTimestamp of created time in UTC timezone. Default is now.
updatedTimestampOptionalTimestamp of updated time in UTC timezone.
statusStringMandatoryStatus of domain. Valid values: banned.
latestStreamingAtTimestampMandatoryTimestamp in UTC timezone when latest streaming began.
ingestURLStringMandatoryURL of ingest stream.
deliveryURLsArrayMandatoryArray of Delivery URL Object.

Object: Delivery URL

ParameterTypeRequiredDescription
protocolStringMandatoryProtocol name, invalid values are: hls, dash, ll-hls, http-flv.
presetStringOptionalPreset name. When protocol is 'http-flv', preset is mandatory.
urlStringMandatoryDelivery 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