---
title: "Get music choreo steps"
method: GET
path: "/dcd/music/{id}/choreo_steps"
tags: ["dcd-music"]
---

# Get music choreo steps

`GET /dcd/music/{id}/choreo_steps`

Retrieve a list of available choreo steps for a given music.

## Path parameters

- `id` integer, required

## Response `200`

List of available choreo steps.

- ChoreoStep[]
  - `name` string, required — The name of the choreo step.
  - `type` string, required — The type of choreo step.
  - `thumbnail` string, required — The URL to the thumbnail for the choreo step.
  - `mini_video` string, required — The URL to the video for the choreo step.
  - `start_time` string, required — The start time for the choreo step in reference to the music. Format in mm:ss.
  - `version` integer — The version of the returned entity

## Other responses

- `304` — If the If-None-Match header is sent and matches with the Etag it will return the 304 (Not Modified) response without the data on the body.
- `403` — User does not have permissions to retrieve music.
- `404` — The music provided doesn't have choreo steps associated.

---

[API](https://skmtc.net/zumba/apis/zumba-s-api.md) · [All operations](https://skmtc.net/zumba/apis/zumba-s-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zumba/zumba-s-api/revisions/90e715bcdf3d/schema)