Query a Stream

Query a stream by stream ID

Request

Request-Line

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

Request

Path Parameters

Name	Type	Required	Description
streamId	String	Mandatory	Stream id.

Response

Response Body

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. Default is now.
updated	Timestamp	Optional	Timestamp of updated time in UTC timezone.
status	String	Mandatory	Status of domain. Valid values: banned.
latestStreamingAt	Timestamp	Mandatory	Timestamp in UTC timezone when latest streaming began.
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

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, check API calls to comply with the rate limit below:

• 100 requests per minute
• 1000 requests per hour