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

# Season Metrics

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

Retrieves metrics for a season of a TV show

## Path parameters

- `id` string, required
- `season` string, required

## Query parameters

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

## Headers

- `CF-IPCountry` string
- `email` string

## Response `200`

OK

- SuccessfulResponseSeasonMetricsResponse
  - `data` SeasonMetricsResponse
    - `id` string — Unique Luminate ID assigned to the TV show
    - `metrics` Metric[] — Consumption data for the season
      - `name` 'minutes_watched' | 'views' | 'duration_to_date' — Name of metric
      - `granularity` 'daily' — Level of aggregation of the consumption data
      - `value` DataPoint[] — Time series of the metric
        - `date` string, date
        - `value` integer
        - `data_status` 'official' | 'preliminary' — Status of the consumption data
        - `duration_to_date` integer
    - `season` string — ID of the TV show’s season
    - `demographics` DemographicsResponse[] — Demographic data for the season
      - `name` string — Demographic breakout category.
      - `confidence` string — Confidence level for the demographic breakout values. Values can be low, medium, or high if demographic data is provided for the selected title and time frame. Value will be “Not Available” if demographic data cannot be provided.
      - `value` DemographicsValue[] — Demographic data breakout values.
        - `value` string
        - `percentage_of_total` integer

## Other responses

- `207` — Partial data returned
- `400` — Issue with client request
- `404` — Series or season not found

---

[API](https://skmtc.net/luminatedata/apis/authentication.md) · [All operations](https://skmtc.net/luminatedata/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/luminatedata/authentication/revisions/81d2bd1553e1/schema)