Skip to main content

List Amazon Marketplace Pricing

GET 

/api/v2/sales-channels/:integrationInstance/prices/marketplaces

List every marketplace this Amazon account participates in, home marketplace first, with who prices it, the rule, the exchange rate, the guardrails and its offer counts.

Required scope: integrations:read

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

Authentication: Requires Bearer token.

Requires the integrations.show permission.

Response data[] (one row per marketplace):

  • country_code, marketplace_id, marketplace_label, currency, is_home
  • owner (string): sku (SKU.io prices it) or channel (Amazon BIL for a non-home marketplace; Amazon for the home marketplace, when SKU.io is not its master of price)
  • method (string|null): convert (the home price converted at the current rate), uplift (converted, then raised or lowered by uplift_pct) or target_margin (the price that leaves target_margin_pct after Amazon's fees and landed cost). Null on the home row.
  • uplift_pct, target_margin_pct (number|null)
  • rounding (string|null): none, .99, .95 or .49. Null on the home row.
  • price_from_tier_ids (array|null): pricing levels the price is read from, in order; null means the home listing's price. On the home row, the home push's levels.
  • price_from_label (string|null): those levels by name, or Home price
  • fx (object|null): {rate, from, to, fetched_at, age_days, freshness, is_manual} — the rate from the source currency to the marketplace currency; freshness is fresh, aging, stale or missing, and a push refuses to price with a stale or missing rate. Null on the home row.
  • guardrails (object): {floor_type, floor_value, floor_tier_id, floor_action, ceiling_type, ceiling_value, ceiling_tier_id, ceiling_action, max_delta_pct, max_delta_action}; bound actions are adjust or skip, max_delta_action is skip_listing or block_run. The home row shows the home push's own guardrails.
  • offers (object|null): {remote, local, at_home_number, changed_outside, checked_at} — offers created from the home listing, listings native to the marketplace, offers still at the home-marketplace number, offers whose price was changed outside SKU.io, and when offers were last read. Null on the home row.
  • bil_confirmed_at, bil_confirmed_by (string|null): when and by whom SKU.io took the marketplace over from BIL
  • dry_run_required (boolean): the next live run prices this marketplace as a preview only
  • first_live_push_at (string|null): the first live push to this marketplace since it was taken over
  • seller_central_bil_url (string): where BIL is managed in Seller Central

Response meta: home_country_code, at_home_number (total offers still at the home number), at_home_number_by_country, seller_central_bil_url, and offer_sync_job_name / restore_job_name — the tracked job names of this account's offer refresh and restore, for finding a running one.

Request​

Responses​

OK

Response Headers
    Content-Type