Skip to main content
GET
/
v1
/
campaigns
List campaigns
curl --request GET \
  --url https://api.getsoundlink.com/v1/campaigns \
  --header 'x-api-key: <api-key>'
{ "data": { "items": [ { "campaignId": "camp_abc123", "organizationId": "org_xyz", "status": "active", "socialPlatform": "meta", "dailyBudget": 20, "totalBudget": 140, "campaignDuration": 7, "createdAt": "2026-04-01T10:00:00Z", "updatedAt": "2026-04-08T12:00:00Z" } ], "pagination": { "page": 1, "pageSize": 10, "totalCount": 42, "totalPages": 5 } }, "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) enforced by the backend.

Query Parameters

​
page
integer
default:1

Page number (1-indexed)

Required range: x >= 1
​
pageSize
integer
default:10

Items per page (max 100)

Required range: 1 <= x <= 100
​
sortBy
enum<string>
default:createdAt
Available options:
createdAt,
status
​
sortOrder
enum<string>
default:desc

Sort direction

Available options:
asc,
desc

Response

Paginated list of campaigns

​
data
object
required
​
meta
object
required