{ "openapi": "3.0.1", "info": { "title": "Selling Partner API for Pricing", "description": "The Selling Partner API for Pricing helps you programmatically retrieve product pricing and offer information for Amazon Marketplace products.", "contact": { "name": "Selling Partner API Developer Support", "url": "https://sellercentral.amazon.com/gp/mws/contactus.html" }, "license": { "name": "Apache License 2.0", "url": "http://www.apache.org/licenses/LICENSE-2.0" }, "version": "v0" }, "servers": [ { "url": "https://sellingpartnerapi-na.amazon.com/" } ], "paths": { "/products/pricing/v0/price": { "get": { "tags": [ "productPricing" ], "description": "Returns pricing information for a seller's offer listings based on seller SKU or ASIN.\n\n**Note:** The parameters associated with this operation may contain special characters that require URL encoding to call the API. To avoid errors with SKUs when encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 0.5 | 1 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).", "operationId": "getPricing", "parameters": [ { "name": "MarketplaceId", "in": "query", "description": "A marketplace identifier. Specifies the marketplace for which prices are returned.", "required": true, "schema": { "type": "string" } }, { "name": "Asins", "in": "query", "description": "A list of up to twenty Amazon Standard Identification Number (ASIN) values used to identify items in the given marketplace.", "style": "form", "explode": false, "schema": { "maxItems": 20, "type": "array", "items": { "type": "string" } } }, { "name": "Skus", "in": "query", "description": "A list of up to twenty seller SKU values used to identify items in the given marketplace.", "style": "form", "explode": false, "schema": { "maxItems": 20, "type": "array", "items": { "type": "string" } } }, { "name": "ItemType", "in": "query", "description": "Indicates whether ASIN values or seller SKU values are used to identify items. If you specify Asin, the information in the response will be dependent on the list of Asins you provide in the Asins parameter. If you specify Sku, the information in the response will be dependent on the list of Skus you provide in the Skus parameter.", "required": true, "schema": { "type": "string", "enum": [ "Asin", "Sku" ], "x-docgen-enum-table-extension": [ { "value": "Asin", "description": "The Amazon Standard Identification Number (ASIN)." }, { "value": "Sku", "description": "The seller SKU." } ] }, "x-docgen-enum-table-extension": [ { "value": "Asin", "description": "The Amazon Standard Identification Number (ASIN)." }, { "value": "Sku", "description": "The seller SKU." } ] }, { "name": "ItemCondition", "in": "query", "description": "Filters the offer listings based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.", "schema": { "type": "string", "enum": [ "New", "Used", "Collectible", "Refurbished", "Club" ], "x-docgen-enum-table-extension": [ { "value": "New", "description": "New" }, { "value": "Used", "description": "Used" }, { "value": "Collectible", "description": "Collectible" }, { "value": "Refurbished", "description": "Refurbished" }, { "value": "Club", "description": "Club" } ] }, "x-docgen-enum-table-extension": [ { "value": "New", "description": "New" }, { "value": "Used", "description": "Used" }, { "value": "Collectible", "description": "Collectible" }, { "value": "Refurbished", "description": "Refurbished" }, { "value": "Club", "description": "Club" } ] }, { "name": "OfferType", "in": "query", "description": "Indicates whether to request pricing information for the seller's B2C or B2B offers. Default is B2C.", "schema": { "type": "string", "enum": [ "B2C", "B2B" ], "x-docgen-enum-table-extension": [ { "value": "B2C", "description": "B2C" }, { "value": "B2B", "description": "B2B" } ] }, "x-docgen-enum-table-extension": [ { "value": "B2C", "description": "B2C" }, { "value": "B2B", "description": "B2B" } ] } ], "responses": { "200": { "description": "Success.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetPricingResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "MarketplaceId": { "value": "ATVPDKIKX0DER" }, "ItemType": { "value": "Asin" } } }, "response": { "payload": [ { "status": "Success", "ASIN": "B00V5DG6IQ", "Product": { "Identifiers": { "MarketplaceASIN": { "MarketplaceId": "ATVPDKIKX0DER", "ASIN": "B00V5DG6IQ" }, "SKUIdentifier": { "MarketplaceId": "", "SellerId": "", "SellerSKU": "" } }, "Offers": [ { "BuyingPrice": { "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "LandedPrice": { "CurrencyCode": "USD", "Amount": 10 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } }, "RegularPrice": { "CurrencyCode": "USD", "Amount": 10 }, "FulfillmentChannel": "MERCHANT", "ItemCondition": "New", "ItemSubCondition": "New", "SellerSKU": "NABetaASINB00V5DG6IQ" } ] } }, { "status": "Success", "ASIN": "B00551Q3CS", "Product": { "Identifiers": { "MarketplaceASIN": { "MarketplaceId": "ATVPDKIKX0DER", "ASIN": "B00551Q3CS" }, "SKUIdentifier": { "MarketplaceId": "", "SellerId": "", "SellerSKU": "" } }, "Offers": [ { "BuyingPrice": { "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "LandedPrice": { "CurrencyCode": "USD", "Amount": 10 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } }, "RegularPrice": { "CurrencyCode": "USD", "Amount": 10 }, "FulfillmentChannel": "MERCHANT", "ItemCondition": "New", "ItemSubCondition": "New", "SellerSKU": "NABetaASINB00551Q3CS" } ] } } ] } }, { "request": { "parameters": { "MarketplaceId": { "value": "ATVPDKIKX0DER" }, "ItemType": { "value": "Sku" } } }, "response": { "payload": [ { "status": "Success", "SellerSKU": "NABetaASINB00V5DG6IQ", "Product": { "Identifiers": { "MarketplaceASIN": { "MarketplaceId": "ATVPDKIKX0DER", "ASIN": "B00V5DG6IQ" }, "SKUIdentifier": { "MarketplaceId": "ATVPDKIKX0DER", "SellerId": "AXXXXXXXXXXXXX", "SellerSKU": "NABetaASINB00V5DG6IQ" } }, "Offers": [ { "BuyingPrice": { "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "LandedPrice": { "CurrencyCode": "USD", "Amount": 10 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } }, "RegularPrice": { "CurrencyCode": "USD", "Amount": 10 }, "FulfillmentChannel": "MERCHANT", "ItemCondition": "New", "ItemSubCondition": "New", "SellerSKU": "NABetaASINB00V5DG6IQ" } ] } }, { "status": "Success", "SellerSKU": "NABetaASINB00551Q3CS", "Product": { "Identifiers": { "MarketplaceASIN": { "MarketplaceId": "ATVPDKIKX0DER", "ASIN": "B00551Q3CS" }, "SKUIdentifier": { "MarketplaceId": "ATVPDKIKX0DER", "SellerId": "AXXXXXXXXXXXXX", "SellerSKU": "NABetaASINB00551Q3CS" } }, "Offers": [ { "BuyingPrice": { "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "LandedPrice": { "CurrencyCode": "USD", "Amount": 10 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } }, "RegularPrice": { "CurrencyCode": "USD", "Amount": 10 }, "FulfillmentChannel": "MERCHANT", "ItemCondition": "New", "ItemSubCondition": "New", "SellerSKU": "NABetaASINB00551Q3CS" } ] } } ] } }, { "request": { "parameters": { "MarketplaceId": { "value": "ATVPDKIKX0DER" }, "ItemType": { "value": "Asin" }, "OfferType": { "value": "B2B" } } }, "response": { "payload": [ { "status": "Success", "ASIN": "B00V5DG6IQ", "Product": { "Identifiers": { "MarketplaceASIN": { "MarketplaceId": "ATVPDKIKX0DER", "ASIN": "B00V5DG6IQ" }, "SKUIdentifier": { "MarketplaceId": "", "SellerId": "", "SellerSKU": "" } }, "Offers": [ { "offerType": "B2B", "BuyingPrice": { "ListingPrice": { "CurrencyCode": "USD", "Amount": 9.5 }, "LandedPrice": { "CurrencyCode": "USD", "Amount": 9.5 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } }, "RegularPrice": { "CurrencyCode": "USD", "Amount": 10 }, "quantityDiscountPrices": [ { "quantityTier": 2, "quantityDiscountType": "QUANTITY_DISCOUNT", "listingPrice": { "CurrencyCode": "USD", "Amount": 8 } }, { "quantityTier": 3, "quantityDiscountType": "QUANTITY_DISCOUNT", "listingPrice": { "CurrencyCode": "USD", "Amount": 7 } } ], "FulfillmentChannel": "MERCHANT", "ItemCondition": "New", "ItemSubCondition": "New", "SellerSKU": "NABetaASINB00V5DG6IQ" } ] } }, { "status": "Success", "ASIN": "B00551Q3CS", "Product": { "Identifiers": { "MarketplaceASIN": { "MarketplaceId": "ATVPDKIKX0DER", "ASIN": "B00551Q3CS" }, "SKUIdentifier": { "MarketplaceId": "", "SellerId": "", "SellerSKU": "" } }, "Offers": [ { "offerType": "B2B", "BuyingPrice": { "ListingPrice": { "CurrencyCode": "USD", "Amount": 8 }, "LandedPrice": { "CurrencyCode": "USD", "Amount": 8 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } }, "RegularPrice": { "CurrencyCode": "USD", "Amount": 10 }, "FulfillmentChannel": "MERCHANT", "ItemCondition": "New", "ItemSubCondition": "New", "SellerSKU": "NABetaASINB00551Q3CS" } ] } } ] } } ] } }, "400": { "description": "Request has missing or invalid parameters and cannot be parsed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetPricingResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "MarketplaceId": { "value": "TEST_CASE_400" } } }, "response": { "errors": [ { "code": "InvalidInput", "message": "Invalid Input" } ] } } ] } }, "401": { "description": "The request's Authorization header is not formatted correctly or does not contain a valid token.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetPricingResponse" } } } }, "403": { "description": "Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetPricingResponse" } } } }, "404": { "description": "The specified resource does not exist.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetPricingResponse" } } } }, "429": { "description": "The frequency of requests was greater than allowed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetPricingResponse" } } } }, "500": { "description": "An unexpected condition occurred that prevented the server from fulfilling the request.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetPricingResponse" } } } }, "503": { "description": "Temporary overloading or maintenance of the server.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetPricingResponse" } } } } } } }, "/products/pricing/v0/competitivePrice": { "get": { "tags": [ "productPricing" ], "description": "Returns competitive pricing information for a seller's offer listings based on seller SKU or ASIN.\n\n**Note:** The parameters associated with this operation may contain special characters that require URL encoding to call the API. To avoid errors with SKUs when encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 0.5 | 1 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).", "operationId": "getCompetitivePricing", "parameters": [ { "name": "MarketplaceId", "in": "query", "description": "A marketplace identifier. Specifies the marketplace for which prices are returned.", "required": true, "schema": { "type": "string" } }, { "name": "Asins", "in": "query", "description": "A list of up to twenty Amazon Standard Identification Number (ASIN) values used to identify items in the given marketplace.", "style": "form", "explode": false, "schema": { "maxItems": 20, "type": "array", "items": { "type": "string" } } }, { "name": "Skus", "in": "query", "description": "A list of up to twenty seller SKU values used to identify items in the given marketplace.", "style": "form", "explode": false, "schema": { "maxItems": 20, "type": "array", "items": { "type": "string" } } }, { "name": "ItemType", "in": "query", "description": "Indicates whether ASIN values or seller SKU values are used to identify items. If you specify Asin, the information in the response will be dependent on the list of Asins you provide in the Asins parameter. If you specify Sku, the information in the response will be dependent on the list of Skus you provide in the Skus parameter. Possible values: Asin, Sku.", "required": true, "schema": { "type": "string", "enum": [ "Asin", "Sku" ], "x-docgen-enum-table-extension": [ { "value": "Asin", "description": "The Amazon Standard Identification Number (ASIN)." }, { "value": "Sku", "description": "The seller SKU." } ] }, "x-docgen-enum-table-extension": [ { "value": "Asin", "description": "The Amazon Standard Identification Number (ASIN)." }, { "value": "Sku", "description": "The seller SKU." } ] }, { "name": "CustomerType", "in": "query", "description": "Indicates whether to request pricing information from the point of view of Consumer or Business buyers. Default is Consumer.", "schema": { "type": "string", "enum": [ "Consumer", "Business" ], "x-docgen-enum-table-extension": [ { "value": "Consumer", "description": "Consumer" }, { "value": "Business", "description": "Business" } ] }, "x-docgen-enum-table-extension": [ { "value": "Consumer", "description": "Consumer" }, { "value": "Business", "description": "Business" } ] } ], "responses": { "200": { "description": "Success.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetPricingResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "MarketplaceId": { "value": "ATVPDKIKX0DER" }, "ItemType": { "value": "Asin" } } }, "response": { "payload": [ { "status": "Success", "ASIN": "B00V5DG6IQ", "Product": { "Identifiers": { "MarketplaceASIN": { "MarketplaceId": "ATVPDKIKX0DER", "ASIN": "B00V5DG6IQ" }, "SKUIdentifier": { "MarketplaceId": "", "SellerId": "", "SellerSKU": "" } }, "CompetitivePricing": { "CompetitivePrices": [ { "CompetitivePriceId": "4545645646", "Price": { "LandedPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 130 }, "Shipping": { "CurrencyCode": "USD", "Amount": 120 }, "Points": { "PointsNumber": 130, "PointsMonetaryValue": { "CurrencyCode": "USD", "Amount": 10 } } }, "condition": "new", "belongsToRequester": true } ], "NumberOfOfferListings": [ { "Count": 20, "condition": "new" } ], "TradeInValue": { "CurrencyCode": "USD", "Amount": 10 } }, "SalesRankings": [ { "ProductCategoryId": "325345", "Rank": 1 } ] } }, { "status": "Success", "ASIN": "B00551Q3CS", "Product": { "Identifiers": { "MarketplaceASIN": { "MarketplaceId": "ATVPDKIKX0DER", "ASIN": "B00551Q3CS" }, "SKUIdentifier": { "MarketplaceId": "", "SellerId": "", "SellerSKU": "" } }, "CompetitivePricing": { "CompetitivePrices": [ { "CompetitivePriceId": "45456452646", "Price": { "LandedPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 130 }, "Shipping": { "CurrencyCode": "USD", "Amount": 120 }, "Points": { "PointsNumber": 130, "PointsMonetaryValue": { "CurrencyCode": "USD", "Amount": 10 } } }, "condition": "new", "belongsToRequester": true } ], "NumberOfOfferListings": [ { "Count": 1, "condition": "new" } ], "TradeInValue": { "CurrencyCode": "string", "Amount": 0 } }, "SalesRankings": [ { "ProductCategoryId": "54564", "Rank": 1 } ] } } ] } }, { "request": { "parameters": { "MarketplaceId": { "value": "ATVPDKIKX0DER" }, "ItemType": { "value": "Sku" } } }, "response": { "payload": [ { "status": "Success", "SellerSKU": "NABetaASINB00V5DG6IQ", "Product": { "Identifiers": { "MarketplaceASIN": { "MarketplaceId": "ATVPDKIKX0DER", "ASIN": "B00V5DG6IQ" }, "SKUIdentifier": { "MarketplaceId": "ATVPDKIKX0DER", "SellerId": "AXXXXXXXXXXXXX", "SellerSKU": "NABetaASINB00V5DG6IQ" } }, "CompetitivePricing": { "CompetitivePrices": [ { "CompetitivePriceId": "3454535", "Price": { "LandedPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 130 }, "Shipping": { "CurrencyCode": "USD", "Amount": 120 }, "Points": { "PointsNumber": 130, "PointsMonetaryValue": { "CurrencyCode": "USD", "Amount": 10 } } }, "condition": "new", "belongsToRequester": true } ], "NumberOfOfferListings": [ { "Count": 402, "condition": "new" } ], "TradeInValue": { "CurrencyCode": "USD", "Amount": 20 } }, "SalesRankings": [ { "ProductCategoryId": "676554", "Rank": 1 } ] } }, { "status": "Success", "SellerSKU": "NABetaASINB00551Q3CS", "Product": { "Identifiers": { "MarketplaceASIN": { "MarketplaceId": "ATVPDKIKX0DER", "ASIN": "B00551Q3CS" }, "SKUIdentifier": { "MarketplaceId": "ATVPDKIKX0DER", "SellerId": "AXXXXXXXXXXXXX", "SellerSKU": "NABetaASINB00551Q3CS" } }, "CompetitivePricing": { "CompetitivePrices": [ { "CompetitivePriceId": "4545645646", "Price": { "LandedPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 130 }, "Shipping": { "CurrencyCode": "USD", "Amount": 120 }, "Points": { "PointsNumber": 130, "PointsMonetaryValue": { "CurrencyCode": "USD", "Amount": 10 } } }, "condition": "new", "belongsToRequester": true } ], "NumberOfOfferListings": [ { "Count": 402, "condition": "new" } ], "TradeInValue": { "CurrencyCode": "USD", "Amount": 20 } }, "SalesRankings": [ { "ProductCategoryId": "35345", "Rank": 1 } ] } } ] } }, { "request": { "parameters": { "MarketplaceId": { "value": "ATVPDKIKX0DER" }, "ItemType": { "value": "Asin" }, "CustomerType": { "value": "Business" } } }, "response": { "payload": [ { "status": "Success", "ASIN": "B00V5DG6IQ", "Product": { "Identifiers": { "MarketplaceASIN": { "MarketplaceId": "ATVPDKIKX0DER", "ASIN": "B00V5DG6IQ" }, "SKUIdentifier": { "MarketplaceId": "", "SellerId": "", "SellerSKU": "" } }, "CompetitivePricing": { "CompetitivePrices": [ { "CompetitivePriceId": "1", "Price": { "LandedPrice": { "CurrencyCode": "USD", "Amount": 120 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 130 }, "Shipping": { "CurrencyCode": "USD", "Amount": 10 }, "Points": { "PointsNumber": 130, "PointsMonetaryValue": { "CurrencyCode": "USD", "Amount": 10 } } }, "condition": "new", "offerType": "B2C", "sellerId": "AXXXXXXXXXXXXX", "belongsToRequester": true }, { "CompetitivePriceId": "1", "Price": { "ListingPrice": { "CurrencyCode": "USD", "Amount": 115 } }, "condition": "new", "offerType": "B2B", "quantityTier": 3, "quantityDiscountType": "QUANTITY_DISCOUNT", "sellerId": "AXXXXXXXXXXXXX", "belongsToRequester": true }, { "CompetitivePriceId": "1", "Price": { "ListingPrice": { "CurrencyCode": "USD", "Amount": 110 } }, "condition": "new", "offerType": "B2B", "quantityTier": 5, "quantityDiscountType": "QUANTITY_DISCOUNT", "sellerId": "AXXXXXXXXXXXXX", "belongsToRequester": true } ], "NumberOfOfferListings": [ { "Count": 3, "condition": "new" } ], "TradeInValue": { "CurrencyCode": "USD", "Amount": 10 } }, "SalesRankings": [ { "ProductCategoryId": "325345", "Rank": 1 } ] } }, { "status": "Success", "ASIN": "B00551Q3CS", "Product": { "Identifiers": { "MarketplaceASIN": { "MarketplaceId": "ATVPDKIKX0DER", "ASIN": "B00551Q3CS" }, "SKUIdentifier": { "MarketplaceId": "", "SellerId": "", "SellerSKU": "" } }, "CompetitivePricing": { "CompetitivePrices": [ { "CompetitivePriceId": "1", "Price": { "LandedPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 130 }, "Shipping": { "CurrencyCode": "USD", "Amount": 120 }, "Points": { "PointsNumber": 130, "PointsMonetaryValue": { "CurrencyCode": "USD", "Amount": 10 } } }, "condition": "new", "offerType": "B2B", "sellerId": "AXXXXXXXXXXXXX", "belongsToRequester": true } ], "NumberOfOfferListings": [ { "Count": 1, "condition": "new" } ], "TradeInValue": { "CurrencyCode": "string", "Amount": 0 } }, "SalesRankings": [ { "ProductCategoryId": "54564", "Rank": 1 } ] } } ] } } ] } }, "400": { "description": "Request has missing or invalid parameters and cannot be parsed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetPricingResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "MarketplaceId": { "value": "TEST_CASE_400" } } }, "response": { "errors": [ { "code": "InvalidInput", "message": "Invalid Input" } ] } } ] } }, "401": { "description": "The request's Authorization header is not formatted correctly or does not contain a valid token.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetPricingResponse" } } } }, "403": { "description": "Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetPricingResponse" } } } }, "404": { "description": "The specified resource does not exist.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetPricingResponse" } } } }, "429": { "description": "The frequency of requests was greater than allowed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetPricingResponse" } } } }, "500": { "description": "An unexpected condition occurred that prevented the server from fulfilling the request.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetPricingResponse" } } } }, "503": { "description": "Temporary overloading or maintenance of the server.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetPricingResponse" } } } } } } }, "/products/pricing/v0/listings/{SellerSKU}/offers": { "get": { "tags": [ "productPricing" ], "description": "Returns the lowest priced offers for a single SKU listing.\n\n**Note:** The parameters associated with this operation may contain special characters that require URL encoding to call the API. To avoid errors with SKUs when encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 1 | 2 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).", "operationId": "getListingOffers", "parameters": [ { "name": "MarketplaceId", "in": "query", "description": "A marketplace identifier. Specifies the marketplace for which prices are returned.", "required": true, "schema": { "type": "string" } }, { "name": "ItemCondition", "in": "query", "description": "Filters the offer listings based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.", "required": true, "schema": { "type": "string", "enum": [ "New", "Used", "Collectible", "Refurbished", "Club" ], "x-docgen-enum-table-extension": [ { "value": "New", "description": "New" }, { "value": "Used", "description": "Used" }, { "value": "Collectible", "description": "Collectible" }, { "value": "Refurbished", "description": "Refurbished" }, { "value": "Club", "description": "Club" } ] }, "x-docgen-enum-table-extension": [ { "value": "New", "description": "New" }, { "value": "Used", "description": "Used" }, { "value": "Collectible", "description": "Collectible" }, { "value": "Refurbished", "description": "Refurbished" }, { "value": "Club", "description": "Club" } ] }, { "name": "SellerSKU", "in": "path", "description": "Identifies an item in the given marketplace. SellerSKU is qualified by the seller's SellerId, which is included with every operation that you submit.", "required": true, "schema": { "type": "string" } }, { "name": "CustomerType", "in": "query", "description": "Indicates whether to request Consumer or Business offers. Default is Consumer.", "schema": { "type": "string", "enum": [ "Consumer", "Business" ], "x-docgen-enum-table-extension": [ { "value": "Consumer", "description": "Consumer" }, { "value": "Business", "description": "Business" } ] }, "x-docgen-enum-table-extension": [ { "value": "Consumer", "description": "Consumer" }, { "value": "Business", "description": "Business" } ] } ], "responses": { "200": { "description": "Success.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetOffersResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "SellerSKU": { "value": "NABetaASINB00V5DG6IQ" }, "MarketplaceId": { "value": "ATVPDKIKX0DER" } } }, "response": { "payload": { "SKU": "NABetaASINB00V5DG6IQ", "status": "Success", "ItemCondition": "New", "Identifier": { "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "SellerSKU": "NABetaASINB00V5DG6IQ" }, "Summary": { "LowestPrices": [ { "condition": "new", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } } ], "NumberOfOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant" } ], "BuyBoxEligibleOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant" } ], "TotalOfferCount": 1 }, "Offers": [ { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "SellerFeedbackRating": { "FeedbackCount": 0, "SellerPositiveFeedbackRating": 0 }, "ShipsFrom": { "State": "WA", "Country": "US" }, "SubCondition": "new", "IsFeaturedMerchant": false, "SellerId": "AXXXXXXXXXXXXX", "MyOffer": true, "IsFulfilledByAmazon": false } ], "MarketplaceID": "ATVPDKIKX0DER" } } }, { "request": { "parameters": { "SellerSKU": { "value": "NABetaASINB00V5DG6IQ" }, "MarketplaceId": { "value": "ATVPDKIKX0DER" }, "CustomerType": { "value": "Business" } } }, "response": { "payload": { "SKU": "NABetaASINB00V5DG6IQ", "status": "Success", "ItemCondition": "New", "Identifier": { "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "SellerSKU": "NABetaASINB00V5DG6IQ" }, "Summary": { "LowestPrices": [ { "condition": "new", "fulfillmentChannel": "Merchant", "offerType": "B2B", "LandedPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } }, { "condition": "new", "fulfillmentChannel": "Merchant", "offerType": "B2B", "quantityTier": 20, "quantityDiscountType": "QUANTITY_DISCOUNT", "ListingPrice": { "CurrencyCode": "USD", "Amount": 8 } }, { "condition": "new", "fulfillmentChannel": "Merchant", "offerType": "B2B", "quantityTier": 30, "quantityDiscountType": "QUANTITY_DISCOUNT", "ListingPrice": { "CurrencyCode": "USD", "Amount": 6 } } ], "NumberOfOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant" } ], "BuyBoxEligibleOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant" } ], "BuyBoxPrices": [ { "condition": "new", "offerType": "B2B", "ListingPrice": { "Amount": 9, "CurrencyCode": "USD" }, "Shipping": { "Amount": 0, "CurrencyCode": "USD" }, "LandedPrice": { "Amount": 9, "CurrencyCode": "USD" }, "sellerId": "AXXXXXXXXXXXXX" }, { "condition": "new", "offerType": "B2B", "quantityTier": 20, "quantityDiscountType": "QUANTITY_DISCOUNT", "ListingPrice": { "Amount": 8, "CurrencyCode": "USD" }, "Shipping": { "Amount": 0, "CurrencyCode": "USD" }, "LandedPrice": { "Amount": 8, "CurrencyCode": "USD" }, "sellerId": "AXXXXXXXXXXXXX" }, { "condition": "new", "offerType": "B2B", "quantityTier": 30, "quantityDiscountType": "QUANTITY_DISCOUNT", "ListingPrice": { "Amount": 7, "CurrencyCode": "USD" }, "Shipping": { "Amount": 0, "CurrencyCode": "USD" }, "LandedPrice": { "Amount": 7, "CurrencyCode": "USD" }, "sellerId": "AXXXXXXXXXXXXX" } ], "TotalOfferCount": 4 }, "Offers": [ { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "quantityDiscountPrices": [ { "quantityTier": 2, "quantityDiscountType": "QUANTITY_DISCOUNT", "listingPrice": { "Amount": 8, "CurrencyCode": "USD" } }, { "quantityTier": 3, "quantityDiscountType": "QUANTITY_DISCOUNT", "listingPrice": { "Amount": 7, "CurrencyCode": "USD" } } ], "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "SellerFeedbackRating": { "FeedbackCount": 0, "SellerPositiveFeedbackRating": 0 }, "ShipsFrom": { "State": "WA", "Country": "US" }, "SubCondition": "new", "IsFeaturedMerchant": false, "SellerId": "AXXXXXXXXXXXXX", "MyOffer": true, "IsFulfilledByAmazon": false } ], "MarketplaceID": "ATVPDKIKX0DER" } } } ] } }, "400": { "description": "Request has missing or invalid parameters and cannot be parsed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetOffersResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "SellerSKU": { "value": "TEST_CASE_400" } } }, "response": { "errors": [ { "code": "InvalidInput", "message": "Invalid Input" } ] } } ] } }, "401": { "description": "The request's Authorization header is not formatted correctly or does not contain a valid token.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetOffersResponse" } } } }, "403": { "description": "Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetOffersResponse" } } } }, "404": { "description": "The specified resource does not exist.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetOffersResponse" } } } }, "429": { "description": "The frequency of requests was greater than allowed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetOffersResponse" } } } }, "500": { "description": "An unexpected condition occurred that prevented the server from fulfilling the request.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetOffersResponse" } } } }, "503": { "description": "Temporary overloading or maintenance of the server.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetOffersResponse" } } } } } } }, "/products/pricing/v0/items/{Asin}/offers": { "get": { "tags": [ "productPricing" ], "description": "Returns the lowest priced offers for a single item based on ASIN.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 0.5 | 1 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).", "operationId": "getItemOffers", "parameters": [ { "name": "MarketplaceId", "in": "query", "description": "A marketplace identifier. Specifies the marketplace for which prices are returned.", "required": true, "schema": { "type": "string" } }, { "name": "ItemCondition", "in": "query", "description": "Filters the offer listings to be considered based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.", "required": true, "schema": { "type": "string", "enum": [ "New", "Used", "Collectible", "Refurbished", "Club" ], "x-docgen-enum-table-extension": [ { "value": "New", "description": "New" }, { "value": "Used", "description": "Used" }, { "value": "Collectible", "description": "Collectible" }, { "value": "Refurbished", "description": "Refurbished" }, { "value": "Club", "description": "Club" } ] }, "x-docgen-enum-table-extension": [ { "value": "New", "description": "New" }, { "value": "Used", "description": "Used" }, { "value": "Collectible", "description": "Collectible" }, { "value": "Refurbished", "description": "Refurbished" }, { "value": "Club", "description": "Club" } ] }, { "name": "Asin", "in": "path", "description": "The Amazon Standard Identification Number (ASIN) of the item.", "required": true, "schema": { "type": "string" } }, { "name": "CustomerType", "in": "query", "description": "Indicates whether to request Consumer or Business offers. Default is Consumer.", "schema": { "type": "string", "enum": [ "Consumer", "Business" ], "x-docgen-enum-table-extension": [ { "value": "Consumer", "description": "Consumer" }, { "value": "Business", "description": "Business" } ] }, "x-docgen-enum-table-extension": [ { "value": "Consumer", "description": "Consumer" }, { "value": "Business", "description": "Business" } ] } ], "responses": { "200": { "description": "Success.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetOffersResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "Asin": { "value": "B00V5DG6IQ" }, "MarketplaceId": { "value": "ATVPDKIKX0DER" } } }, "response": { "payload": { "ASIN": "B00V5DG6IQ", "status": "Success", "ItemCondition": "New", "Identifier": { "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "ASIN": "B00V5DG6IQ" }, "Summary": { "LowestPrices": [ { "condition": "new", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } } ], "NumberOfOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant" } ], "BuyBoxEligibleOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant" } ], "TotalOfferCount": 1 }, "Offers": [ { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "SellerFeedbackRating": { "FeedbackCount": 0, "SellerPositiveFeedbackRating": 0 }, "ShipsFrom": { "State": "WA", "Country": "US" }, "SubCondition": "new", "IsFeaturedMerchant": false, "SellerId": "AXXXXXXXXXXXXX", "IsFulfilledByAmazon": false } ], "MarketplaceID": "ATVPDKIKX0DER" } } }, { "request": { "parameters": { "Asin": { "value": "B00V5DG6IQ" }, "MarketplaceId": { "value": "ATVPDKIKX0DER" }, "CustomerType": { "value": "Business" } } }, "response": { "payload": { "ASIN": "B00V5DG6IQ", "status": "Success", "ItemCondition": "New", "Identifier": { "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "ASIN": "B00V5DG6IQ" }, "Summary": { "LowestPrices": [ { "condition": "new", "fulfillmentChannel": "Merchant", "offerType": "B2B", "LandedPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } }, { "condition": "new", "fulfillmentChannel": "Merchant", "offerType": "B2B", "quantityTier": 20, "quantityDiscountType": "QUANTITY_DISCOUNT", "ListingPrice": { "CurrencyCode": "USD", "Amount": 8 } }, { "condition": "new", "fulfillmentChannel": "Merchant", "offerType": "B2B", "quantityTier": 30, "quantityDiscountType": "QUANTITY_DISCOUNT", "ListingPrice": { "CurrencyCode": "USD", "Amount": 6 } } ], "NumberOfOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant" } ], "BuyBoxEligibleOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant" } ], "BuyBoxPrices": [ { "condition": "new", "offerType": "B2B", "ListingPrice": { "Amount": 9, "CurrencyCode": "USD" }, "Shipping": { "Amount": 0, "CurrencyCode": "USD" }, "LandedPrice": { "Amount": 9, "CurrencyCode": "USD" }, "sellerId": "AXXXXXXXXXXXXX" }, { "condition": "new", "offerType": "B2B", "quantityTier": 20, "quantityDiscountType": "QUANTITY_DISCOUNT", "ListingPrice": { "Amount": 8, "CurrencyCode": "USD" }, "Shipping": { "Amount": 0, "CurrencyCode": "USD" }, "LandedPrice": { "Amount": 8, "CurrencyCode": "USD" }, "sellerId": "AXXXXXXXXXXXXX" }, { "condition": "new", "offerType": "B2B", "quantityTier": 30, "quantityDiscountType": "QUANTITY_DISCOUNT", "ListingPrice": { "Amount": 7, "CurrencyCode": "USD" }, "Shipping": { "Amount": 0, "CurrencyCode": "USD" }, "LandedPrice": { "Amount": 7, "CurrencyCode": "USD" }, "sellerId": "AXXXXXXXXXXXXX" } ], "TotalOfferCount": 4 }, "Offers": [ { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "quantityDiscountPrices": [ { "quantityTier": 20, "quantityDiscountType": "QUANTITY_DISCOUNT", "listingPrice": { "Amount": 8, "CurrencyCode": "USD" } }, { "quantityTier": 30, "quantityDiscountType": "QUANTITY_DISCOUNT", "listingPrice": { "Amount": 7, "CurrencyCode": "USD" } } ], "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "SellerFeedbackRating": { "FeedbackCount": 0, "SellerPositiveFeedbackRating": 0 }, "ShipsFrom": { "State": "WA", "Country": "US" }, "SubCondition": "new", "IsFeaturedMerchant": false, "SellerId": "AXXXXXXXXXXXXX", "MyOffer": true, "IsFulfilledByAmazon": false } ], "MarketplaceID": "ATVPDKIKX0DER" } } } ] } }, "400": { "description": "Request has missing or invalid parameters and cannot be parsed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetOffersResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "Asin": { "value": "TEST_CASE_400" } } }, "response": { "errors": [ { "code": "InvalidInput", "message": "Invalid Input" } ] } } ] } }, "401": { "description": "The request's Authorization header is not formatted correctly or does not contain a valid token.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetOffersResponse" } } } }, "403": { "description": "Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetOffersResponse" } } } }, "404": { "description": "The specified resource does not exist.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetOffersResponse" } } } }, "429": { "description": "The frequency of requests was greater than allowed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetOffersResponse" } } } }, "500": { "description": "An unexpected condition occurred that prevented the server from fulfilling the request.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetOffersResponse" } } } }, "503": { "description": "Temporary overloading or maintenance of the server.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetOffersResponse" } } } } } } }, "/batches/products/pricing/v0/itemOffers": { "post": { "tags": [ "productPricing" ], "description": "Returns the lowest priced offers for a batch of items based on ASIN.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 0.1 | 1 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).", "operationId": "getItemOffersBatch", "requestBody": { "description": "The request associated with the `getItemOffersBatch` API call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetItemOffersBatchRequest" } } }, "required": true }, "responses": { "200": { "description": "Indicates that requests were run in batch. Check the batch response status lines for information on whether a batch request succeeded.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetItemOffersBatchResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "body": { "value": { "requests": [ { "uri": "/products/pricing/v0/items/B000P6Q7MY/offers", "method": "GET", "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "CustomerType": "Consumer" }, { "uri": "/products/pricing/v0/items/B001Q3KU9Q/offers", "method": "GET", "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "CustomerType": "Consumer" }, { "uri": "/products/pricing/v0/items/B007Z07UK6/offers", "method": "GET", "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "CustomerType": "Consumer" }, { "uri": "/products/pricing/v0/items/B000OQA3N4/offers", "method": "GET", "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "CustomerType": "Consumer" }, { "uri": "/products/pricing/v0/items/B07PTMKYS7/offers", "method": "GET", "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "CustomerType": "Consumer" }, { "uri": "/products/pricing/v0/items/B001PYUTII/offers", "method": "GET", "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "CustomerType": "Consumer" }, { "uri": "/products/pricing/v0/items/B00505DW2I/offers", "method": "GET", "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "CustomerType": "Consumer" }, { "uri": "/products/pricing/v0/items/B00CGZQU42/offers", "method": "GET", "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "CustomerType": "Consumer" }, { "uri": "/products/pricing/v0/items/B01LY2ZYRF/offers", "method": "GET", "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "CustomerType": "Consumer" }, { "uri": "/products/pricing/v0/items/B00KFRNZY6/offers", "method": "GET", "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "CustomerType": "Consumer" } ] } } } }, "response": { "responses": [ { "status": { "statusCode": 200, "reasonPhrase": "OK" }, "body": { "payload": { "ASIN": "B000P6Q7MY", "status": "Success", "ItemCondition": "New", "Identifier": { "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "ASIN": "B000P6Q7MY" }, "Summary": { "LowestPrices": [ { "condition": "new", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 21 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 21 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } } ], "BuyBoxPrices": [ { "condition": "new", "LandedPrice": { "CurrencyCode": "USD", "Amount": 21 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 21 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } } ], "NumberOfOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant", "OfferCount": 1 } ], "BuyBoxEligibleOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant", "OfferCount": 1 } ], "SalesRankings": [ { "ProductCategoryId": "toy_display_on_website", "Rank": 48602 }, { "ProductCategoryId": "166064011", "Rank": 1168 }, { "ProductCategoryId": "251920011", "Rank": 1304 } ], "ListPrice": { "CurrencyCode": "USD", "Amount": 26 }, "TotalOfferCount": 1 }, "Offers": [ { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 21 }, "ShippingTime": { "maximumHours": 24, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A2SNBFWOFW4SWG", "IsFeaturedMerchant": true, "IsBuyBoxWinner": true, "IsFulfilledByAmazon": false } ], "MarketplaceID": "ATVPDKIKX0DER" } }, "headers": { "x-amzn-RequestId": "2889aa8a-77b4-4d11-99f9-5fc24994dc0f", "Date": "Tue, 28 Jun 2022 14:21:22 GMT" }, "request": { "MarketplaceId": "ATVPDKIKX0DER", "Asin": "B000P6Q7MY", "CustomerType": "Consumer", "ItemCondition": "New" } }, { "status": { "statusCode": 200, "reasonPhrase": "OK" }, "body": { "payload": { "ASIN": "B001Q3KU9Q", "status": "Success", "ItemCondition": "New", "Identifier": { "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "ASIN": "B001Q3KU9Q" }, "Summary": { "LowestPrices": [ { "condition": "new", "fulfillmentChannel": "Amazon", "LandedPrice": { "CurrencyCode": "USD", "Amount": 24.99 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 24.99 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } }, { "condition": "collectible", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 20.49 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "Shipping": { "CurrencyCode": "USD", "Amount": 10.49 } } ], "BuyBoxPrices": [ { "condition": "new", "LandedPrice": { "CurrencyCode": "USD", "Amount": 24.99 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 24.99 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } } ], "NumberOfOffers": [ { "condition": "new", "fulfillmentChannel": "Amazon", "OfferCount": 1 }, { "condition": "collectible", "fulfillmentChannel": "Merchant", "OfferCount": 1 } ], "BuyBoxEligibleOffers": [ { "condition": "new", "fulfillmentChannel": "Amazon", "OfferCount": 1 }, { "condition": "collectible", "fulfillmentChannel": "Merchant", "OfferCount": 0 } ], "SalesRankings": [ { "ProductCategoryId": "toy_display_on_website", "Rank": 6674 }, { "ProductCategoryId": "251947011", "Rank": 33 }, { "ProductCategoryId": "23627232011", "Rank": 41 }, { "ProductCategoryId": "251913011", "Rank": 88 } ], "ListPrice": { "CurrencyCode": "USD", "Amount": 27.99 }, "TotalOfferCount": 2 }, "Offers": [ { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 24.99 }, "ShippingTime": { "maximumHours": 0, "minimumHours": 0, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": true, "IsNationalPrime": true }, "SubCondition": "new", "SellerId": "A1OHOT6VONX3KA", "IsFeaturedMerchant": true, "IsBuyBoxWinner": true, "IsFulfilledByAmazon": true } ], "MarketplaceID": "ATVPDKIKX0DER" } }, "headers": { "x-amzn-RequestId": "5ff728ac-8f9c-4caa-99a7-704f898eec9c", "Date": "Tue, 28 Jun 2022 14:21:22 GMT" }, "request": { "MarketplaceId": "ATVPDKIKX0DER", "Asin": "B001Q3KU9Q", "CustomerType": "Consumer", "ItemCondition": "New" } }, { "status": { "statusCode": 200, "reasonPhrase": "OK" }, "body": { "payload": { "ASIN": "B007Z07UK6", "status": "Success", "ItemCondition": "New", "Identifier": { "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "ASIN": "B007Z07UK6" }, "Summary": { "LowestPrices": [ { "condition": "used", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 18 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 11 }, "Shipping": { "CurrencyCode": "USD", "Amount": 7 } }, { "condition": "collectible", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } }, { "condition": "new", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 1 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 1 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } } ], "BuyBoxPrices": [ { "condition": "new", "LandedPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 5.01 }, "Shipping": { "CurrencyCode": "USD", "Amount": 4.99 } } ], "NumberOfOffers": [ { "condition": "used", "fulfillmentChannel": "Merchant", "OfferCount": 2 }, { "condition": "collectible", "fulfillmentChannel": "Merchant", "OfferCount": 1 }, { "condition": "new", "fulfillmentChannel": "Merchant", "OfferCount": 11 } ], "BuyBoxEligibleOffers": [ { "condition": "used", "fulfillmentChannel": "Merchant", "OfferCount": 2 }, { "condition": "collectible", "fulfillmentChannel": "Merchant", "OfferCount": 0 }, { "condition": "new", "fulfillmentChannel": "Merchant", "OfferCount": 2 } ], "SalesRankings": [ { "ProductCategoryId": "fashion_display_on_website", "Rank": 34481 }, { "ProductCategoryId": "3421050011", "Rank": 24 } ], "ListPrice": { "CurrencyCode": "USD", "Amount": 10 }, "TotalOfferCount": 14 }, "Offers": [ { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 1 }, "ShippingTime": { "maximumHours": 720, "minimumHours": 504, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "AFQSGY2BVBPU2", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 3.5 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "ARLPNLRVRA0WL", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 5 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A3QO25ZNO05UF8", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 5 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": true, "IsNationalPrime": true }, "SubCondition": "new", "SellerId": "AQBXQGCOQTJS6", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 5.5 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "ATAQTPUEAJ499", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 4.99 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 5.01 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "AEMQJEQHIGU8X", "IsFeaturedMerchant": true, "IsBuyBoxWinner": true, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A3GAR3KWWUHTHC", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 12 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A2YE02EFDC36RW", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 20 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A17VVVVNIJPQI4", "IsFeaturedMerchant": true, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 50 }, "ShippingTime": { "maximumHours": 24, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": true, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A3ALR9P0658YQT", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 100 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A35LOCZQ3NFRAA", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false } ], "MarketplaceID": "ATVPDKIKX0DER" } }, "headers": { "x-amzn-RequestId": "ab062f54-6b1c-4eab-9c59-f9c85847c3cc", "Date": "Tue, 28 Jun 2022 14:21:22 GMT" }, "request": { "MarketplaceId": "ATVPDKIKX0DER", "Asin": "B007Z07UK6", "CustomerType": "Consumer", "ItemCondition": "New" } }, { "status": { "statusCode": 200, "reasonPhrase": "OK" }, "body": { "payload": { "ASIN": "B000OQA3N4", "status": "Success", "ItemCondition": "New", "Identifier": { "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "ASIN": "B000OQA3N4" }, "Summary": { "LowestPrices": [ { "condition": "new", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } } ], "NumberOfOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant", "OfferCount": 3 } ], "BuyBoxEligibleOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant", "OfferCount": 0 } ], "SalesRankings": [ { "ProductCategoryId": "sports_display_on_website", "Rank": 232244 }, { "ProductCategoryId": "3395921", "Rank": 242 }, { "ProductCategoryId": "19574752011", "Rank": 1579 } ], "ListPrice": { "CurrencyCode": "USD", "Amount": 25 }, "TotalOfferCount": 3 }, "Offers": [ { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A3TH9S8BH6GOGM", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 3.99 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 9.99 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A09263691NO8MK5LA75X2", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 20 }, "ShippingTime": { "maximumHours": 24, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A2SNBFWOFW4SWG", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false } ], "MarketplaceID": "ATVPDKIKX0DER" } }, "headers": { "x-amzn-RequestId": "110f73fc-463d-4a68-a042-3a675ee37367", "Date": "Tue, 28 Jun 2022 14:21:22 GMT" }, "request": { "MarketplaceId": "ATVPDKIKX0DER", "Asin": "B000OQA3N4", "CustomerType": "Consumer", "ItemCondition": "New" } }, { "status": { "statusCode": 200, "reasonPhrase": "OK" }, "body": { "payload": { "ASIN": "B07PTMKYS7", "status": "Success", "ItemCondition": "New", "Identifier": { "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "ASIN": "B07PTMKYS7" }, "Summary": { "LowestPrices": [ { "condition": "collectible", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 200 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 200 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } }, { "condition": "new", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 12 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 12 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } } ], "NumberOfOffers": [ { "condition": "collectible", "fulfillmentChannel": "Merchant", "OfferCount": 1 }, { "condition": "new", "fulfillmentChannel": "Merchant", "OfferCount": 2 } ], "BuyBoxEligibleOffers": [ { "condition": "collectible", "fulfillmentChannel": "Merchant", "OfferCount": 0 }, { "condition": "new", "fulfillmentChannel": "Merchant", "OfferCount": 0 } ], "SalesRankings": [ { "ProductCategoryId": "video_games_display_on_website", "Rank": 2597 }, { "ProductCategoryId": "19497044011", "Rank": 33 }, { "ProductCategoryId": "14670126011", "Rank": 45 } ], "ListPrice": { "CurrencyCode": "USD", "Amount": 399 }, "TotalOfferCount": 3 }, "Offers": [ { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 12 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A3TH9S8BH6GOGM", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 20 }, "ShippingTime": { "maximumHours": 24, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A2SNBFWOFW4SWG", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false } ], "MarketplaceID": "ATVPDKIKX0DER" } }, "headers": { "x-amzn-RequestId": "f5b23d61-455e-40c4-b615-ca03fd0a25de", "Date": "Tue, 28 Jun 2022 14:21:22 GMT" }, "request": { "MarketplaceId": "ATVPDKIKX0DER", "Asin": "B07PTMKYS7", "CustomerType": "Consumer", "ItemCondition": "New" } }, { "status": { "statusCode": 200, "reasonPhrase": "OK" }, "body": { "payload": { "ASIN": "B001PYUTII", "status": "Success", "ItemCondition": "New", "Identifier": { "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "ASIN": "B001PYUTII" }, "Summary": { "LowestPrices": [ { "condition": "used", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 1 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 1 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } }, { "condition": "new", "fulfillmentChannel": "Amazon", "LandedPrice": { "CurrencyCode": "USD", "Amount": 17.99 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 17.99 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } }, { "condition": "collectible", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 20 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 20 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } }, { "condition": "new", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 0.5 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 0.5 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } } ], "BuyBoxPrices": [ { "condition": "new", "LandedPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } } ], "NumberOfOffers": [ { "condition": "used", "fulfillmentChannel": "Merchant", "OfferCount": 4270 }, { "condition": "new", "fulfillmentChannel": "Amazon", "OfferCount": 1 }, { "condition": "collectible", "fulfillmentChannel": "Merchant", "OfferCount": 1 }, { "condition": "new", "fulfillmentChannel": "Merchant", "OfferCount": 14 } ], "BuyBoxEligibleOffers": [ { "condition": "used", "fulfillmentChannel": "Merchant", "OfferCount": 8 }, { "condition": "new", "fulfillmentChannel": "Amazon", "OfferCount": 1 }, { "condition": "collectible", "fulfillmentChannel": "Merchant", "OfferCount": 0 }, { "condition": "new", "fulfillmentChannel": "Merchant", "OfferCount": 2 } ], "SalesRankings": [ { "ProductCategoryId": "toy_display_on_website", "Rank": 30959 }, { "ProductCategoryId": "196604011", "Rank": 94 }, { "ProductCategoryId": "251910011", "Rank": 13863 } ], "ListPrice": { "CurrencyCode": "USD", "Amount": 17.99 }, "TotalOfferCount": 4286 }, "Offers": [ { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 0.5 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A21GPS04ENK3GH", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 9 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A1NHJ2GQHJYKDD", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A1EZPZGQPCQEQR", "IsFeaturedMerchant": true, "IsBuyBoxWinner": true, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A2BSRKTUYRBQX7", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 12.99 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A14RRT8J7KHRG0", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 5 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A29DD74D3MDLD3", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 15 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A1EZPZGQPCQEQR", "IsFeaturedMerchant": true, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 17.99 }, "ShippingTime": { "maximumHours": 0, "minimumHours": 0, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": true, "IsNationalPrime": true }, "SubCondition": "new", "SellerId": "A1OHOT6VONX3KA", "IsFeaturedMerchant": true, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": true }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 23 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A2NO69NJS5R7BW", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 23 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A3J2OPDM7RLS9A", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 30 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "AA7AN6LI5ZZMD", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 30 }, "ShippingTime": { "maximumHours": 24, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A2SNBFWOFW4SWG", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 5 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 30 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A29DD74D3MDLD3", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 50 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A3D4MFKTUUP0RS", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 1400 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A16ZGNLKQR74W7", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false } ], "MarketplaceID": "ATVPDKIKX0DER" } }, "headers": { "x-amzn-RequestId": "5b4ebbf3-cd9f-4e5f-a252-1aed3933ae0e", "Date": "Tue, 28 Jun 2022 14:21:25 GMT" }, "request": { "MarketplaceId": "ATVPDKIKX0DER", "Asin": "B001PYUTII", "CustomerType": "Consumer", "ItemCondition": "New" } }, { "status": { "statusCode": 200, "reasonPhrase": "OK" }, "body": { "payload": { "ASIN": "B00505DW2I", "status": "Success", "ItemCondition": "New", "Identifier": { "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "ASIN": "B00505DW2I" }, "Summary": { "LowestPrices": [ { "condition": "new", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 14.99 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "Shipping": { "CurrencyCode": "USD", "Amount": 4.99 } } ], "BuyBoxPrices": [ { "condition": "new", "LandedPrice": { "CurrencyCode": "USD", "Amount": 14.99 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "Shipping": { "CurrencyCode": "USD", "Amount": 4.99 } } ], "NumberOfOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant", "OfferCount": 3 } ], "BuyBoxEligibleOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant", "OfferCount": 3 } ], "SalesRankings": [ { "ProductCategoryId": "toy_display_on_website", "Rank": 6581 }, { "ProductCategoryId": "14194715011", "Rank": 11 }, { "ProductCategoryId": "251975011", "Rank": 15 } ], "ListPrice": { "CurrencyCode": "USD", "Amount": 36 }, "TotalOfferCount": 3 }, "Offers": [ { "Shipping": { "CurrencyCode": "USD", "Amount": 4.99 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A5LI4TEX5CN80", "IsFeaturedMerchant": true, "IsBuyBoxWinner": true, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 15 }, "ShippingTime": { "maximumHours": 24, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A2SNBFWOFW4SWG", "IsFeaturedMerchant": true, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 33 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "AH2OYH1RAT8PM", "IsFeaturedMerchant": true, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false } ], "MarketplaceID": "ATVPDKIKX0DER" } }, "headers": { "x-amzn-RequestId": "da27fbae-3066-44b5-8f08-d472152eea0b", "Date": "Tue, 28 Jun 2022 14:21:22 GMT" }, "request": { "MarketplaceId": "ATVPDKIKX0DER", "Asin": "B00505DW2I", "CustomerType": "Consumer", "ItemCondition": "New" } }, { "status": { "statusCode": 200, "reasonPhrase": "OK" }, "body": { "payload": { "ASIN": "B00CGZQU42", "status": "Success", "ItemCondition": "New", "Identifier": { "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "ASIN": "B00CGZQU42" }, "Summary": { "LowestPrices": [ { "condition": "new", "fulfillmentChannel": "Amazon", "LandedPrice": { "CurrencyCode": "USD", "Amount": 100 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 100 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } }, { "condition": "new", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 50 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 50 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } } ], "BuyBoxPrices": [ { "condition": "new", "LandedPrice": { "CurrencyCode": "USD", "Amount": 50 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 50 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } } ], "NumberOfOffers": [ { "condition": "new", "fulfillmentChannel": "Amazon", "OfferCount": 1 }, { "condition": "new", "fulfillmentChannel": "Merchant", "OfferCount": 2 } ], "BuyBoxEligibleOffers": [ { "condition": "new", "fulfillmentChannel": "Amazon", "OfferCount": 1 }, { "condition": "new", "fulfillmentChannel": "Merchant", "OfferCount": 1 } ], "SalesRankings": [ { "ProductCategoryId": "fashion_display_on_website", "Rank": 1093666 }, { "ProductCategoryId": "1045012", "Rank": 2179 } ], "ListPrice": { "CurrencyCode": "USD", "Amount": 18.99 }, "TotalOfferCount": 3 }, "Offers": [ { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 50 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A3CTKJEUROOISL", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 50 }, "ShippingTime": { "maximumHours": 24, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A2SNBFWOFW4SWG", "IsFeaturedMerchant": true, "IsBuyBoxWinner": true, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 100 }, "ShippingTime": { "maximumHours": 0, "minimumHours": 0, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": true, "IsNationalPrime": true }, "SubCondition": "new", "SellerId": "A16V258PS36Q2H", "IsFeaturedMerchant": true, "IsBuyBoxWinner": false, "IsFulfilledByAmazon": true } ], "MarketplaceID": "ATVPDKIKX0DER" } }, "headers": { "x-amzn-RequestId": "057b337c-3c17-4bbd-9bbf-79c1ef756dc0", "Date": "Tue, 28 Jun 2022 14:21:22 GMT" }, "request": { "MarketplaceId": "ATVPDKIKX0DER", "Asin": "B00CGZQU42", "CustomerType": "Consumer", "ItemCondition": "New" } }, { "status": { "statusCode": 200, "reasonPhrase": "OK" }, "body": { "payload": { "ASIN": "B01LY2ZYRF", "status": "Success", "ItemCondition": "New", "Identifier": { "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "ASIN": "B01LY2ZYRF" }, "Summary": { "LowestPrices": [ { "condition": "new", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 22 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 22 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } } ], "BuyBoxPrices": [ { "condition": "new", "LandedPrice": { "CurrencyCode": "USD", "Amount": 22 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 22 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } } ], "NumberOfOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant", "OfferCount": 1 } ], "BuyBoxEligibleOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant", "OfferCount": 1 } ], "ListPrice": { "CurrencyCode": "USD", "Amount": 59.5 }, "TotalOfferCount": 1 }, "Offers": [ { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 22 }, "ShippingTime": { "maximumHours": 24, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A2SNBFWOFW4SWG", "IsFeaturedMerchant": true, "IsBuyBoxWinner": true, "IsFulfilledByAmazon": false } ], "MarketplaceID": "ATVPDKIKX0DER" } }, "headers": { "x-amzn-RequestId": "196a1220-82c4-4b07-8a73-a7d92511f6ef", "Date": "Tue, 28 Jun 2022 14:21:22 GMT" }, "request": { "MarketplaceId": "ATVPDKIKX0DER", "Asin": "B01LY2ZYRF", "CustomerType": "Consumer", "ItemCondition": "New" } }, { "status": { "statusCode": 200, "reasonPhrase": "OK" }, "body": { "payload": { "ASIN": "B00KFRNZY6", "status": "NoBuyableOffers", "ItemCondition": "New", "Identifier": { "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "ASIN": "B00KFRNZY6" }, "Summary": { "TotalOfferCount": 0 }, "Offers": [], "MarketplaceID": "ATVPDKIKX0DER" } }, "headers": { "x-amzn-RequestId": "7e49bdbb-7347-46fe-8c66-beb7b9c08118", "Date": "Tue, 28 Jun 2022 14:21:23 GMT" }, "request": { "MarketplaceId": "ATVPDKIKX0DER", "Asin": "B00KFRNZY6", "CustomerType": "Consumer", "ItemCondition": "New" } } ] } } ] } }, "400": { "description": "Request has missing or invalid parameters and cannot be parsed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Errors" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "body": { "value": { "requests": [ { "uri": "/products/pricing/v0/items/B000P6Q7MY/offers", "method": "GET", "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "CustomerType": "Consumer" } ] } } } }, "response": { "errors": [ { "code": "InvalidInput", "message": "Invalid Input" } ] } } ] } }, "401": { "description": "The request's Authorization header is not formatted correctly or does not contain a valid token.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Errors" } } } }, "403": { "description": "Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Errors" } } } }, "404": { "description": "The specified resource does not exist.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Errors" } } } }, "429": { "description": "The frequency of requests was greater than allowed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Errors" } } } }, "500": { "description": "An unexpected condition occurred that prevented the server from fulfilling the request.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Errors" } } } }, "503": { "description": "Temporary overloading or maintenance of the server.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Errors" } } } } }, "x-codegen-request-body-name": "getItemOffersBatchRequestBody" } }, "/batches/products/pricing/v0/listingOffers": { "post": { "tags": [ "productPricing" ], "description": "Returns the lowest priced offers for a batch of listings by SKU.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 0.5 | 1 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).", "operationId": "getListingOffersBatch", "requestBody": { "description": "The request associated with the `getListingOffersBatch` API call.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetListingOffersBatchRequest" } } }, "required": true }, "responses": { "200": { "description": "Indicates that requests were run in batch. Check the batch response status lines for information on whether a batch request succeeded.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetListingOffersBatchResponse" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "body": { "value": { "requests": [ { "uri": "/products/pricing/v0/listings/GC-QTMS-SV2I/offers", "method": "GET", "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "CustomerType": "Consumer" }, { "uri": "/products/pricing/v0/listings/VT-DEIT-57TQ/offers", "method": "GET", "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "CustomerType": "Consumer" }, { "uri": "/products/pricing/v0/listings/NA-H7X1-JYTM/offers", "method": "GET", "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "CustomerType": "Consumer" }, { "uri": "/products/pricing/v0/listings/RL-JVOC-MBSL/offers", "method": "GET", "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "CustomerType": "Consumer" }, { "uri": "/products/pricing/v0/listings/74-64KG-H9W9/offers", "method": "GET", "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "CustomerType": "Consumer" } ] } } } }, "response": { "responses": [ { "status": { "statusCode": 200, "reasonPhrase": "OK" }, "body": { "payload": { "SKU": "GC-QTMS-SV2I", "status": "Success", "ItemCondition": "New", "Identifier": { "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "SellerSKU": "GC-QTMS-SV2I" }, "Summary": { "LowestPrices": [ { "condition": "used", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 1 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 1 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } }, { "condition": "new", "fulfillmentChannel": "Amazon", "LandedPrice": { "CurrencyCode": "USD", "Amount": 17.99 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 17.99 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } }, { "condition": "collectible", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 20 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 20 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } }, { "condition": "new", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 0.5 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 0.5 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } } ], "BuyBoxPrices": [ { "condition": "new", "LandedPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } } ], "NumberOfOffers": [ { "condition": "used", "fulfillmentChannel": "Merchant", "OfferCount": 4270 }, { "condition": "new", "fulfillmentChannel": "Amazon", "OfferCount": 1 }, { "condition": "collectible", "fulfillmentChannel": "Merchant", "OfferCount": 1 }, { "condition": "new", "fulfillmentChannel": "Merchant", "OfferCount": 14 } ], "BuyBoxEligibleOffers": [ { "condition": "used", "fulfillmentChannel": "Merchant" }, { "condition": "new", "fulfillmentChannel": "Amazon" }, { "condition": "collectible", "fulfillmentChannel": "Merchant" }, { "condition": "new", "fulfillmentChannel": "Merchant" } ], "SalesRankings": [ { "ProductCategoryId": "toy_display_on_website", "Rank": 30959 }, { "ProductCategoryId": "196604011", "Rank": 94 }, { "ProductCategoryId": "251910011", "Rank": 13863 } ], "ListPrice": { "CurrencyCode": "USD", "Amount": 17.99 }, "TotalOfferCount": 4286 }, "Offers": [ { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 0.5 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A21GPS04ENK3GH", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 9 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A1NHJ2GQHJYKDD", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A1EZPZGQPCQEQR", "IsFeaturedMerchant": true, "IsBuyBoxWinner": true, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A2BSRKTUYRBQX7", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 12.99 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A14RRT8J7KHRG0", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 5 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A29DD74D3MDLD3", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 15 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A1EZPZGQPCQEQR", "IsFeaturedMerchant": true, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 17.99 }, "ShippingTime": { "maximumHours": 0, "minimumHours": 0, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": true, "IsNationalPrime": true }, "SubCondition": "new", "SellerId": "A1OHOT6VONX3KA", "IsFeaturedMerchant": true, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": true }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 23 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A2NO69NJS5R7BW", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 23 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A3J2OPDM7RLS9A", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 30 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "AA7AN6LI5ZZMD", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 30 }, "ShippingTime": { "maximumHours": 24, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A2SNBFWOFW4SWG", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": true, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 5 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 30 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A29DD74D3MDLD3", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 50 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A3D4MFKTUUP0RS", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 1400 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A16ZGNLKQR74W7", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false } ], "MarketplaceID": "ATVPDKIKX0DER" } }, "headers": { "x-amzn-RequestId": "ffd73923-1728-4d57-a45b-8e07a5e10366", "Date": "Tue, 28 Jun 2022 14:18:08 GMT" }, "request": { "MarketplaceId": "ATVPDKIKX0DER", "SellerSKU": "GC-QTMS-SV2I", "CustomerType": "Consumer", "ItemCondition": "New" } }, { "status": { "statusCode": 200, "reasonPhrase": "OK" }, "body": { "payload": { "SKU": "VT-DEIT-57TQ", "status": "Success", "ItemCondition": "New", "Identifier": { "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "SellerSKU": "VT-DEIT-57TQ" }, "Summary": { "LowestPrices": [ { "condition": "new", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 14.99 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "Shipping": { "CurrencyCode": "USD", "Amount": 4.99 } } ], "BuyBoxPrices": [ { "condition": "new", "LandedPrice": { "CurrencyCode": "USD", "Amount": 14.99 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "Shipping": { "CurrencyCode": "USD", "Amount": 4.99 } } ], "NumberOfOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant", "OfferCount": 3 } ], "BuyBoxEligibleOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant" } ], "SalesRankings": [ { "ProductCategoryId": "toy_display_on_website", "Rank": 6581 }, { "ProductCategoryId": "14194715011", "Rank": 11 }, { "ProductCategoryId": "251975011", "Rank": 15 } ], "ListPrice": { "CurrencyCode": "USD", "Amount": 36 }, "TotalOfferCount": 3 }, "Offers": [ { "Shipping": { "CurrencyCode": "USD", "Amount": 4.99 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A5LI4TEX5CN80", "IsFeaturedMerchant": true, "IsBuyBoxWinner": true, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 15 }, "ShippingTime": { "maximumHours": 24, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A2SNBFWOFW4SWG", "IsFeaturedMerchant": true, "IsBuyBoxWinner": false, "MyOffer": true, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 33 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "AH2OYH1RAT8PM", "IsFeaturedMerchant": true, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false } ], "MarketplaceID": "ATVPDKIKX0DER" } }, "headers": { "x-amzn-RequestId": "96372776-dae8-4cd3-8edf-c9cd2d708c0c", "Date": "Tue, 28 Jun 2022 14:18:05 GMT" }, "request": { "MarketplaceId": "ATVPDKIKX0DER", "SellerSKU": "VT-DEIT-57TQ", "CustomerType": "Consumer", "ItemCondition": "New" } }, { "status": { "statusCode": 200, "reasonPhrase": "OK" }, "body": { "payload": { "SKU": "NA-H7X1-JYTM", "status": "Success", "ItemCondition": "New", "Identifier": { "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "SellerSKU": "NA-H7X1-JYTM" }, "Summary": { "LowestPrices": [ { "condition": "used", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 18 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 11 }, "Shipping": { "CurrencyCode": "USD", "Amount": 7 } }, { "condition": "collectible", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } }, { "condition": "new", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 1 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 1 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } } ], "BuyBoxPrices": [ { "condition": "new", "LandedPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 5.01 }, "Shipping": { "CurrencyCode": "USD", "Amount": 4.99 } } ], "NumberOfOffers": [ { "condition": "used", "fulfillmentChannel": "Merchant", "OfferCount": 2 }, { "condition": "collectible", "fulfillmentChannel": "Merchant", "OfferCount": 1 }, { "condition": "new", "fulfillmentChannel": "Merchant", "OfferCount": 11 } ], "BuyBoxEligibleOffers": [ { "condition": "used", "fulfillmentChannel": "Merchant" }, { "condition": "collectible", "fulfillmentChannel": "Merchant" }, { "condition": "new", "fulfillmentChannel": "Merchant" } ], "SalesRankings": [ { "ProductCategoryId": "fashion_display_on_website", "Rank": 34481 }, { "ProductCategoryId": "3421050011", "Rank": 24 } ], "ListPrice": { "CurrencyCode": "USD", "Amount": 10 }, "TotalOfferCount": 14 }, "Offers": [ { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 1 }, "ShippingTime": { "maximumHours": 720, "minimumHours": 504, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "AFQSGY2BVBPU2", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 3.5 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "ARLPNLRVRA0WL", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 5 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A3QO25ZNO05UF8", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 5 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": true, "IsNationalPrime": true }, "SubCondition": "new", "SellerId": "AQBXQGCOQTJS6", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 5.5 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "ATAQTPUEAJ499", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 4.99 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 5.01 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "AEMQJEQHIGU8X", "IsFeaturedMerchant": true, "IsBuyBoxWinner": true, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A3GAR3KWWUHTHC", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 12 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A2YE02EFDC36RW", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 20 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A17VVVVNIJPQI4", "IsFeaturedMerchant": true, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 50 }, "ShippingTime": { "maximumHours": 24, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": true, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A3ALR9P0658YQT", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 100 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A35LOCZQ3NFRAA", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false } ], "MarketplaceID": "ATVPDKIKX0DER" } }, "headers": { "x-amzn-RequestId": "0160ecba-a238-40ba-8ef9-647e9a0baf55", "Date": "Tue, 28 Jun 2022 14:18:05 GMT" }, "request": { "MarketplaceId": "ATVPDKIKX0DER", "SellerSKU": "NA-H7X1-JYTM", "CustomerType": "Consumer", "ItemCondition": "New" } }, { "status": { "statusCode": 200, "reasonPhrase": "OK" }, "body": { "payload": { "SKU": "RL-JVOC-MBSL", "status": "Success", "ItemCondition": "New", "Identifier": { "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "SellerSKU": "RL-JVOC-MBSL" }, "Summary": { "LowestPrices": [ { "condition": "new", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } } ], "NumberOfOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant", "OfferCount": 3 } ], "BuyBoxEligibleOffers": [ { "condition": "new", "fulfillmentChannel": "Merchant" } ], "SalesRankings": [ { "ProductCategoryId": "sports_display_on_website", "Rank": 232244 }, { "ProductCategoryId": "3395921", "Rank": 242 }, { "ProductCategoryId": "19574752011", "Rank": 1579 } ], "ListPrice": { "CurrencyCode": "USD", "Amount": 25 }, "TotalOfferCount": 3 }, "Offers": [ { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 10 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A3TH9S8BH6GOGM", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 3.99 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 9.99 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A09263691NO8MK5LA75X2", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 20 }, "ShippingTime": { "maximumHours": 24, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A2SNBFWOFW4SWG", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": true, "IsFulfilledByAmazon": false } ], "MarketplaceID": "ATVPDKIKX0DER" } }, "headers": { "x-amzn-RequestId": "09d9fb32-661e-44f3-ac59-b2f91bb3d88e", "Date": "Tue, 28 Jun 2022 14:18:05 GMT" }, "request": { "MarketplaceId": "ATVPDKIKX0DER", "SellerSKU": "RL-JVOC-MBSL", "CustomerType": "Consumer", "ItemCondition": "New" } }, { "status": { "statusCode": 200, "reasonPhrase": "OK" }, "body": { "payload": { "SKU": "74-64KG-H9W9", "status": "Success", "ItemCondition": "New", "Identifier": { "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "SellerSKU": "74-64KG-H9W9" }, "Summary": { "LowestPrices": [ { "condition": "collectible", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 200 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 200 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } }, { "condition": "new", "fulfillmentChannel": "Merchant", "LandedPrice": { "CurrencyCode": "USD", "Amount": 12 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 12 }, "Shipping": { "CurrencyCode": "USD", "Amount": 0 } } ], "NumberOfOffers": [ { "condition": "collectible", "fulfillmentChannel": "Merchant", "OfferCount": 1 }, { "condition": "new", "fulfillmentChannel": "Merchant", "OfferCount": 2 } ], "BuyBoxEligibleOffers": [ { "condition": "collectible", "fulfillmentChannel": "Merchant" }, { "condition": "new", "fulfillmentChannel": "Merchant" } ], "SalesRankings": [ { "ProductCategoryId": "video_games_display_on_website", "Rank": 2597 }, { "ProductCategoryId": "19497044011", "Rank": 33 }, { "ProductCategoryId": "14670126011", "Rank": 45 } ], "ListPrice": { "CurrencyCode": "USD", "Amount": 399 }, "TotalOfferCount": 3 }, "Offers": [ { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 12 }, "ShippingTime": { "maximumHours": 48, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A3TH9S8BH6GOGM", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": false, "IsFulfilledByAmazon": false }, { "Shipping": { "CurrencyCode": "USD", "Amount": 0 }, "ListingPrice": { "CurrencyCode": "USD", "Amount": 20 }, "ShippingTime": { "maximumHours": 24, "minimumHours": 24, "availabilityType": "NOW" }, "ShipsFrom": { "Country": "US" }, "PrimeInformation": { "IsPrime": false, "IsNationalPrime": false }, "SubCondition": "new", "SellerId": "A2SNBFWOFW4SWG", "IsFeaturedMerchant": false, "IsBuyBoxWinner": false, "MyOffer": true, "IsFulfilledByAmazon": false } ], "MarketplaceID": "ATVPDKIKX0DER" } }, "headers": { "x-amzn-RequestId": "0df944c2-6de5-48d1-9c9c-df138c00e797", "Date": "Tue, 28 Jun 2022 14:18:05 GMT" }, "request": { "MarketplaceId": "ATVPDKIKX0DER", "SellerSKU": "74-64KG-H9W9", "CustomerType": "Consumer", "ItemCondition": "New" } } ] } } ] } }, "400": { "description": "Request has missing or invalid parameters and cannot be parsed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Errors" } } }, "x-amzn-api-sandbox": { "static": [ { "request": { "parameters": { "body": { "value": { "requests": [ { "uri": "/products/pricing/v0/listings/GC-QTMS-SV2I/offers", "method": "GET", "MarketplaceId": "ATVPDKIKX0DER", "ItemCondition": "New", "CustomerType": "Consumer" } ] } } } }, "response": { "errors": [ { "code": "InvalidInput", "message": "Invalid Input" } ] } } ] } }, "401": { "description": "The request's Authorization header is not formatted correctly or does not contain a valid token.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Errors" } } } }, "403": { "description": "Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Errors" } } } }, "404": { "description": "The specified resource does not exist.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } }, "x-amzn-RateLimit-Limit": { "description": "Your rate limit (requests per second) for this operation.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Errors" } } } }, "429": { "description": "The frequency of requests was greater than allowed.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Errors" } } } }, "500": { "description": "An unexpected condition occurred that prevented the server from fulfilling the request.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Errors" } } } }, "503": { "description": "Temporary overloading or maintenance of the server.", "headers": { "x-amzn-RequestId": { "description": "Unique request reference identifier.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Errors" } } } } }, "x-codegen-request-body-name": "getListingOffersBatchRequestBody" } } }, "components": { "schemas": { "GetItemOffersBatchRequest": { "type": "object", "properties": { "requests": { "$ref": "#/components/schemas/ItemOffersRequestList" } }, "description": "The request associated with the `getItemOffersBatch` API call." }, "GetListingOffersBatchRequest": { "type": "object", "properties": { "requests": { "$ref": "#/components/schemas/ListingOffersRequestList" } }, "description": "The request associated with the `getListingOffersBatch` API call." }, "ListingOffersRequestList": { "maxItems": 20, "minItems": 1, "type": "array", "description": "A list of `getListingOffers` batched requests to run.", "items": { "$ref": "#/components/schemas/ListingOffersRequest" } }, "ItemOffersRequestList": { "maxItems": 20, "minItems": 1, "type": "array", "description": "A list of `getListingOffers` batched requests to run.", "items": { "$ref": "#/components/schemas/ItemOffersRequest" } }, "BatchOffersRequestParams": { "required": [ "ItemCondition", "MarketplaceId" ], "type": "object", "properties": { "MarketplaceId": { "$ref": "#/components/schemas/MarketplaceId" }, "ItemCondition": { "$ref": "#/components/schemas/ItemCondition" }, "CustomerType": { "$ref": "#/components/schemas/CustomerType" } }, "description": "Common request parameters that can be accepted by `ItemOffersRequest` and `ListingOffersRequest`" }, "ItemOffersRequest": { "description": "List of request parameters can be accepted by `ItemOffersRequests` operation", "allOf": [ { "$ref": "#/components/schemas/BatchRequest" }, { "$ref": "#/components/schemas/BatchOffersRequestParams" } ] }, "ListingOffersRequest": { "description": "List of request parameters that can be accepted by `ListingOffersRequest` operation", "allOf": [ { "$ref": "#/components/schemas/BatchRequest" }, { "$ref": "#/components/schemas/BatchOffersRequestParams" } ] }, "GetItemOffersBatchResponse": { "type": "object", "properties": { "responses": { "$ref": "#/components/schemas/ItemOffersResponseList" } }, "description": "The response associated with the `getItemOffersBatch` API call." }, "GetListingOffersBatchResponse": { "type": "object", "properties": { "responses": { "$ref": "#/components/schemas/ListingOffersResponseList" } }, "description": "The response associated with the `getListingOffersBatch` API call." }, "ItemOffersResponseList": { "maxItems": 20, "minItems": 1, "type": "array", "description": "A list of `getItemOffers` batched responses.", "items": { "$ref": "#/components/schemas/ItemOffersResponse" } }, "ListingOffersResponseList": { "maxItems": 20, "minItems": 1, "type": "array", "description": "A list of `getListingOffers` batched responses.", "items": { "$ref": "#/components/schemas/ListingOffersResponse" } }, "BatchOffersResponse": { "required": [ "body" ], "type": "object", "properties": { "headers": { "$ref": "#/components/schemas/HttpResponseHeaders" }, "status": { "$ref": "#/components/schemas/GetOffersHttpStatusLine" }, "body": { "$ref": "#/components/schemas/GetOffersResponse" } }, "description": "Common schema that present in `ItemOffersResponse` and `ListingOffersResponse`" }, "ItemOffersRequestParams": { "description": "List of request parameters that can be accepted by `ItemOffersRequest`", "allOf": [ { "$ref": "#/components/schemas/BatchOffersRequestParams" }, { "type": "object", "properties": { "Asin": { "type": "string", "description": "The Amazon Standard Identification Number (ASIN) of the item. This is the same Asin passed as a request parameter." } } } ] }, "ItemOffersResponse": { "description": "Schema for an individual `ItemOffersResponse`", "allOf": [ { "$ref": "#/components/schemas/BatchOffersResponse" }, { "required": [ "request" ], "type": "object", "properties": { "request": { "$ref": "#/components/schemas/ItemOffersRequestParams" } } } ] }, "ListingOffersRequestParams": { "description": "List of request parameters that can be accepted by `ListingOffersRequest`", "allOf": [ { "$ref": "#/components/schemas/BatchOffersRequestParams" }, { "required": [ "SellerSKU" ], "type": "object", "properties": { "SellerSKU": { "type": "string", "description": "The seller stock keeping unit (SKU) of the item. This is the same SKU passed as a path parameter." } } } ] }, "ListingOffersResponse": { "description": "Schema for an individual `ListingOffersResponse`", "allOf": [ { "$ref": "#/components/schemas/BatchOffersResponse" }, { "type": "object", "properties": { "request": { "$ref": "#/components/schemas/ListingOffersRequestParams" } } } ] }, "Errors": { "required": [ "errors" ], "type": "object", "properties": { "errors": { "$ref": "#/components/schemas/ErrorList" } }, "description": "A list of error responses returned when a request is unsuccessful." }, "GetPricingResponse": { "type": "object", "properties": { "payload": { "$ref": "#/components/schemas/PriceList" }, "errors": { "$ref": "#/components/schemas/ErrorList" } }, "description": "The response schema for the `getPricing` and `getCompetitivePricing` operations." }, "GetOffersResponse": { "type": "object", "properties": { "payload": { "$ref": "#/components/schemas/GetOffersResult" }, "errors": { "$ref": "#/components/schemas/ErrorList" } }, "description": "The response schema for the `getListingOffers` and `getItemOffers` operations." }, "PriceList": { "maxItems": 20, "type": "array", "description": "The payload for the `getPricing` and `getCompetitivePricing` operations.", "items": { "$ref": "#/components/schemas/Price" } }, "GetOffersResult": { "required": [ "Identifier", "ItemCondition", "MarketplaceID", "Offers", "Summary", "status" ], "type": "object", "properties": { "MarketplaceID": { "type": "string", "description": "A marketplace identifier." }, "ASIN": { "type": "string", "description": "The Amazon Standard Identification Number (ASIN) of the item." }, "SKU": { "type": "string", "description": "The stock keeping unit (SKU) of the item." }, "ItemCondition": { "$ref": "#/components/schemas/ConditionType" }, "status": { "type": "string", "description": "The status of the operation." }, "Identifier": { "$ref": "#/components/schemas/ItemIdentifier" }, "Summary": { "$ref": "#/components/schemas/Summary" }, "Offers": { "$ref": "#/components/schemas/OfferDetailList" } }, "description": "The payload for the getListingOffers and getItemOffers operations." }, "HttpRequestHeaders": { "type": "object", "additionalProperties": { "type": "string" }, "description": "A mapping of additional HTTP headers to send/receive for the individual batch request." }, "HttpResponseHeaders": { "type": "object", "properties": { "Date": { "type": "string", "description": "The timestamp that the API request was received. For more information, consult [RFC 2616 Section 14](https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html)." }, "x-amzn-RequestId": { "type": "string", "description": "Unique request reference identifier." } }, "additionalProperties": { "type": "string" }, "description": "A mapping of additional HTTP headers to send/receive for the individual batch request." }, "GetOffersHttpStatusLine": { "type": "object", "properties": { "statusCode": { "maximum": 599, "minimum": 100, "type": "integer", "description": "The HTTP response Status Code." }, "reasonPhrase": { "type": "string", "description": "The HTTP response Reason-Phase." } }, "description": "The HTTP status line associated with the response. For more information, consult [RFC 2616](https://www.w3.org/Protocols/rfc2616/rfc2616-sec6.html)." }, "HttpUri": { "maxLength": 512, "minLength": 6, "type": "string", "description": "The URI associated with the individual APIs being called as part of the batch request." }, "HttpMethod": { "type": "string", "description": "The HTTP method associated with the individual APIs being called as part of the batch request.", "enum": [ "GET", "PUT", "PATCH", "DELETE", "POST" ], "x-docgen-enum-table-extension": [ { "value": "GET", "description": "GET" }, { "value": "PUT", "description": "PUT" }, { "value": "PATCH", "description": "PATCH" }, { "value": "DELETE", "description": "DELETE" }, { "value": "POST", "description": "POST" } ] }, "BatchRequest": { "required": [ "method", "uri" ], "type": "object", "properties": { "uri": { "type": "string", "description": "The resource path of the operation you are calling in batch without any query parameters.\n\nIf you are calling `getItemOffersBatch`, supply the path of `getItemOffers`.\n\n**Example:** `/products/pricing/v0/items/B000P6Q7MY/offers`\n\nIf you are calling `getListingOffersBatch`, supply the path of `getListingOffers`.\n\n**Example:** `/products/pricing/v0/listings/B000P6Q7MY/offers`" }, "method": { "$ref": "#/components/schemas/HttpMethod" }, "headers": { "$ref": "#/components/schemas/HttpRequestHeaders" } }, "description": "Common properties of batch requests against individual APIs." }, "Price": { "required": [ "status" ], "type": "object", "properties": { "status": { "type": "string", "description": "The status of the operation." }, "SellerSKU": { "type": "string", "description": "The seller stock keeping unit (SKU) of the item." }, "ASIN": { "type": "string", "description": "The Amazon Standard Identification Number (ASIN) of the item." }, "Product": { "$ref": "#/components/schemas/Product" } }, "description": "Schema for price info in `getPricing` response" }, "Product": { "required": [ "Identifiers" ], "type": "object", "properties": { "Identifiers": { "$ref": "#/components/schemas/IdentifierType" }, "AttributeSets": { "$ref": "#/components/schemas/AttributeSetList" }, "Relationships": { "$ref": "#/components/schemas/RelationshipList" }, "CompetitivePricing": { "$ref": "#/components/schemas/CompetitivePricingType" }, "SalesRankings": { "$ref": "#/components/schemas/SalesRankList" }, "Offers": { "$ref": "#/components/schemas/OffersList" } }, "description": "An item." }, "IdentifierType": { "required": [ "MarketplaceASIN" ], "type": "object", "properties": { "MarketplaceASIN": { "$ref": "#/components/schemas/ASINIdentifier" }, "SKUIdentifier": { "$ref": "#/components/schemas/SellerSKUIdentifier" } }, "description": "Specifies the identifiers used to uniquely identify an item." }, "ASINIdentifier": { "required": [ "ASIN", "MarketplaceId" ], "type": "object", "properties": { "MarketplaceId": { "type": "string", "description": "A marketplace identifier." }, "ASIN": { "type": "string", "description": "The Amazon Standard Identification Number (ASIN) of the item." } }, "description": "Schema to identify an item by MarketPlaceId and ASIN." }, "SellerSKUIdentifier": { "required": [ "MarketplaceId", "SellerId", "SellerSKU" ], "type": "object", "properties": { "MarketplaceId": { "type": "string", "description": "A marketplace identifier." }, "SellerId": { "type": "string", "description": "The seller identifier submitted for the operation." }, "SellerSKU": { "type": "string", "description": "The seller stock keeping unit (SKU) of the item." } }, "description": "Schema to identify an item by MarketPlaceId, SellerId, and SellerSKU." }, "AttributeSetList": { "type": "array", "description": "A list of product attributes if they are applicable to the product that is returned.", "items": { "type": "object", "properties": {} } }, "RelationshipList": { "type": "array", "description": "A list that contains product variation information, if applicable.", "items": { "type": "object", "properties": {} } }, "CompetitivePricingType": { "required": [ "CompetitivePrices", "NumberOfOfferListings" ], "type": "object", "properties": { "CompetitivePrices": { "$ref": "#/components/schemas/CompetitivePriceList" }, "NumberOfOfferListings": { "$ref": "#/components/schemas/NumberOfOfferListingsList" }, "TradeInValue": { "$ref": "#/components/schemas/MoneyType" } }, "description": "Competitive pricing information for the item." }, "CompetitivePriceList": { "type": "array", "description": "A list of competitive pricing information.", "items": { "$ref": "#/components/schemas/CompetitivePriceType" } }, "CompetitivePriceType": { "required": [ "CompetitivePriceId", "Price" ], "type": "object", "properties": { "CompetitivePriceId": { "type": "string", "description": "The pricing model for each price that is returned.\n\nPossible values:\n\n* 1 - New Buy Box Price.\n* 2 - Used Buy Box Price." }, "Price": { "$ref": "#/components/schemas/PriceType" }, "condition": { "type": "string", "description": "Indicates the condition of the item whose pricing information is returned. Possible values are: New, Used, Collectible, Refurbished, or Club." }, "subcondition": { "type": "string", "description": "Indicates the subcondition of the item whose pricing information is returned. Possible values are: New, Mint, Very Good, Good, Acceptable, Poor, Club, OEM, Warranty, Refurbished Warranty, Refurbished, Open Box, or Other." }, "offerType": { "$ref": "#/components/schemas/OfferCustomerType" }, "quantityTier": { "type": "integer", "description": "Indicates at what quantity this price becomes active.", "format": "int32" }, "quantityDiscountType": { "$ref": "#/components/schemas/QuantityDiscountType" }, "sellerId": { "type": "string", "description": "The seller identifier for the offer." }, "belongsToRequester": { "type": "boolean", "description": " Indicates whether or not the pricing information is for an offer listing that belongs to the requester. The requester is the seller associated with the SellerId that was submitted with the request. Possible values are: true and false." } }, "description": "Schema for competitive pricing information" }, "NumberOfOfferListingsList": { "type": "array", "description": "The number of active offer listings for the item that was submitted. The listing count is returned by condition, one for each listing condition value that is returned.", "items": { "$ref": "#/components/schemas/OfferListingCountType" } }, "OfferListingCountType": { "required": [ "Count", "condition" ], "type": "object", "properties": { "Count": { "type": "integer", "description": "The number of offer listings.", "format": "int32" }, "condition": { "type": "string", "description": "The condition of the item." } }, "description": "The number of offer listings with the specified condition." }, "MoneyType": { "type": "object", "properties": { "CurrencyCode": { "type": "string", "description": "The currency code in ISO 4217 format." }, "Amount": { "type": "number", "description": "The monetary value." } }, "description": "Currency type and monetary value. Schema for demonstrating pricing info." }, "SalesRankList": { "type": "array", "description": "A list of sales rank information for the item, by category.", "items": { "$ref": "#/components/schemas/SalesRankType" } }, "SalesRankType": { "required": [ "ProductCategoryId", "Rank" ], "type": "object", "properties": { "ProductCategoryId": { "type": "string", "description": " Identifies the item category from which the sales rank is taken." }, "Rank": { "type": "integer", "description": "The sales rank of the item within the item category.", "format": "int32" } }, "description": "Sales rank information for the item, by category" }, "PriceType": { "required": [ "ListingPrice" ], "type": "object", "properties": { "LandedPrice": { "$ref": "#/components/schemas/MoneyType" }, "ListingPrice": { "$ref": "#/components/schemas/MoneyType" }, "Shipping": { "$ref": "#/components/schemas/MoneyType" }, "Points": { "$ref": "#/components/schemas/Points" } }, "description": "Schema for item's price information, including listing price, shipping price, and Amazon points." }, "OffersList": { "type": "array", "description": "A list of offers.", "items": { "$ref": "#/components/schemas/OfferType" } }, "OfferType": { "required": [ "BuyingPrice", "FulfillmentChannel", "ItemCondition", "ItemSubCondition", "RegularPrice", "SellerSKU" ], "type": "object", "properties": { "offerType": { "$ref": "#/components/schemas/OfferCustomerType" }, "BuyingPrice": { "$ref": "#/components/schemas/PriceType" }, "RegularPrice": { "$ref": "#/components/schemas/MoneyType" }, "businessPrice": { "$ref": "#/components/schemas/MoneyType" }, "quantityDiscountPrices": { "type": "array", "description": "List of `QuantityDiscountPrice` that contains item's pricing information when buy in bulk.", "items": { "$ref": "#/components/schemas/QuantityDiscountPriceType" } }, "FulfillmentChannel": { "type": "string", "description": "The fulfillment channel for the offer listing. Possible values:\n\n* Amazon - Fulfilled by Amazon.\n* Merchant - Fulfilled by the seller." }, "ItemCondition": { "type": "string", "description": "The item condition for the offer listing. Possible values: New, Used, Collectible, Refurbished, or Club." }, "ItemSubCondition": { "type": "string", "description": "The item subcondition for the offer listing. Possible values: New, Mint, Very Good, Good, Acceptable, Poor, Club, OEM, Warranty, Refurbished Warranty, Refurbished, Open Box, or Other." }, "SellerSKU": { "type": "string", "description": "The seller stock keeping unit (SKU) of the item." } }, "description": "Schema for an individual offer." }, "OfferCustomerType": { "type": "string", "description": "Indicates whether the offer is a B2B or B2C offer", "enum": [ "B2C", "B2B" ], "x-docgen-enum-table-extension": [ { "value": "B2C", "description": "B2C" }, { "value": "B2B", "description": "B2B" } ] }, "QuantityDiscountPriceType": { "required": [ "listingPrice", "quantityDiscountType", "quantityTier" ], "type": "object", "properties": { "quantityTier": { "type": "integer", "description": "Indicates at what quantity this price becomes active.", "format": "int32" }, "quantityDiscountType": { "$ref": "#/components/schemas/QuantityDiscountType" }, "listingPrice": { "$ref": "#/components/schemas/MoneyType" } }, "description": "Contains pricing information that includes special pricing when buying in bulk." }, "QuantityDiscountType": { "type": "string", "description": "Indicates the type of quantity discount this price applies to.", "enum": [ "QUANTITY_DISCOUNT" ], "x-docgen-enum-table-extension": [ { "value": "QUANTITY_DISCOUNT", "description": "Quantity Discount" } ] }, "Points": { "type": "object", "properties": { "PointsNumber": { "type": "integer", "description": "The number of points.", "format": "int32" }, "PointsMonetaryValue": { "$ref": "#/components/schemas/MoneyType" } }, "description": "The number of Amazon Points offered with the purchase of an item, and their monetary value." }, "ConditionType": { "type": "string", "description": "Indicates the condition of the item. Possible values: New, Used, Collectible, Refurbished, Club.", "enum": [ "New", "Used", "Collectible", "Refurbished", "Club" ], "x-docgen-enum-table-extension": [ { "value": "New", "description": "New" }, { "value": "Used", "description": "Used" }, { "value": "Collectible", "description": "Collectible" }, { "value": "Refurbished", "description": "Refurbished" }, { "value": "Club", "description": "Club" } ] }, "ItemIdentifier": { "required": [ "ItemCondition", "MarketplaceId" ], "type": "object", "properties": { "MarketplaceId": { "type": "string", "description": "A marketplace identifier. Specifies the marketplace from which prices are returned." }, "ASIN": { "type": "string", "description": "The Amazon Standard Identification Number (ASIN) of the item." }, "SellerSKU": { "type": "string", "description": "The seller stock keeping unit (SKU) of the item." }, "ItemCondition": { "$ref": "#/components/schemas/ConditionType" } }, "description": "Information that identifies an item." }, "Summary": { "required": [ "TotalOfferCount" ], "type": "object", "properties": { "TotalOfferCount": { "type": "integer", "description": "The number of unique offers contained in NumberOfOffers.", "format": "int32" }, "NumberOfOffers": { "$ref": "#/components/schemas/NumberOfOffers" }, "LowestPrices": { "$ref": "#/components/schemas/LowestPrices" }, "BuyBoxPrices": { "$ref": "#/components/schemas/BuyBoxPrices" }, "ListPrice": { "$ref": "#/components/schemas/MoneyType" }, "CompetitivePriceThreshold": { "$ref": "#/components/schemas/MoneyType" }, "SuggestedLowerPricePlusShipping": { "$ref": "#/components/schemas/MoneyType" }, "SalesRankings": { "$ref": "#/components/schemas/SalesRankList" }, "BuyBoxEligibleOffers": { "$ref": "#/components/schemas/BuyBoxEligibleOffers" }, "OffersAvailableTime": { "type": "string", "description": "When the status is ActiveButTooSoonForProcessing, this is the time when the offers will be available for processing.", "format": "date-time" } }, "description": "Contains price information about the product, including the LowestPrices and BuyBoxPrices, the ListPrice, the SuggestedLowerPricePlusShipping, and NumberOfOffers and NumberOfBuyBoxEligibleOffers." }, "BuyBoxEligibleOffers": { "type": "array", "description": "A list that contains the total number of offers that are eligible for the Buy Box for the given conditions and fulfillment channels.", "items": { "$ref": "#/components/schemas/OfferCountType" } }, "BuyBoxPrices": { "type": "array", "description": "A list of the Buy Box prices.", "items": { "$ref": "#/components/schemas/BuyBoxPriceType" } }, "LowestPrices": { "type": "array", "description": "A list of the lowest prices.", "items": { "$ref": "#/components/schemas/LowestPriceType" } }, "NumberOfOffers": { "type": "array", "description": "A list that contains the total number of offers information for given conditions and fulfillment channels.", "items": { "$ref": "#/components/schemas/OfferCountType" } }, "OfferCountType": { "type": "object", "properties": { "condition": { "type": "string", "description": "Indicates the condition of the item. For example: New, Used, Collectible, Refurbished, or Club." }, "fulfillmentChannel": { "$ref": "#/components/schemas/FulfillmentChannelType" }, "OfferCount": { "type": "integer", "description": "The number of offers in a fulfillment channel that meet a specific condition.", "format": "int32" } }, "description": "The total number of offers for the specified condition and fulfillment channel." }, "FulfillmentChannelType": { "type": "string", "description": "Indicates whether the item is fulfilled by Amazon or by the seller (merchant).", "enum": [ "Amazon", "Merchant" ], "x-docgen-enum-table-extension": [ { "value": "Amazon", "description": "Fulfilled by Amazon." }, { "value": "Merchant", "description": "Fulfilled by the seller." } ] }, "LowestPriceType": { "required": [ "ListingPrice", "condition", "fulfillmentChannel" ], "type": "object", "properties": { "condition": { "type": "string", "description": "Indicates the condition of the item. For example: New, Used, Collectible, Refurbished, or Club." }, "fulfillmentChannel": { "type": "string", "description": "Indicates whether the item is fulfilled by Amazon or by the seller." }, "offerType": { "$ref": "#/components/schemas/OfferCustomerType" }, "quantityTier": { "type": "integer", "description": "Indicates at what quantity this price becomes active.", "format": "int32" }, "quantityDiscountType": { "$ref": "#/components/schemas/QuantityDiscountType" }, "LandedPrice": { "$ref": "#/components/schemas/MoneyType" }, "ListingPrice": { "$ref": "#/components/schemas/MoneyType" }, "Shipping": { "$ref": "#/components/schemas/MoneyType" }, "Points": { "$ref": "#/components/schemas/Points" } }, "description": "Schema for an individual lowest price." }, "BuyBoxPriceType": { "required": [ "LandedPrice", "ListingPrice", "Shipping", "condition" ], "type": "object", "properties": { "condition": { "type": "string", "description": "Indicates the condition of the item. For example: New, Used, Collectible, Refurbished, or Club." }, "offerType": { "$ref": "#/components/schemas/OfferCustomerType" }, "quantityTier": { "type": "integer", "description": "Indicates at what quantity this price becomes active.", "format": "int32" }, "quantityDiscountType": { "$ref": "#/components/schemas/QuantityDiscountType" }, "LandedPrice": { "$ref": "#/components/schemas/MoneyType" }, "ListingPrice": { "$ref": "#/components/schemas/MoneyType" }, "Shipping": { "$ref": "#/components/schemas/MoneyType" }, "Points": { "$ref": "#/components/schemas/Points" }, "sellerId": { "type": "string", "description": "The seller identifier for the offer." } }, "description": "Schema for an individual buybox price." }, "OfferDetailList": { "maxItems": 20, "type": "array", "description": "A list of offer details. The list is the same length as the TotalOfferCount in the Summary or 20, whichever is less.", "items": { "$ref": "#/components/schemas/OfferDetail" } }, "OfferDetail": { "required": [ "IsFulfilledByAmazon", "ListingPrice", "Shipping", "ShippingTime", "SubCondition" ], "type": "object", "properties": { "MyOffer": { "type": "boolean", "description": "When true, this is the seller's offer." }, "offerType": { "$ref": "#/components/schemas/OfferCustomerType" }, "SubCondition": { "type": "string", "description": "The subcondition of the item. Subcondition values: New, Mint, Very Good, Good, Acceptable, Poor, Club, OEM, Warranty, Refurbished Warranty, Refurbished, Open Box, or Other." }, "SellerId": { "type": "string", "description": "The seller identifier for the offer." }, "ConditionNotes": { "type": "string", "description": "Information about the condition of the item." }, "SellerFeedbackRating": { "$ref": "#/components/schemas/SellerFeedbackType" }, "ShippingTime": { "$ref": "#/components/schemas/DetailedShippingTimeType" }, "ListingPrice": { "$ref": "#/components/schemas/MoneyType" }, "quantityDiscountPrices": { "type": "array", "description": "List of `QuantityDiscountPrice` that contains item's pricing information when buy in bulk.", "items": { "$ref": "#/components/schemas/QuantityDiscountPriceType" } }, "Points": { "$ref": "#/components/schemas/Points" }, "Shipping": { "$ref": "#/components/schemas/MoneyType" }, "ShipsFrom": { "$ref": "#/components/schemas/ShipsFromType" }, "IsFulfilledByAmazon": { "type": "boolean", "description": "When true, the offer is fulfilled by Amazon." }, "PrimeInformation": { "$ref": "#/components/schemas/PrimeInformationType" }, "IsBuyBoxWinner": { "type": "boolean", "description": "When true, the offer is currently in the Buy Box. There can be up to two Buy Box winners at any time per ASIN, one that is eligible for Prime and one that is not eligible for Prime." }, "IsFeaturedMerchant": { "type": "boolean", "description": "When true, the seller of the item is eligible to win the Buy Box." } }, "description": "Schema for an individual offer. Object in `OfferDetailList`." }, "PrimeInformationType": { "required": [ "IsNationalPrime", "IsPrime" ], "type": "object", "properties": { "IsPrime": { "type": "boolean", "description": "Indicates whether the offer is an Amazon Prime offer." }, "IsNationalPrime": { "type": "boolean", "description": "Indicates whether the offer is an Amazon Prime offer throughout the entire marketplace where it is listed." } }, "description": "Amazon Prime information." }, "SellerFeedbackType": { "required": [ "FeedbackCount" ], "type": "object", "properties": { "SellerPositiveFeedbackRating": { "type": "number", "description": "The percentage of positive feedback for the seller in the past 365 days.", "format": "double" }, "FeedbackCount": { "type": "integer", "description": "The number of ratings received about the seller.", "format": "int64" } }, "description": "Information about the seller's feedback, including the percentage of positive feedback, and the total number of ratings received." }, "ErrorList": { "type": "array", "description": "A list of error responses returned when a request is unsuccessful.", "items": { "$ref": "#/components/schemas/Error" } }, "DetailedShippingTimeType": { "type": "object", "properties": { "minimumHours": { "type": "integer", "description": "The minimum time, in hours, that the item will likely be shipped after the order has been placed.", "format": "int64" }, "maximumHours": { "type": "integer", "description": "The maximum time, in hours, that the item will likely be shipped after the order has been placed.", "format": "int64" }, "availableDate": { "type": "string", "description": "The date when the item will be available for shipping. Only displayed for items that are not currently available for shipping." }, "availabilityType": { "type": "string", "description": "Indicates whether the item is available for shipping now, or on a known or an unknown date in the future. If known, the availableDate property indicates the date that the item will be available for shipping. Possible values: NOW, FUTURE_WITHOUT_DATE, FUTURE_WITH_DATE.", "enum": [ "NOW", "FUTURE_WITHOUT_DATE", "FUTURE_WITH_DATE" ], "x-docgen-enum-table-extension": [ { "value": "NOW", "description": "The item is available for shipping now." }, { "value": "FUTURE_WITHOUT_DATE", "description": "The item will be available for shipping on an unknown date in the future." }, { "value": "FUTURE_WITH_DATE", "description": "The item will be available for shipping on a known date in the future." } ] } }, "description": "The time range in which an item will likely be shipped once an order has been placed." }, "ShipsFromType": { "type": "object", "properties": { "State": { "type": "string", "description": "The state from where the item is shipped." }, "Country": { "type": "string", "description": "The country from where the item is shipped." } }, "description": "The state and country from where the item is shipped." }, "MarketplaceId": { "type": "string", "description": "A marketplace identifier. Specifies the marketplace for which prices are returned." }, "ItemCondition": { "type": "string", "description": "Filters the offer listings to be considered based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.", "enum": [ "New", "Used", "Collectible", "Refurbished", "Club" ], "x-docgen-enum-table-extension": [ { "value": "New", "description": "New" }, { "value": "Used", "description": "Used" }, { "value": "Collectible", "description": "Collectible" }, { "value": "Refurbished", "description": "Refurbished" }, { "value": "Club", "description": "Club" } ] }, "Asin": { "type": "string", "description": "The Amazon Standard Identification Number (ASIN) of the item." }, "CustomerType": { "type": "string", "description": "Indicates whether to request Consumer or Business offers. Default is Consumer.", "enum": [ "Consumer", "Business" ], "x-docgen-enum-table-extension": [ { "value": "Consumer", "description": "Consumer" }, { "value": "Business", "description": "Business" } ] }, "Error": { "required": [ "code", "message" ], "type": "object", "properties": { "code": { "type": "string", "description": "An error code that identifies the type of error that occurred." }, "message": { "type": "string", "description": "A message that describes the error condition." }, "details": { "type": "string", "description": "Additional details that can help the caller understand or fix the issue." } }, "description": "Error response returned when the request is unsuccessful." } } }, "x-original-swagger-version": "2.0" }