Get campaign

GET

campaigns

{campaignId}

Get campaign

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

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

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

{
  "data": {
    "campaignId": "f1e28d31-c358-4284-9bef-00a2334625fd",
    "organizationId": "org_xyz",
    "status": "active",
    "socialPlatform": "meta",
    "dailyBudget": 20,
    "totalBudget": 140,
    "campaignDuration": 7,
    "strategyType": "custom",
    "artistId": "4gzpq5DPGxSnKTe4SA8HAU",
    "artistName": "Coldplay",
    "trackId": "3AJwUDP919kvQ9QcozQPxg",
    "playlistId": null,
    "trackName": "Yellow",
    "campaignUrl": "https://getsoundlink.com/orgs/org_xyz/insights/V1StGXR8_Z5jdHi6B-myT",
    "createdAt": "2026-04-01T10:00:00Z",
    "updatedAt": "2026-04-08T12:00:00Z"
  },
  "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

campaignId

string

required

Campaign identifier (UUID)

Response

Campaign detail

data

object

required

Show child attributes

meta

object

required

Show child attributes

Get campaign

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

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

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

{
  "data": {
    "campaignId": "f1e28d31-c358-4284-9bef-00a2334625fd",
    "organizationId": "org_xyz",
    "status": "active",
    "socialPlatform": "meta",
    "dailyBudget": 20,
    "totalBudget": 140,
    "campaignDuration": 7,
    "strategyType": "custom",
    "artistId": "4gzpq5DPGxSnKTe4SA8HAU",
    "artistName": "Coldplay",
    "trackId": "3AJwUDP919kvQ9QcozQPxg",
    "playlistId": null,
    "trackName": "Yellow",
    "campaignUrl": "https://getsoundlink.com/orgs/org_xyz/insights/V1StGXR8_Z5jdHi6B-myT",
    "createdAt": "2026-04-01T10:00:00Z",
    "updatedAt": "2026-04-08T12:00:00Z"
  },
  "meta": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

System

Wallet

Campaigns

Soundlinks

Videos

Pixels

Authorizations

Path Parameters

Response