---
title: "Get metric timeseries data"
method: GET
path: "/data/v1/metrics/{METRIC_ID}/timeseries"
tags: ["Metrics"]
---

# Get metric timeseries data

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

## Request

- Base URL: `https://api.mux.com`
- URL: `https://api.mux.com/data/v1/metrics/{METRIC_ID}/timeseries`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Returns timeseries data for a specific metric.

Each interval represented in the data array contains an array with the following values:
  * the first element is the interval time
  * the second element is the calculated metric value
  * the third element is the number of views in the interval that have a valid metric value

## Path parameters

- `METRIC_ID` 'aggregate_startup_time' | 'downscale_percentage' | 'exits_before_video_start' | 'live_stream_latency' | 'max_downscale_percentage' | 'max_request_latency' | 'max_upscale_percentage' | 'page_load_time' | 'playback_failure_percentage' | 'playback_success_score' | 'player_startup_time' | 'playing_time' | 'rebuffer_count' | 'rebuffer_duration' | 'rebuffer_frequency' | 'rebuffer_percentage' | 'request_latency' | 'request_throughput' | 'rebuffer_score' | 'requests_for_first_preroll' | 'seek_latency' | 'startup_time_score' | 'unique_viewers' | 'upscale_percentage' | 'video_quality_score' | 'video_startup_preroll_load_time' | 'video_startup_preroll_request_time' | 'video_startup_time' | 'viewer_experience_score' | 'views' | 'weighted_average_bitrate' | 'video_startup_failure_percentage' | 'ad_attempt_count' | 'ad_break_count' | 'ad_break_error_count' | 'ad_break_error_percentage' | 'ad_error_count' | 'ad_error_percentage' | 'ad_exit_before_start_count' | 'ad_exit_before_start_percentage' | 'ad_impression_count' | 'ad_startup_error_count' | 'ad_startup_error_percentage' | 'playback_business_exception_percentage' | 'video_startup_business_exception_percentage' | 'view_content_startup_time' | 'ad_preroll_startup_time' | 'view_dropped_percentage' | 'rendition_change_count' | 'rendition_upshift_count' | 'rendition_downshift_count', required

## Query parameters

- `timeframe` string[]
- `filters` string[]
- `metric_filters` string[]
- `measurement` '95th' | 'median' | 'avg' | 'count' | 'sum'
- `order_direction` 'asc' | 'desc'
- `group_by` 'minute' | 'ten_minutes' | 'hour' | 'day'

## Response `200`

OK

- GetMetricTimeseriesDataResponse
  - `data` array[], required
    - union[]
      - union
        - string
        - integer, nullable
        - number, double, nullable
  - `total_row_count` integer, required
  - `timeframe` integer[], required
  - `meta` object, required
    - `granularity` string
    - `aggregation` string

## 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`
  - …2 more
- **2026-01-07** `83dc80cce4d6`: 3 info
  - 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`
- **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
- **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`

[Operation history](https://skmtc.dev/muxinc/apis/mux-api/changes/data/v1/metrics/:METRIC_ID/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/75b4251a1d96?raw)