Get Rule Dayparting Schedule
GET/api/advertising/rules/:rule/dayparting
Returns the dayparting schedules learned by the rule's latest completed real run, keyed by campaign ID. Each schedule holds a bid multiplier per ISO weekday (1 = Monday ... 7 = Sunday) and hour (0-23, in the account time zone), smoothed and clamped to the rule's multiplier range (0.5-1.5 by default), plus the per-hour multipliers across the week.
advertising:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Each campaign also carries applied_multipliers: the effective multiplier the ad platform actually confirmed, per ISO weekday and hour (applied bid ÷ base bid, averaged across the campaign's targets), so what ran can be compared with what was learned. Only applied bids count: a bid that failed, was skipped (hold, cap or drift), rejected, expired or undone leaves no entry. For a campaign in hourly_bids mode it is filled by hourly bid changes; for a campaign in bid_schedule mode it is the schedule the platform confirmed on the latest applied bid-schedule change. It is an empty object until something has applied.
mode is bid_schedule when the platform accepts a native bid schedule (the run proposes it as a change) or hourly_bids when SKU.io applies hourly bid changes instead. campaigns is an empty object when the rule is not a dayparting rule or has not completed a run.
Requires the advertising.view permission and the Advertising Manager feature.
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.