Get soundlink

GET

soundlinks

{soundlinkId}

Get soundlink

curl --request GET \
  --url https://api.getsoundlink.com/v1/soundlinks/{soundlinkId} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.getsoundlink.com/v1/soundlinks/{soundlinkId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "soundlinkId": "V1StGXR8_Z5jdHi6B-myT",
    "organizationId": "a7ac3173-2f71-4e79-921f-d15d7112dd11",
    "name": "Midnight Drive",
    "url": "https://sndl.ink/soundlink/V1StGXR8_Z5jdHi6B-myT",
    "targetType": "track",
    "spotifyUrl": "https://open.spotify.com/track/11dFghVXANMlKmJXsNCbNl",
    "status": "active",
    "createdAt": "2026-04-01T10:00:00Z",
    "autoFollow": true,
    "artistIdFollow": "4gzpq5DPGxSnKTe4SA8HAU",
    "metaPixelId": "1234567890123456",
    "tiktokPixelId": null
  },
  "meta": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Authorizations

Authorization

string

header

required

Pass your Soundlink sk_* API key as a Bearer token: Authorization: Bearer sk_<prefix>_<token> (not an OAuth token; see oauthBearer for that). Accepted on all Public API operations. Send only one Authorization header per request.

Path Parameters

soundlinkId

string

required

Soundlink identifier (URL-safe string, same ID used in the public sndl.ink URL)

Response

Soundlink detail

data

object

required

Show child attributes

meta

object

required

Show child attributes

Get soundlink

curl --request GET \
  --url https://api.getsoundlink.com/v1/soundlinks/{soundlinkId} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.getsoundlink.com/v1/soundlinks/{soundlinkId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "soundlinkId": "V1StGXR8_Z5jdHi6B-myT",
    "organizationId": "a7ac3173-2f71-4e79-921f-d15d7112dd11",
    "name": "Midnight Drive",
    "url": "https://sndl.ink/soundlink/V1StGXR8_Z5jdHi6B-myT",
    "targetType": "track",
    "spotifyUrl": "https://open.spotify.com/track/11dFghVXANMlKmJXsNCbNl",
    "status": "active",
    "createdAt": "2026-04-01T10:00:00Z",
    "autoFollow": true,
    "artistIdFollow": "4gzpq5DPGxSnKTe4SA8HAU",
    "metaPixelId": "1234567890123456",
    "tiktokPixelId": null
  },
  "meta": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

System

Campaigns

Soundlinks

Videos

Authorizations

Path Parameters

Response