Skip to main content
GET /api/v2/buyer/plan-suggestion-sets/:planSuggestionSetId Returns one plan 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 plan suggestion sets for the lifecycle and what each status means.

Request

No request body.

Parameters

Response

Reading the numbers

Every allocation figure is an exact count of budgetCurrency’s minor unit, sent as a string. "-400000" on a USD plan 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. applyAttemptCount and compensationAttemptCount relate to automatic application of an approved set, which is not yet enabled — both are 0.

Errors