---
title: "List Usage"
method: GET
path: "/video/v1/delivery-usage"
tags: ["Delivery Usage"]
---

# List Usage

`GET /video/v1/delivery-usage`

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

## Query parameters

- `page` integer
- `limit` integer
- `asset_id` string
- `live_stream_id` string
- `timeframe[]` string[]

## Response `200`

OK

- ListDeliveryUsageResponse
  - `data` DeliveryReport[], required
    - `live_stream_id` string — Unique identifier for the live stream that created the asset.
    - `asset_id` string, required — Unique identifier for the asset.
    - `passthrough` string — The `passthrough` value for the asset.
    - `created_at` string, required — 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` 'ready' | 'errored' | 'deleted', required — The state of the asset.
    - `asset_duration` number, double, required — The duration of the asset in seconds.
    - `asset_resolution_tier` 'audio-only' | '720p' | '1080p' | '1440p' | '2160p', required — The resolution tier that the asset was ingested at, affecting billing for ingest & storage
    - `asset_encoding_tier` 'smart' | 'baseline' | 'premium', required — 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.](https://docs.mux.com/guides/use-video-quality-levels)
    - `asset_video_quality` '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.](https://docs.mux.com/guides/use-video-quality-levels)
    - `delivered_seconds` number, double, required — Total number of delivered seconds during this time window.
    - `delivered_seconds_by_resolution` object, required — Seconds delivered broken into resolution tiers. Each tier will only be displayed if there was content delivered in the tier.
      - `tier_2160p` number, double — Total number of delivered seconds during this time window that had a resolution larger than the 1440p tier (over 4,194,304 pixels total).
      - `tier_1440p` number, double — 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).
      - `tier_1080p` number, double — 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).
      - `tier_720p` number, double — 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).
      - `tier_audio_only` number, double — Total number of delivered seconds during this time window that had a resolution of audio only.
  - `total_row_count` integer, required
  - `timeframe` integer[], required
  - `limit` integer, required — Number of assets returned in this response. Default value is 100.

---

[API](https://skmtc.net/muxinc/apis/mux-api.md) · [All operations](https://skmtc.net/muxinc/apis/mux-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/muxinc/mux-api/revisions/34a65dce0f31/schema)