List Historical Streams

List the information of historical streams, including the stream ID, domain name, app name, stream name, URL, and status. Only historical streams from the last two weeks are listed, not active streams.

Request

Request-Line

GET /lls/v1.0/historicalStream

Query Parameters

Parameter	Type	Required	Description
domain	String	Optional	ingest domain name
app	String	Optional	app name
started	Timestamp	Mandatory	Timestamp of started time to query. Format yyyyMMddTHHmmssZ UTC time. It cannot be earlier than two weeks ago.
ended	Timestamp	Mandatory	Timestamp of ended time to query. Format yyyyMMddTHHmmssZ UTC time.

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	ingest domain name
app	String	Mandatory	app name
stream	String	Mandatory	stream name
started	Timestamp	Mandatory	Timestamp of started time. Format yyyyMMddTHHmmssZ UTC time.
ended	String	Mandatory	Timestamp of started time. Format yyyyMMddTHHmmssZ UTC time.
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/historicalStream?domain=live.example.com&started=20250711T142000Z&ended=20250712T183000Z HTTP/1.1

Successful Response Body

{
  "streams": [
    {
      "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "domain": "ingest.example.com",
      "app": "live",
      "stream": "stream101",
      "started": "2025-07-11T14:20:00Z",
      "ended": "2025-07-11T14:30:00Z",
      "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": "f39fje-fj29f2-023nfj2-jf2732891",
      "domain": "ingest.example.com",
      "app": "live",
      "stream": "stream333",
      "started": "2025-07-12T18:20:00Z",
      "ended": "2025-07-12T18:30:00Z",
      "ingestURL": "ingest.example.com/live/stream333?token=d238d2dh2",
      "deliveryURLs": [
        {
          "protocol": "flv",
          "preset": "transmux",
          "url": "live.example.com/han/live/stream333/transmux.flv"
        },
        {
          "protocol": "flv",
          "preset": "1080p",
          "url": "live.example.com/han/live/stream333/1080p.flv"
        }
      ]
    }
  ]
}

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