v1

latestOpenAPI 3.0.2Terms of Use2026-08-061441681.6 MB
usage_real_time_streams

Fetch usage for a single real-time stream

(Available from version 1.9) This operation returns CDN usage details for a specific stream target. Defaults: from = last billing date, to = end of current day.

get/usage/real_time_streams/{id}

Path parameters

idstring required

The unique alphanumeric string that identifies the stream target.

Query parameters

fromstring date-time

The start of the range of time you want to view. Specify YYYY-MM-DD HH:00:00 where HH is a 24-hour clock in UTC. The range doesn't include minutes and seconds and rounds minutes up to the hour. The maximum difference between from and to is 90 days. If you set the from query parameter without setting the to query parameter, the data returned will reflect 90 days starting at the from date, or data up to to the current day, whichever is shorter.

You can also specify last_bill_date.

Default: last billing date

tostring date-time

The end of the range of time you want to view. Specify YYYY-MM-DD HH:00:00 where HH is a 24-hour clock in UTC. The range doesn't include minutes and seconds and rounds minutes up to the hour. The maximum difference between from and to is 90 days. If you set the to query parameter without setting the from query parameter, the data returned will be from the past 90 days or from your last invoice date, whichever is shorter.

You can also specify last_bill_date.

Default: end of the current day

Response

Success

Example response

{
  "real_time_stream": {
    "id": "tvctq36g",
    "name": "My Real Time Stream",
    "bytes_in": 222,
    "bytes_out": 0
  },
  "limits": {
    "from": "2019-11-07T00:00:00.000Z",
    "to": "2019-12-05T00:00:00.000Z"
  }
}