---
title: "Get Monitoring Breakdown Timeseries"
method: GET
path: "/data/v1/monitoring/metrics/{MONITORING_METRIC_ID}/breakdown-timeseries"
tags: ["Monitoring"]
---

# Get Monitoring Breakdown Timeseries

`GET /data/v1/monitoring/metrics/{MONITORING_METRIC_ID}/breakdown-timeseries`

Gets timeseries of breakdown information for a specific dimension and metric. Each datapoint in the response represents 5 seconds worth of data.

## Path parameters

- `MONITORING_METRIC_ID` 'current-concurrent-viewers' | 'current-rebuffering-percentage' | 'exits-before-video-start' | 'playback-failure-percentage' | 'current-average-bitrate' | 'video-startup-failure-percentage', required

## Query parameters

- `dimension` 'asn' | 'cdn' | 'country' | 'operating_system' | 'player_name' | 'region' | 'stream_type' | 'sub_property_id' | 'video_series' | 'video_title' | 'view_has_ad'
- `timeframe[]` string[]
- `filters[]` string[]
- `limit` integer
- `order_by` 'negative_impact' | 'value' | 'views' | 'field'
- `order_direction` 'asc' | 'desc'

## Response `200`

OK

- GetMonitoringBreakdownTimeseriesResponse
  - `data` MonitoringBreakdownTimeseriesValues[], required
    - `values` MonitoringBreakdownTimeseriesDatapoint[], required
      - `value` string, nullable, required
      - `metric_value` number, double, nullable, required
      - `concurrent_viewers` integer, required
      - `starting_up_viewers` integer, required
    - `date` string, required
  - `total_row_count` integer, nullable, required
  - `timeframe` integer[], required

## Changes

- **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

[Change history](https://skmtc.dev/muxinc/apis/mux-api/changes/data/v1/monitoring/metrics/:MONITORING_METRIC_ID/breakdown-timeseries/get.md)

---

[API](https://skmtc.dev/muxinc/apis/mux-api.md) · [All operations](https://skmtc.dev/muxinc/apis/mux-api/llms.txt) · [OpenAPI document](https://skmtc.dev/muxinc/apis/mux-api/revisions/34a65dce0f31?raw)