TrackV2

Full track. Returned only by GET /v2/tracks/{id}.

idintegerrequired

isrcstringrequired

titlestringrequired

artistNamestringrequired

The track's artist name.

releaseTitlestringrequired

Track.releaseTitle (pass-through).

explicitnessExplicitness (string)required

Explicitness status of the track

Possible values: [explicit, clean, censored, unknown]

artwork objectnullablerequired

The track's artwork, or null when the track has no artwork.

urlstringrequired

Signed CDN URL.

expiresAtdate-timerequired

Signing-time expiry.

widthintegerrequired

heightintegerrequired

durationMsintegerrequired

Track duration in milliseconds.

releaseYearintegernullablerequired

Release year, or null when not available.

bpmintegerrequired

ratingRatingV2 (string)required

Content rating.

Possible values: [G, PG, PG-13, R, NC17, unknown]

transcodes object[]

Available transcodes for the requested format.

Array [

idintegerrequired

urlstringrequired

Signed CDN URL.

expiresAtdate-timerequired

Signing-time expiry.

encodingstringrequired

bitrateintegerrequired

containerstringrequired

Container format (mp3 or mp4).

gainnumbernullablerequired

Always present: a number on track transcodes, and null on clip transcodes.

]

createDatedate-timerequired

lastUpdateDatedate-timerequired

defaultClip objectnullablerequired

The track's default (curated) clip, or null when it has none.

idintegerrequired

startMsintegerrequired

Clip.clipStartMs (drop clip prefix).

stopMsintegerrequired

Clip.clipEndMs (drop clip prefix).

durationMsintegerrequired

Computed: stopMs - startMs.

transcode objectrequired

A playable transcode. url is signed per request; expiresAt is the signing time.

idintegerrequired

urlstringrequired

Signed CDN URL.

expiresAtdate-timerequired

Signing-time expiry.

encodingstringrequired

bitrateintegerrequired

containerstringrequired

Container format (mp3 or mp4).

gainnumbernullablerequired

Always present: a number on track transcodes, and null on clip transcodes.

TrackV2

{
  "id": 0,
  "isrc": "string",
  "title": "string",
  "artistName": "string",
  "releaseTitle": "string",
  "explicitness": "explicit",
  "artwork": {
    "url": "string",
    "expiresAt": "2024-07-29T15:51:28.071Z",
    "width": 0,
    "height": 0
  },
  "durationMs": 0,
  "releaseYear": 0,
  "bpm": 0,
  "rating": "G",
  "transcodes": [
    {
      "id": 0,
      "url": "string",
      "expiresAt": "2024-07-29T15:51:28.071Z",
      "encoding": "string",
      "bitrate": 0,
      "container": "string",
      "gain": 0
    }
  ],
  "createDate": "2024-07-29T15:51:28.071Z",
  "lastUpdateDate": "2024-07-29T15:51:28.071Z",
  "defaultClip": {
    "id": 0,
    "startMs": 0,
    "stopMs": 0,
    "durationMs": 0,
    "transcode": {
      "id": 0,
      "url": "string",
      "expiresAt": "2024-07-29T15:51:28.071Z",
      "encoding": "string",
      "bitrate": 0,
      "container": "string",
      "gain": 0
    }
  }
}