---
title: "Musical Recordings"
method: GET
path: "/musical_recordings/{id}"
tags: ["Musical Recordings"]
---

# Musical Recordings

`GET /musical_recordings/{id}`

Retrieve metadata and consumption data for a Musical Recording using a Luminate ID or ISRC.

## Path parameters

- `id` string, required — Unique Luminate ID or ISRC assigned to the Musical Recording.

## Query parameters

- `id_type` 'luminate' | 'isrc'
- `location` string — Geographic territory used in the aggregation of the consumption data. Value must be formatted according to the ISO 3166-1 alpha-2 standard. Full list of supported locations can be found in the "Luminate IDs" folder in the Guides tab.
- `start_date` string — First date used in the aggregation of the consumption data. Value must be formatted according to the ISO 8601 date standard (YYYY-MM-DD). If the start_date is not specified, the default value is 7 days prior to the current date or 7 days prior to the end_date.
- `end_date` string — Last date used in the aggregation of the consumption data. Value must be formatted according to the ISO 8601 date standard (YYYY-MM-DD). If the end_date is not specified, the default value is the current date or 7 days after the start_date.
- `chart_week` string — Represents the 7-day period (Fri-Thur) used in the aggregation of consumption data. Value must be formatted according to the ISO 8601 week standard (YYYY-Www).
- `metadata_level` 'max' | 'min'
- `external_ids` 'true' | 'false'
- `relationships` string[]
- `metrics` string[]
- `atd` string[]
- `breakouts` string[]
- `aggregate_interval` 'total' | 'day' | 'week' | 'chart_week'
- `markets` string[] — Retrieve the consumption data for one or multiple markets in the United States or Canada. Note: The Location ID and Market ID must correspond. Full list of supported markets can be found in the "Luminate IDs" folder in the Guides tab.
- `market_filter` string[] — Filter the consumption data by one or multiple markets.
- `commercial_model` 'ad_supported' | 'premium' | 'none'
- `service_type` 'on_demand' | 'programmed' | 'none'
- `content_type` 'audio' | 'video' | 'none'

## Headers

- `Accept` 'application/vnd.luminate-data.svc-apibff.v1+json'

## Response `200`

OK

---

[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)