List Streams

List streams

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.

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 domain. Valid values: banned.
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 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",
      "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",
      "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, please kindly check your API calls to ensure complying with the rate limit below:

• 100 requests per minute
• 1000 requests per hour