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 identifier.
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