List Rule Runs
GET/api/advertising/rules/:rule/runs
Lists a rule's runs (scheduled, manual, dry runs and backtests), newest first.
advertising:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Requires the advertising.view permission and the Advertising Manager feature.
Run status is one of pending, running, completed, failed, cancelled. skipped_counts maps a skip reason to the number of entities skipped. A real run skips an ad account (and makes no change set for it) while SKU.io automation is paused by the kill switch (automation_paused) or when the account has no write access yet (write_access_pending); dry runs and backtests are not affected. change_set_ids lists the change sets the run produced (one per ad account).
Filters: dry_run (boolean) limits to dry/projection runs (true) or real runs (false). Paginated: per_page defaults to 10, maximum 200.
Request
Responses
- 200
- 401
- 403
- 404
- 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.
Not Found
Response Headers
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.