Sign in
Delivery Usage

List Usage

Returns a list of delivery usage records and their associated Asset IDs or Live Stream IDs.

get/video/v1/delivery-usage

Query parameters

pageinteger

Offset by this many pages, of the size of limit

limitinteger

Number of items to include in the response

asset_idstring

Filter response to return delivery usage for this asset only. You cannot specify both the asset_id and live_stream_id parameters together.

live_stream_idstring

Filter response to return delivery usage for assets for this live stream. You cannot specify both the asset_id and live_stream_id parameters together.

timeframe[]string[]

Time window to get delivery usage information. timeframe[0] indicates the start time, timeframe[1] indicates the end time in seconds since the Unix epoch. Default time window is 1 hour representing usage from 13th to 12th hour from when the request is made.

Response

OK

total_row_countinteger required
timeframeinteger[] required
limitinteger required

Number of assets returned in this response. Default value is 100.

Changes

Changed in 3 of the 28 revisions of this API.14

  • ba7ebfd893a11See the full diff
    • ○

      the endpoint scheme security authorizationToken was added to the API

      api-security-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • d4d7fca3b7381See the full diff
    • ○

      the endpoint scheme security accessToken was added to the API

      api-security-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 5bc9dec57cc412See the full diff
    • ●

      added the new premium enum value to the data/items/asset_encoding_tier response property for the response status 200

      response-property-enum-value-added

    • ○

      added the optional property data/items/asset_video_quality to the response with the 200 status

      response-optional-property-added

    • ○

      response property data/items/asset_encoding_tier deprecated

      response-property-deprecated

    This revision also has 23 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog