Get campaign suggestion set

GET /api/v2/buyer/campaign-suggestion-sets/:campaignSuggestionSetId Returns one campaign suggestion set with the full per-media-buy breakdown — which media buys give up budget, which receive it, and how much. This is the view to read before deciding, because the breakdown is what makes the transfer legible. See campaign suggestion sets for the lifecycle and what each status means.

Request

curl https://api.apostra.com/api/v2/buyer/campaign-suggestion-sets/77 \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

No request body.

Parameters

Field	Type	Required	Notes
`campaignSuggestionSetId`	string	Yes	Set id (path parameter) — digits only, no leading zero, up to 18 digits.

Response

{
  "campaignSuggestionSetId": "77",
  "optimizerRunId": "8f14e45f-ceea-4c11-8e94-1c1a3c1e2f21",
  "campaignId": "cmp_987654321",
  "campaignDbId": "1042",
  "campaignName": "Nike Q1 Brand Awareness",
  "campaignRunSequence": "42",
  "campaignMediaBuyCount": 2,
  "budgetCurrency": "USD",
  "applyMode": "MANUAL",
  "status": "AWAITING_APPROVAL",
  "statusReason": null,
  "netAllocationDelta": "0",
  "notifiedAt": "2026-08-19T06:00:12.400Z",
  "decidedAt": null,
  "appliedAt": null,
  "applyAttemptCount": 0,
  "compensationAttemptCount": 0,
  "firstMessageAt": "2026-08-19T06:00:09.100Z",
  "lastMessageAt": "2026-08-19T06:00:11.800Z",
  "mediaBuys": [
    {
      "suggestionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "adcpMediaBuyId": "MB1",
      "mediaBuyName": "Display - Programmatic",
      "netAllocationDelta": "-400000",
      "appliedAt": null
    },
    {
      "suggestionId": "5c9e1a02-8f3b-4d21-9a77-6b1e2c4d8f90",
      "adcpMediaBuyId": "MB2",
      "mediaBuyName": "Video - CTV",
      "netAllocationDelta": "400000",
      "appliedAt": null
    }
  ]
}

Reading the numbers

Every allocation figure is an exact count of budgetCurrency’s minor unit, sent as a string. "-400000" on a USD campaign is $4,000 leaving that media buy. A member’s netAllocationDelta is deliberately not zero — it is that media buy’s side of the transfer, and it is always present. The set’s own netAllocationDelta is what must be zero, and it is the sum of its members; it is null until the set is complete, because there is nothing balanced to report yet. If you add the members up and get anything other than zero, the set will not be actionable. The values are strings because they are int64 counts surfaced as decimal strings, not because they are large. Do not route them through a float. applyMode tells you who decides: MANUAL means this set is waiting on you, AUTO means optimizations apply without review and the set was approved on arrival. It is read from the campaign, falling back to the advertiser’s default, and fixed when the run is first seen.

Reading an applying or applied set

Once a set is approved, these fields describe how the transfer is going. See what happens after you approve for the behaviour behind them.

Field	What it tells you
`appliedAt` (on the set)	When the transfer finished. `null` until it settles.
`appliedAt` (on a member)	When that media buy’s seller accepted the change. Acceptance is not enactment — the seller may still be queuing it.
`applyAttemptCount`	How many times the transfer has started applying. A clean run reads `1`. Above that means a seller was slow or a dispatch was retried, not that anything is wrong.
`compensationAttemptCount`	How many times the reversal has been attempted. Above `0` means the transfer failed part-way and is being put back.
`statusReason`	Plain-language detail for the current status. On `APPLIED` it names any media buy skipped because its flight had ended; on `COMPENSATING` or `NEEDS_RECONCILIATION` it says what went wrong.

A member with an appliedAt on a set that later reads COMPENSATED was changed and then changed back, so the value on the media buy is its pre-approval budget — unless statusReason names it as one the reversal could not reach, in which case it may still be sitting at the suggested one. Whether an approved set applies automatically at all depends on rollout — see availability.

Errors

Status	When
`404`	No such set, or it belongs to another account.
`400`	Malformed set id.

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

Get campaign suggestion set

Request

Parameters

Response

Reading the numbers

Reading an applying or applied set

Errors

​Request

​Parameters

​Response

​Reading the numbers

​Reading an applying or applied set

​Errors

Request

Parameters

Response

Reading the numbers

Reading an applying or applied set

Errors