Skip to main content

Get Price Sync Status

GET 
/api/v2/sales-channels/:integrationInstance/prices/settings

Read the stored price push configuration for a sales channel, together with every condition that governs whether a push can run.

Required scope: integrations:read

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

supported is false when the channel has no price push driver — nothing else in the response applies.

capability_enabled reflects the price push capability AND an active sync schedule. manual_enabled ignores a paused schedule, because a manual push still runs while the schedule is paused.

environment_allowed is false outside production for channels that restrict transmission to production.

Prices are only sent for listings where SKU.io owns the price, so is_sku_master_of_price must be true for a push to send anything.

Authentication: Requires Bearer token.

Requires the integrations.show permission.

sales_channel_id identifies the channel behind this integration. can_refresh_from_channel indicates whether this channel can re-read its own prices on demand — only channels that report live listing state can, and the rest have no way to refresh the channel-reported price.

pinned_to_sku_count — live listings on this instance pinned to SKU.io as their own master of price. The pin is the more granular setting and wins, so these are pushed on schedule even when is_sku_master_of_price is false.

Price-level sequences. pricing_tier_ids is the channel's ordered sequence of pricing level IDs, highest priority first. It is always populated — an instance that never configured a sequence reports [pricing_tier_id], the level it is actually using.

Fulfillment-channel lanes. Some channels let one fulfillment channel carry its own sequence, which is checked before the channel sequence for the listings in that lane and falls through to it. fulfillment_pricing_channels lists the lanes this channel supports — each with key, label, badge and listing_count (the active listings the lane governs) — and is empty on a channel with none. Amazon declares one lane, MFN (merchant-fulfilled listings; FBA listings always use the channel sequence). fulfillment_pricing_tier_ids holds the configured lane sequences keyed by lane, e.g. {"MFN": [6]}; a lane absent from it is unset and its listings use pricing_tier_ids. When no lane is configured the value is an empty array. listing_count is the number of active listings on the instance.

Pricing sync profile. pricing_sync_profile is the channel's default profile as {id, name}, or null when the channel pushes with its inline settings (the settings block and pricing_tier_ids). When a profile is set it supplies the sequence and guardrails for every listing that does not carry a profile of its own or inherit one from its product.

push_deferral is a hint for the push button: when the channel is rate-gating price transmissions (Walmart accepts 2 price feeds per hour and a 30-minute scheduled cadence spends both), it names the time the next slot opens; null when a feed would be accepted now, or when the channel never gates. The answer changes by the minute, so it does not disable the push — starting a push re-checks the gate and refuses with the same message if it is still closed.

prices_recalculated_at (ISO 8601) is when any listing on this channel last had its SKU.io price re-resolved — null when nothing on the channel has ever been priced. Use Recalculate Channel Prices to refresh it on demand.

Request​

Responses​

OK

Response Headers
    Content-Type