Skip to main content

List Guardrail Signals

GET 

/api/advertising/signals

Lists guardrail signals: problems the guardrail evaluation found with a product's advertising on one ad account (e.g. spending with low stock cover, ACoS above break-even). Each signal carries its type, severity, status, the product and account, a readable reason, the proposed action, whether it is actionable (and why not), any event freeze holding it (frozen_by), the raw evaluation metrics, the policy that raised it and the change set proposed for it.

Required scope: advertising:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

change_set_made_under_older_policy is true when the signal's pending change set was planned under a policy that has since changed; use Regenerate Guardrail Signal Change Set to replace it.

Filters (filter[...], comma-separated lists accepted):

  • status: open, resolved, snoozed, dismissed.
  • type: low_cover_spend, stockout_spend, delivery_promise_slip, acos_above_break_even, ad_rate_above_break_even, overstock_underspend, unmapped_spend, buy_box_lost_spend.
  • severity: critical, high, medium, low.
  • platform: platform(s) of the signal's ad account.
  • product_id, ad_account_id, ad_change_set_id: exact match.

Sorts (sort, prefix - for descending): id, first_raised_at, last_evaluated_at, severity, signal_type. Default -id (newest first).

Pagination: per_page defaults to 10 (max 200); page selects the page.

Requires the advertising.view permission. Personal access tokens need the advertising:read scope.

Request​

Responses​

OK

Response Headers
    Content-Type