---
title: "Chart Data"
method: GET
path: "/charts/{id}"
tags: ["Charts"]
---

# Chart Data

`GET /charts/{id}`

## Request

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

Receive metadata and ranking data for a Chart using a Luminate ID.

## Path parameters

- `id` string, required

## Query parameters

- `chart_week` string

## Response `200`

Successfully retrieved chart data

- ChartEntry
  - `id` string
  - `chart_name` string
  - `chart_owner` string
  - `entity_type` string
  - `description` string
  - `location` string
  - `depth` integer
  - `earliest_chart_week` string
  - `chart_metrics` string[]
  - `chart_week` string
  - `start_date` string
  - `end_date` string
  - `ranking` ChartRankItem[]
    - `rank` integer
    - `id` string
    - `href` string
    - `chart_history` ChartHistory
      - `premiere_week` string
      - `weeks_on` integer
      - `peak` integer
      - `low` integer
    - `chart_metrics` ChartMetric[]
      - `name` string
      - `value` integer

## Other responses

- `204`: Chart not found

---

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