---
title: "Changes to List breakdown values"
method: GET
path: "/data/v1/metrics/{METRIC_ID}/breakdown"
---

# Changes to List breakdown values

`GET /data/v1/metrics/{METRIC_ID}/breakdown`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 54 revisions.

- **2026-09-30** `99c1d509dcbb`: 3 warning, 3 info
- **2026-01-07** `83dc80cce4d6`: 15 info
- **2025-08-15** `36cec1d12b89`: 1 info
- **2025-08-05** `ba7ebfd893a1`: 1 info
- **2025-07-02** `d4d7fca3b738`: 1 info
- **2025-03-06** `5f3a1cefec23`: 1 info
- **2025-02-25** `2eec862e7514`: 16 info
- **2024-11-15** `59cc6a0736ea`: 2 breaking
- **2024-11-15** `5bc9dec57cc4`: 2 info

## Changes

- **2026-09-30** `99c1d509dcbb`: 3 warning, 3 info
  - deleted the `query` request parameter `filters[]`
  - deleted the `query` request parameter `metric_filters[]`
  - deleted the `query` request parameter `timeframe[]`
  - added the new optional `query` request parameter `filters`
  - added the new optional `query` request parameter `metric_filters`
  - added the new optional `query` request parameter `timeframe`
- **2026-01-07** `83dc80cce4d6`: 15 info
  - added the new enum value `audio_codec_initial` to the `query` request parameter `group_by`
  - added the new enum value `page_url` to the `query` request parameter `group_by`
  - added the new enum value `rendition_change_count` to the `path` request parameter `METRIC_ID`
  - added the new enum value `rendition_downshift_count` to the `path` request parameter `METRIC_ID`
  - added the new enum value `rendition_upshift_count` to the `path` request parameter `METRIC_ID`
  - added the new enum value `video_codec_initial` to the `query` request parameter `group_by`
  - added the new enum value `video_dynamic_range_type_initial` to the `query` request parameter `group_by`
  - added the new enum value `video_source_bitrate` to the `query` request parameter `group_by`
  - added the new enum value `video_source_bitrate_initial` to the `query` request parameter `group_by`
  - added the new enum value `video_source_fps` to the `query` request parameter `group_by`
  - added the new enum value `video_source_fps_initial` to the `query` request parameter `group_by`
  - added the new enum value `video_source_height` to the `query` request parameter `group_by`
  - added the new enum value `video_source_height_initial` to the `query` request parameter `group_by`
  - added the new enum value `video_source_width` to the `query` request parameter `group_by`
  - added the new enum value `video_source_width_initial` to the `query` request parameter `group_by`
- **2025-08-15** `36cec1d12b89`: 1 info
  - added the new enum value `video_cdn_trace` to the `query` request parameter `group_by`
- **2025-08-05** `ba7ebfd893a1`: 1 info
  - the endpoint scheme security `authorizationToken` was added to the API
- **2025-07-02** `d4d7fca3b738`: 1 info
  - the endpoint scheme security `accessToken` was added to the API
- **2025-03-06** `5f3a1cefec23`: 1 info
  - added the new enum value `video_creator_id` to the `query` request parameter `group_by`
- **2025-02-25** `2eec862e7514`: 16 info
  - added the new enum value `audio_codec` to the `query` request parameter `group_by`
  - added the new enum value `client_application_name` to the `query` request parameter `group_by`
  - added the new enum value `client_application_version` to the `query` request parameter `group_by`
  - added the new enum value `time_shift_enabled` to the `query` request parameter `group_by`
  - added the new enum value `used_captions` to the `query` request parameter `group_by`
  - added the new enum value `used_pip` to the `query` request parameter `group_by`
  - added the new enum value `video_affiliate` to the `query` request parameter `group_by`
  - added the new enum value `video_brand` to the `query` request parameter `group_by`
  - added the new enum value `video_codec` to the `query` request parameter `group_by`
  - added the new enum value `video_dynamic_range_type` to the `query` request parameter `group_by`
  - added the new enum value `view_cdn_edge_pop` to the `query` request parameter `group_by`
  - added the new enum value `view_cdn_origin` to the `query` request parameter `group_by`
  - added the new enum value `view_drm_level` to the `query` request parameter `group_by`
  - added the new enum value `viewer_plan` to the `query` request parameter `group_by`
  - added the new enum value `viewer_plan_category` to the `query` request parameter `group_by`
  - added the new enum value `viewer_plan_status` to the `query` request parameter `group_by`
- **2024-11-15** `59cc6a0736ea`: 2 breaking
  - removed the enum value `ad_watch_time` from the `path` request parameter `METRIC_ID`
  - removed the enum value `view_content_watch_time` from the `path` request parameter `METRIC_ID`
- **2024-11-15** `5bc9dec57cc4`: 2 info
  - added the new enum value `view_dropped` to the `query` request parameter `group_by`
  - added the new enum value `view_dropped_percentage` to the `path` request parameter `METRIC_ID`

---

[Operation](https://skmtc.dev/muxinc/apis/mux-api/docs/data/v1/metrics/:METRIC_ID/breakdown/get.md) - [API](https://skmtc.dev/muxinc/apis/mux-api.md) - [Page](https://skmtc.dev/muxinc/apis/mux-api/changes/data/v1/metrics/:METRIC_ID/breakdown/get)