Skip to main content

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.

Required scope: advertising:read

Grant 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 in m/d/Y, interpreted in the account's timezone; date_to is inclusive and must be on or after date_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​

OK

Response Headers
    Content-Type