---
title: "Series Metrics"
method: GET
path: "/svm/tv_shows/{id}/metrics"
tags: ["TV Shows"]
---

# Series Metrics

`GET /svm/tv_shows/{id}/metrics`

## Request

- Base URL: `https://api.luminatedata.com`
- URL: `https://api.luminatedata.com/svm/tv_shows/{id}/metrics`
- Auth: API key in header `x-api-key` and API key in header `authorization`

Retrieves metrics for a TV show

## Path parameters

- `id` string, required

## Query parameters

- `start_date` string, date, required
- `end_date` string, date, required

## Response `200`

OK

- SuccessfulResponseSeriesMetricsResponse
  - `data` SeriesMetricsResponse
    - `id` string: Unique Luminate ID assigned to the TV show
    - `start_date` string, date: First date used in the aggregation of the consumption data. Value formatted according to the ISO 8601 date standard (YYYY-MM-DD).
    - `end_date` string, date: Last date used in the aggregation of the consumption data. Value formatted according to the ISO 8601 date standard (YYYY-MM-DD).
    - `metrics` ConsumptionMetric[]: Consumption data for the series
      - `name` 'minutes_watched' | 'views': Name of metric
      - `granularity` 'daily': Level of aggregation of the consumption data
      - `value` ConsumptionDataPoint[]: Time series of the metric
        - `date` string, date: Date of the data point
        - `value` integer: Value of the data point
        - `data_status` 'official' | 'preliminary': Status of the consumption data

## Other responses

- `207`: Partial data returned
- `400`: Issue with client request
- `404`: TV show not found

---

[API](https://skmtc.dev/luminatedata/apis/luminate-svm-api.md) - [All operations](https://skmtc.dev/luminatedata/apis/luminate-svm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/luminatedata/apis/luminate-svm-api/revisions/ff683b83f008?raw)