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.
integrations:readGrant 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) orchannel(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 byuplift_pct) ortarget_margin(the price that leavestarget_margin_pctafter Amazon's fees and landed cost). Null on the home row. - uplift_pct, target_margin_pct (number|null)
- rounding (string|null):
none,.99,.95or.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;freshnessisfresh,aging,staleormissing, 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 areadjustorskip, max_delta_action isskip_listingorblock_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
- 200
- 401
- 403
- 404
- 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.
Not Found
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.