List Change Sets
GET/api/advertising/change-sets
Lists change sets, newest first (ordered by id descending). A change set is a batch of proposed ad changes (bids, budgets, states, ad rates and so on) for one ad account; every write SKU.io makes to an ad platform goes through one, whether it came from a person, a guardrail, a rule, a launch, an undo or a bulksheet import.
advertising:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Filters (all optional, plain query parameters):
status: one status or a comma-separated list, e.g.applied,partially_applied. Values:draft,simulated,pending_approval,approved,applying,applied,partially_applied,failed,rejected,expired,reverted,superseded(replaced by an edited copy; never approved or applied).source:manual,guardrail,rule,launch,mcp,undo,optimizer,allocator,bulksheet,anomaly.platform:amazon_ads,ebay,google_ads,walmart_connect,meta_ads,tiktok_ads.ad_account_id: an existing ad account ID.product_id: sets with at least one line for this product.date_from/date_to: creation date range inm/d/Y, interpreted in the account's timezone;date_tois inclusive and must be on or afterdate_from.
Pagination: per_page defaults to 10 (1 to 200); page selects the page. Sorting is fixed (newest first) and not configurable.
List rows carry line_counts (applied / failed / pending lines) instead of the full lines array; fetch a single set to get its lines.
Requires the advertising.view permission. Personal access tokens need the advertising:read scope.
status=pending_approval on its own returns only sets that can still be approved: a set whose expires_at has passed is left out even before the hourly sweep marks it expired.
Request
Responses
- 200
- 401
- 403
- 422
- 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.
Unprocessable Entity
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.