Skip to main content

Get Listing Price Push Preview

GET 
/api/v2/sales-channels/:integrationInstance/prices/listings/:productListing/preview

What the next price push would do for one listing, judged by exactly the same gate the push itself uses — so the preview can never disagree with the run about a floor, a ceiling or a maximum-change verdict. Nothing is transmitted.

Required scope: integrations:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Authentication: Requires Bearer token.

Requires the integrations.view permission (API tokens: integrations:read scope).

Response data:

  • eligible (boolean): SKU.io is the active master of price for this listing on this channel
  • master_of_price (string|null): the active master as the listing resolves it — sku.io, sales_channel or neither
  • profile (object|null): the effective pricing sync profile {id, name, source}, where source is listing, product or channel; null when the channel's inline settings apply
  • priced_from (object|null): {tier_id, tier_name, price} — the pricing level the cached price came from
  • sku_price (number|null): the price SKU.io would send before any bound moves it
  • channel_price (number|null): what the channel currently shows, as SKU.io last saw it
  • floor / ceiling (object|null): null when the policy has none; otherwise {type, tier_id, tier_name, value, action, applies, hit, detail} — applies is false when the bound could not be resolved for this product (e.g. no MAP price), hit is true when the price crosses it, and detail is the sentence the push would record
  • max_delta (object|null): {pct, last_pushed_price, change_pct, exceeded, action} — the maximum-change limit measured against the last pushed price
  • verdict (string): push (a price would be sent, possibly adjusted by a bound), unchanged (the channel already holds it), skip (no price or no channel SKU), block (a guardrail refused it) or not_eligible (SKU.io is not the master of price — the policy shown is what a pin to SKU.io would put in force)
  • detail (string): one sentence explaining the verdict
  • would_send (number|null): the figure that would actually be transmitted after any bound adjusted it; null unless the verdict is push

Returns 403 when the listing does not belong to this integration instance, and 422 when the channel does not support outbound price push.

Request​

Responses​

OK

Response Headers
    Content-Type