---
title: "Tracks metadata"
method: GET
path: "/v0/tracks/metadata"
tags: ["Tracks"]
---

# Tracks metadata

`GET /v0/tracks/metadata`

The metadata endpoint returns metadata for a list of tracks.

Identify each track by either its track id or its International Standard Recording
Code (ISRC), and mix both kinds of value in the same request. The response
de-duplicates a track that you request by both its track id and its ISRC.

If a value matches no track, the response omits that track instead of returning an
error.

## Query parameters

- `trackId` string[], required

## Response `200`

Tracks response

- TrackResponse[]
  - `id` string, required — Unique ID of the track
  - `mainArtists` string[], required — The main artist that created the track.
  - `featuredArtists` string[], required — Additional artists that contributed to the track.
  - `title` string, required — Title of the track
  - `bpm` integer, required — Beats per minute for the track.
  - `length` integer, required — Track length in seconds
  - `moods` MoodResponse[], required — Lists the moods of the track.
    - `id` string, required — Unique ID of the mood
    - `name` string, required — Name of the mood
  - `genres` GenreResponse[], required — Lists the genres of the track.
    - `id` string, required
    - `name` string, required
    - `parent` ParentGenreResponse
      - `id` string, required — Unique ID of the parent genre
      - `name` string, required — Name of the parent genre
  - `images` ImagesResponse
    - `default` string, nullable
    - `M` string, nullable
    - `L` string, nullable
    - `S` string, nullable
    - `XS` string, nullable
  - `waveformUrl` string, required — Reference to the waveform as a json object.
  - `hasVocals` boolean, nullable — Set to true if the track has vocals. Set to false for instrumental tracks.
  - `added` string, required — The date the track was released in the format YYYY-mm-dd.
  - `tierOption` 'PAID' | 'FREE', nullable
  - `isrc` string, nullable — International Standard Recording Code (ISRC) of the track, e.g. "SE5Q52401263".
  - `vocalType` 'LEAD' | 'PRESENCE' | 'NONE', nullable — Granular vocal classification: LEAD (sung lead vocals), PRESENCE (vocal chops/samples/ad-libs/textures) or NONE (instrumental). Null when unknown.
  - `isExplicit` boolean, nullable
  - `isPreviewOnly` boolean

## Other responses

- `400` — Bad request.
- `401` — Unauthorized. Most likely your access token has expired.
- `429` — Rate limit exceeded.

---

[API](https://skmtc.dev/epidemicsound/apis/partner-content-api.md) · [All operations](https://skmtc.dev/epidemicsound/apis/partner-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/epidemicsound/partner-content-api/revisions/2ed2bb00fd3c/schema)