Skip to Content

Delivery Usage

The Delivery Usage API allows you to get delivery/streaming usage details for each asset and across all assets. Delivery usage details are aggregated every hour at the top of the hour and can be requested for a specified time window within the last 90 days starting at 12 hours prior to when the request is made.

Assets are ordered by delivery usage starting with the one with the highest usage. Only assets with delivery usage greater than 0 seconds are returned in the response.

live_stream_id
string

Unique identifier for the live stream that created the asset.

asset_id
string

Unique identifier for the asset.

passthrough
string

The passthrough value for the asset.

created_at
string

Time at which the asset was created. Measured in seconds since the Unix epoch.

deleted_at
string

If exists, time at which the asset was deleted. Measured in seconds since the Unix epoch.

asset_state
string
Possible values: "ready""errored""deleted"

The state of the asset.

asset_duration
number

The duration of the asset in seconds.

asset_resolution_tier
string
Possible values: "audio-only""720p""1080p""1440p""2160p"

The resolution tier that the asset was ingested at, affecting billing for ingest & storage

asset_encoding_tierDeprecated
string
Possible values: "smart""baseline""premium"

This field is deprecated. Please use asset_video_quality instead. The encoding tier that the asset was ingested at. See the video quality guide for more details.

asset_video_quality
string
Possible values: "basic""plus""premium"

The video quality that the asset was ingested at. This field replaces asset_encoding_tier. See the video quality guide for more details.

delivered_seconds
number

Total number of delivered seconds during this time window.

delivered_seconds_by_resolution
object

Seconds delivered broken into resolution tiers. Each tier will only be displayed if there was content delivered in the tier.

delivered_seconds_by_resolution.tier_2160p
number

Total number of delivered seconds during this time window that had a resolution larger than the 1440p tier (over 4,194,304 pixels total).

delivered_seconds_by_resolution.tier_1440p
number

Total number of delivered seconds during this time window that had a resolution larger than the 1080p tier but less than or equal to the 2160p tier (over 2,073,600 and <= 4,194,304 pixels total).

delivered_seconds_by_resolution.tier_1080p
number

Total number of delivered seconds during this time window that had a resolution larger than the 720p tier but less than or equal to the 1440p tier (over 921,600 and <= 2,073,600 pixels total).

delivered_seconds_by_resolution.tier_720p
number

Total number of delivered seconds during this time window that had a resolution within the 720p tier (up to 921,600 pixels total, based on typical 1280x720).

delivered_seconds_by_resolution.tier_audio_only
number

Total number of delivered seconds during this time window that had a resolution of audio only.