---
title: "Movie Metrics"
method: GET
path: "/svm/movies/{id}/metrics"
tags: ["Movies"]
---

# Movie Metrics

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

Retrieves metrics for a movie

## Path parameters

- `id` string, required

## Query parameters

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

## Headers

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

## Response `200`

OK

- SuccessfulResponseMovieMetricsResponse
  - `data` MovieMetricsResponse
    - `id` string — Unique Luminate ID assigned to the movie
    - `metrics` Metric[] — Consumption data for the movie
      - `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
    - `demographics` DemographicsResponse[] — Demographic data for the movie
      - `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)