Retrieve a track

Get the full record for a single track by its Slipstream UUID. Returns the same fields as a search result plus rights metadata (writers, publishers), lyrics, and library_name.

GET/api/v4/{language}/tracks/{id}/

Path parameters

Parameter	Description
`language`	Locale code for translatable fields. See Tracks overview.
`id`	Slipstream track UUID.

Example request

curl "https://api.slipstreammusic.com/api/v4/en/tracks/0328895e-af3f-4248-9173-69fed8ab25f5/" \
  -H "Authorization: Bearer $PARTNER_API_KEY"

Example response

{
  "id": "0328895e-af3f-4248-9173-69fed8ab25f5",
  "name": "Tonight We Dance",
  "description": "Driving indie rock with anthemic guitars.",
  "length": 87,
  "tempo": 106,
  "key": "C major",
  "is_explicit": false,
  "is_free": false,
  "vocals": "instrumental",
  "audio_url": "/api/v4/stream/0328895e-af3f-4248-9173-69fed8ab25f5/?type=track",
  "short_id": "tnwdnc",
  "short_url": "https://slipstreammusic.com/t/tnwdnc",
  "genre_name": "Rock",
  "subgenre_name": "Indie Rock",
  "mood_name": "Uplifting",
  "secondary_mood_name": "Uplifting",
  "artist": { "name": "Swami G", "slug": "swami-g" },
  "album": {
    "id": "8a4b2c1d-9e7f-4a6b-b3c2-1f8d4e5a7c6b",
    "url": "/albums/late-night-anthems",
    "name": "Late Night Anthems",
    "slug": "late-night-anthems",
    "all_image_sizes": { "small": "...", "medium": "...", "large": "..." },
    "blurhash": "L6PZfSi_..."
  },
  "is_sfx": false,
  "has_stems": true,
  "cover": "https://...",
  "library_name": "Slipstream Originals",
  "lyrics": "",
  "jp_title": "Tonight We Dance",
  "writers": [
    { "name": "Jane Doe", "share": 50, "pro": "ASCAP", "ipi": "00123456789" },
    { "name": "John Smith", "share": 50, "pro": "BMI", "ipi": "00987654321" }
  ],
  "publishers": [
    { "name": "Slipstream Publishing", "share": 100, "pro": "ASCAP", "ipi": "00111222333" }
  ]
}

Response fields

Field	Description
`id`	Slipstream track UUID.
`name`	Display title (JP-suffix stripped, variant-appended where applicable).
`description`	Free-text description. May be empty.
`length`	Duration in seconds.
`tempo`	BPM. May be `null` for tracks without analyzed tempo.
`key`	Musical key. May be `null`.
`is_explicit`	`true` if marked explicit.
`is_free`	Always `false` on this endpoint. Kept for backwards compatibility with the v3 contract — use the search endpoints’ `is_free` (computed from `restricted`) if you need a real value.
`vocals`	`"instrumental"`, `"male"`, `"female"`, `"mixed"`, or `"unknown"`.
`audio_url`	Stream proxy path. Redirects to a short-lived presigned S3 URL.
`short_id`, `short_url`	Public Slipstream link to the track.
`genre_name`, `subgenre_name`, `mood_name`, `secondary_mood_name`	Primary classifications, translated to the requested `language`.
`artist`	Artist with `name` and `slug`.
`album`	Album object with `id`, `name`, `slug`, `url`, `all_image_sizes`, `blurhash`. `null` if the track isn’t on an album.
`is_sfx`	Always `false` for tracks. (Sound effects come from the `soundfxs/` endpoint.)
`has_stems`	`true` if individual stems are available.
`cover`	Cover image URL.
`library_name`	Catalog the track belongs to.
`lyrics`	Lyrics text. Empty string for instrumentals.
`jp_title`	Raw title as it appears in the JinglePunks catalog feed (the `jp` source). JinglePunks-sourced tracks get a `-JP` suffix appended to their raw title to disambiguate versions across sources; `jp_title` preserves that suffix, while `name` strips it for display. Identical to `name` for tracks not sourced from JinglePunks.
`writers`	Songwriters with `name`, `share` (% of writer split), `pro`, `ipi`. Returned only when rights data is complete and shares sum to ~100%. Empty otherwise.
`publishers`	Publishers with `name`, `share`, `pro`, `ipi`. Same completeness rule as `writers`.

Errors

HTTP	When
404	Track UUID doesn’t exist or isn’t visible to your account (regional/library restrictions).

Overview Overview