---
title: "Artists"
method: GET
path: "/artists/{id}"
tags: ["Artists"]
---

# Artists

`GET /artists/{id}`

Receive metadata and consumption data for an Artist using a Luminate ID or ISNI.

## Path parameters

- `id` string, required — Unique Luminate ID assigned to the Artist.

## Query parameters

- `id_type` 'luminate' | 'isni'
- `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[]
- `release_type` string[]
- `discography` 'musical_release_group' | 'song' | 'none'
- `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

---

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