List Streams

List streams

Request

Request-Line

GET /lls/v1.0/stream

Query Parameters

Parameter	Type	Required	Description
domain	String	Optional	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.

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"
    },
    {
      "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",
      "latestStreamingAt": "2025-07-11T14:28:00Z",
      "status": "banned"
    }
  ]
}

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