List Guardrail Policies
GET/api/advertising/guardrail-policies
Lists every guardrail policy: the tenant default first, then by scope type and ID. A policy sets the guardrail thresholds and automation mode (off, monitor, suggest, auto) for a scope: tenant, platform (scope_id is a platform value), ad_account, campaign, brand or product (scope_id is that record's ID). For a given product and account, the more specific policies override the less specific ones field by field. Each row includes affected_products, the number of evaluated products the policy's scope covers. Not paginated.
advertising:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Filters: filter[scope_type] (or scope_type) and filter[mode] (or mode); unknown values are ignored.
last_dry_run_results holds the latest 7-day replay (proposed changes, products affected, estimated spend saved, signal counts by type and up to a sample of the changes). auto_unlocked_until is when that dry run stops counting for switching the policy to auto (7 days after it ran).
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.