---
title: "Musical Release Groups"
method: GET
path: "/musical_release_groups/{id}"
tags: ["Musical Release Groups"]
---

# Musical Release Groups

`GET /musical_release_groups/{id}`

## Request

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

Receive metadata and consumption data for a Musical Release Group using a Luminate ID or (external_ids) ICPN or GRID.

## Path parameters

- `id` string, required: Unique Luminate ID, ICPN, or GRID assigned to the Musical Release Group.

## Query parameters

- `id_type` 'luminate' | 'icpn' | 'grid', required
- `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'
- `sales_type` string[]
- `distribution_channel` 'digital' | 'physical' | 'none'
- `purchase_method` 'online' | 'storefront' | 'none'
- `store_strata` string[]
- `product_format` string[]
- `airplay_formats` string[]: Retrieve the airplay data for one or multiple airplay formats. Full list of supported airplay formats can be found in the "Luminate IDs" folder in the Guides tab.
- `airplay_format_filter` string

## Headers

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

## Response `200`

OK

- MusicalReleaseGroupResponse
  - `id` string
  - `icpn` string[]
  - `grid` string[]
  - `start_date` string
  - `end_date` string
  - `location` string
  - `title` string
  - `display_artist_name` string
  - `artists` Artist[]
    - `name` string
    - `role` string
    - `id` string
  - `release_date` string
  - `duration` string
  - `genres` Genre[]
    - `domain` string
    - `main_genre` string
    - `genres` string[]
  - `languages` string[]
  - `parental_warning_type` string
  - `label` string
  - `compilation_type` string
  - `release_type` string
  - `external_ids` object
  - `relationships` object[]
  - `metrics` union[]
    - union
      - MetricAirplayFormatValue
        - `format_name` string
        - `format_id` string
        - `value` integer
      - MetricDayValue
        - `date` string
        - `value` number
      - MetricMarketValue
        - `market_name` string
        - `market_id` string
        - `value` union[]
          - union
            - MetricAirplayFormatValue
              - …
            - MetricDayValue
              - …
            - MetricMarketValue (recursive)
            - MetricResponse
              - …
            - MetricValue
              - …
            - MetricWeekValue
              - …
      - MetricResponse
        - `name` string
      - MetricValue
        - `name` string
        - `value` number
      - MetricWeekValue
        - `start_date` string
        - `end_date` string
        - `value` number

---

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