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.
integrations:readGrant 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
- 200
- 401
- 403
- 404
- 422
- 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
Unprocessable Content
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.