Skip to main content

Get Amazon Marketplace Price Sample

GET 

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

Price one listing in one non-home marketplace and show the full breakdown — base price, conversion, rounding, Amazon's fees, landed cost, profit and margin — plus the verdict the next push would reach for it. Uses live fees and the push's own guardrail decision, so the final price is the one a push would send. Nothing is saved or sent.

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.

Every rule query parameter is optional and overrides the saved rule for this request only, so a rule can be tried before it is saved with Update Amazon Marketplace Pricing.

Response data: product_listing_id / listing_id, seller_sku, product_name, country_code, marketplace_id, marketplace_label, currency, method, rounding, base_price and base_currency (the price read before conversion), fx_rate, converted_price, unrounded_price, price (the final figure, after guardrails), fees ({referral_rate as a fraction, referral_rate_pct, referral_amount, fulfillment_fee, closing_fee, total, currency, source (observed from recent orders or estimate from Amazon), source_label, observed_orders, checked_at}), cost (landed cost in the marketplace currency), profit, margin_pct, current_price and current_margin_pct (the offer as last read), verdict (push, unchanged, skip, block, fail or not_owned), detail (one sentence explaining the verdict) and refusal (why no price could be produced — no currency, no base price, no exchange rate, or a guardrail refusal — else null). Fields that could not be worked out are null.

Returns 422 for the home marketplace, a country the account does not sell in, a listing from another account, or when the marketplace has no offers to sample yet and no listing_id was given.

Request​

Responses​

OK

Response Headers
    Content-Type