Get Listing Amazon Min/Max
GET/api/v2/product-listings/:productListing/amazon-allowed-price
One Amazon listing's min/max across its marketplaces, the home marketplace first: Amazon's values now, SKU.io's resolved settings with their source, and what the next price push would send (next_push) — from the push's own preview: the price after SKU.io's price guardrails, currency conversion and the marketplace's pricing rule, then Amazon's min/max judged in that marketplace's currency. When the push would stop before Amazon's limits are checked, next_push.would_send is false and detail says why. A listing Amazon hasn't been read for gets a home row with status unknown and id null. Returns 404 for a listing that isn't on an Amazon channel.
integrations:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token. Requires the integrations.show permission.
Each row carries fix_price (as on the listings endpoint). next_push.would_send and next_push.detail are the push's final verdict for that offer — after the unchanged-price check and master of price — so an unchanged or Amazon-mastered offer reads would_send: false.
home_currency is the account's home-marketplace currency — fixed amounts in a listing or product exception are in it. fix_price_unavailable_reason says why fix_price is null: never read, Amazon reports no price, or Amazon was last read before SKU.io's latest price was sent there.
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.