Synup
Create a key
v1Resources/Paid Boosts/getList boosts

List boosts

Lists the workspace's boosts, newest first: status, whether it is deferred, budget, spend so far, the post it promotes and the control that applies. Up to 50 per page.

get/api/v1/boosts
boosts:read
Query parameters
postIdstringoptional
Only boosts of this post.
statusstringoptional
Only this status, for example awaiting_publish, active, paused, stopped, cancelled, completed, rejected or error.
activeOnlybooleanoptional
True returns only boosts that can still be stopped or cancelled.
pageintegeroptional
The page number, from 1.
limitintegeroptional
Boosts per page, 1 to 50.
Response
dataobjectoptional
boostsarray of objectoptional
The boosts.
totalintegeroptional
How many boosts match.
pageintegeroptional
This page's number.
perPageintegeroptional
How many boosts a page holds.
hasMorebooleanoptional
True when there is another page.
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
429Too many requests. Retry after the number of seconds in the Retry-After header.
get/api/v1/boosts
Your API key
postId
status
activeOnly
page
limit
{
  "data": {
    "boosts": [
      {
        "adRunId": "run_123",
        "adCampaignId": "camp_123",
        "postId": "post_123",
        "platform": "facebook",
        "status": "active",
        "deferred": false,
        "control": "stop_post_boost",
        "dailyBudget": 2500,
        "durationDays": 7,
        "startAt": "2026-10-12T09:00:00.000Z",
        "endAt": "2026-10-19T09:00:00.000Z",
        "createdAt": "2026-10-12T08:55:00.000Z",
        "stoppedAt": null,
        "spend": 36.2,
        "impressions": 4210,
        "clicks": 98
      }
    ],
    "total": 1,
    "page": 1,
    "perPage": 50,
    "hasMore": false
  }
}

New to the Synup API?