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.
advertising:readGrant 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
- 200
- 401
- 403
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.