Get campaign tier allocation

GET

campaigns

{campaignId}

tiers

curl --request GET \
  --url https://api.getsoundlink.com/v1/campaigns/{campaignId}/tiers \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

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

{
  "data": {
    "lastUpdate": "2026-01-01T00:00:00Z",
    "tiers": [
      {
        "tierId": 1,
        "tierName": "US",
        "isEnabled": true,
        "allocationPercent": 60
      },
      {
        "tierId": 2,
        "tierName": "UK",
        "isEnabled": false,
        "allocationPercent": 40
      }
    ]
  },
  "meta": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Authorizations

x-api-key

string

header

required

Pass your Soundlink sk_* API key in the x-api-key header. Keys can carry explicit scopes (for example campaigns:read, metrics:read, videos:write) enforced by the backend.

Deprecated, retiring 2026-08-17 — migrate to Authorization: Bearer sk_... (see apiKeyBearerAuth) before then.

Path Parameters

campaignId

string

required

Campaign identifier (UUID)

Response

Campaign tier allocation

data

object

required

Show child attributes

meta

object

required

Show child attributes

Get campaign tier allocation

curl --request GET \
  --url https://api.getsoundlink.com/v1/campaigns/{campaignId}/tiers \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

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

{
  "data": {
    "lastUpdate": "2026-01-01T00:00:00Z",
    "tiers": [
      {
        "tierId": 1,
        "tierName": "US",
        "isEnabled": true,
        "allocationPercent": 60
      },
      {
        "tierId": 2,
        "tierName": "UK",
        "isEnabled": false,
        "allocationPercent": 40
      }
    ]
  },
  "meta": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

System

Campaigns

Metrics

Videos

Get campaign tier allocation

Authorizations

Path Parameters

Response