--- title: "getItemOffersBatch" method: POST path: "/batches/products/pricing/v0/itemOffers" tags: ["Product Pricing v0"] --- # getItemOffersBatch `POST /batches/products/pricing/v0/itemOffers` Returns the lowest priced offers for a batch of items based on ASIN. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 0.1 | 1 | The `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). ## Request body - GetItemOffersBatchRequest — The request associated with the `getItemOffersBatch` API call. - `requests` ItemOffersRequest[] — A list of `getListingOffers` batched requests to run. - `uri` string, required — The URI associated with an individual request within a batch. For `FeaturedOfferExpectedPrice`, this is `/products/pricing/2022-05-01/offer/featuredOfferExpectedPrice`. - `method` 'GET' | 'PUT' | 'PATCH' | 'DELETE' | 'POST', required — The HTTP method associated with an individual request within a batch. - `body` unknown - `headers` HttpHeaders — A mapping of additional HTTP headers to send or receive for an individual request within a batch. - `MarketplaceId` string, required — The identifier of the Amazon marketplace. For the list of all marketplace IDs, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids). - `ItemCondition` 'New' | 'Used' | 'Collectible' | 'Refurbished' | 'Club', required — Filters the offer listings to be considered based on item condition. Possible values: New, Used, Collectible, Refurbished, Club. - `CustomerType` 'Consumer' | 'Business' — Indicates whether to request Consumer or Business offers. Default is Consumer. ## Response `200` Indicates that requests were run in batch. Check the batch response status lines for information on whether a batch request succeeded. - GetItemOffersBatchResponse — The response associated with the `getItemOffersBatch` API call. - `responses` ItemOffersResponse[] — A list of `getItemOffers` batched responses. - `headers` HttpResponseHeaders — A mapping of additional HTTP headers to send/receive for the individual batch request. - `Date` string — 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` string — Unique request reference identifier. - `status` GetOffersHttpStatusLine — The HTTP status line associated with the response. For more information, consult [RFC 2616](https://www.w3.org/Protocols/rfc2616/rfc2616-sec6.html). - `statusCode` integer — The HTTP response Status Code. - `reasonPhrase` string — The HTTP response Reason-Phase. - `body` GetOffersResponse, required — The response schema for the `getListingOffers` and `getItemOffers` operations. - `payload` GetOffersResult — The payload for the getListingOffers and getItemOffers operations. - `marketplaceId` string, required — A marketplace identifier. - `ASIN` string — The Amazon Standard Identification Number (ASIN) of the item. - `SKU` string — The stock keeping unit (SKU) of the item. - `ItemCondition` 'New' | 'Used' | 'Collectible' | 'Refurbished' | 'Club', required — Indicates the condition of the item. Possible values: New, Used, Collectible, Refurbished, Club. - `status` string, required — The status of the operation. - `Identifier` ItemIdentifier, required — Information that identifies an item. - `MarketplaceId` string, required — A marketplace identifier. Specifies the marketplace from which prices are returned. - `ASIN` string — The Amazon Standard Identification Number (ASIN) of the item. - `SellerSKU` string — The seller stock keeping unit (SKU) of the item. - `ItemCondition` 'New' | 'Used' | 'Collectible' | 'Refurbished' | 'Club', required — Indicates the condition of the item. Possible values: New, Used, Collectible, Refurbished, Club. - `Summary` Summary, required — Contains price information about the product, including the LowestPrices and BuyBoxPrices, the ListPrice, the SuggestedLowerPricePlusShipping, and NumberOfOffers and NumberOfBuyBoxEligibleOffers. - `TotalOfferCount` integer, required — The number of unique offers contained in NumberOfOffers. - `NumberOfOffers` OfferCountType[] — A list that contains the total number of offers information for given conditions and fulfillment channels. - `condition` string — Indicates the condition of the item. For example: New, Used, Collectible, Refurbished, or Club. - `fulfillmentChannel` 'AMAZON' | 'MERCHANT' — The fulfillment channel type of an offer. Note that this is only valid for sellers and not for vendors. - `OfferCount` integer — The number of offers in a fulfillment channel that meet a specific condition. - `LowestPrices` LowestPriceType[] — A list of the lowest prices. - `condition` string, required — Indicates the condition of the item. For example: New, Used, Collectible, Refurbished, or Club. - `fulfillmentChannel` string, required — Indicates whether the item is fulfilled by Amazon or by the seller. - `offerType` 'B2C' | 'B2B' — Indicates whether the offer is a B2B or B2C offer - `quantityTier` integer — Indicates at what quantity this price becomes active. - `quantityDiscountType` 'QUANTITY_DISCOUNT' — Indicates the type of quantity discount this price applies to. - `LandedPrice` MoneyType — Currency type and monetary value schema to demonstrate pricing information. - … - `ListingPrice` MoneyType, required — Currency type and monetary value schema to demonstrate pricing information. - … - `Shipping` MoneyType — Currency type and monetary value schema to demonstrate pricing information. - … - `Points` Points — The number of Amazon Points that are offered with the purchase of an item and the monetary value of these points. - … - `BuyBoxPrices` BuyBoxPriceType[] — A list of the Buy Box prices. - `condition` string, required — Indicates the condition of the item. For example: New, Used, Collectible, Refurbished, or Club. - `offerType` 'B2C' | 'B2B' — Indicates whether the offer is a B2B or B2C offer - `quantityTier` integer — Indicates at what quantity this price becomes active. - `quantityDiscountType` 'QUANTITY_DISCOUNT' — Indicates the type of quantity discount this price applies to. - `LandedPrice` MoneyType, required — Currency type and monetary value schema to demonstrate pricing information. - … - `ListingPrice` MoneyType, required — Currency type and monetary value schema to demonstrate pricing information. - … - `Shipping` MoneyType, required — Currency type and monetary value schema to demonstrate pricing information. - … - `Points` Points — The number of Amazon Points that are offered with the purchase of an item and the monetary value of these points. - … - `sellerId` string — The seller identifier for the offer. - `ListPrice` MoneyType — Currency type and monetary value schema to demonstrate pricing information. - `currencyCode` string — The currency code in ISO 4217 format. - `amount` number — The monetary value. - `CompetitivePriceThreshold` MoneyType — Currency type and monetary value schema to demonstrate pricing information. - `currencyCode` string — The currency code in ISO 4217 format. - `amount` number — The monetary value. - `SuggestedLowerPricePlusShipping` MoneyType — Currency type and monetary value schema to demonstrate pricing information. - `currencyCode` string — The currency code in ISO 4217 format. - `amount` number — The monetary value. - `SalesRankings` SalesRankType[] — A list of sales rank information for the item, by category. - `ProductCategoryId` string, required — Identifies the item category from which the sales rank is taken. - `Rank` integer, required — The sales rank of the item within the item category. - `BuyBoxEligibleOffers` OfferCountType[] — A list that contains the total number of offers that are eligible for the Buy Box for the given conditions and fulfillment channels. - `condition` string — Indicates the condition of the item. For example: New, Used, Collectible, Refurbished, or Club. - `fulfillmentChannel` 'AMAZON' | 'MERCHANT' — The fulfillment channel type of an offer. Note that this is only valid for sellers and not for vendors. - `OfferCount` integer — The number of offers in a fulfillment channel that meet a specific condition. - `OffersAvailableTime` string, date-time — When the status is ActiveButTooSoonForProcessing, this is the time when the offers will be available for processing. - `Offers` OfferDetail[], required — A list of offer details. The list is the same length as the TotalOfferCount in the Summary or 20, whichever is less. - `MyOffer` boolean — When true, this is the seller's offer. - `offerType` 'B2C' | 'B2B' — Indicates whether the offer is a B2B or B2C offer - `SubCondition` string, required — 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` string — The seller identifier for the offer. - `ConditionNotes` string — Information about the condition of the item. - `SellerFeedbackRating` SellerFeedbackType — Information about the seller's feedback, including the percentage of positive feedback, and the total number of ratings received. - `SellerPositiveFeedbackRating` number, double — The percentage of positive feedback for the seller in the past 365 days. - `FeedbackCount` integer, required — The number of ratings received about the seller. - `ShippingTime` DetailedShippingTimeType, required — The time range in which an item will likely be shipped once an order has been placed. - `minimumHours` integer — The minimum time, in hours, that the item will likely be shipped after the order has been placed. - `maximumHours` integer — The maximum time, in hours, that the item will likely be shipped after the order has been placed. - `availableDate` string — The date when the item will be available for shipping. Only displayed for items that are not currently available for shipping. - `availabilityType` 'NOW' | 'FUTURE_WITHOUT_DATE' | 'FUTURE_WITH_DATE' — 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. - `ListingPrice` MoneyType, required — Currency type and monetary value schema to demonstrate pricing information. - `currencyCode` string — The currency code in ISO 4217 format. - `amount` number — The monetary value. - `quantityDiscountPrices` QuantityDiscountPriceType[] — List of `QuantityDiscountPrice` that contains item's pricing information when buy in bulk. - `quantityTier` integer, required — Indicates at what quantity this price becomes active. - `quantityDiscountType` 'QUANTITY_DISCOUNT', required — Indicates the type of quantity discount this price applies to. - `listingPrice` MoneyType, required — Currency type and monetary value schema to demonstrate pricing information. - … - `Points` Points — The number of Amazon Points that are offered with the purchase of an item and the monetary value of these points. - `pointsNumber` integer — The number of Amazon Points. - `pointsMonetaryValue` MoneyType — Currency type and monetary value schema to demonstrate pricing information. - … - `Shipping` MoneyType, required — Currency type and monetary value schema to demonstrate pricing information. - `currencyCode` string — The currency code in ISO 4217 format. - `amount` number — The monetary value. - `ShipsFrom` ShipsFromType — The state and country from where the item is shipped. - `State` string — The state from where the item is shipped. - `Country` string — The country from where the item is shipped. - `IsFulfilledByAmazon` boolean, required — When true, the offer is fulfilled by Amazon. - `PrimeInformation` PrimeInformationType — Amazon Prime information. - `IsPrime` boolean, required — Indicates whether the offer is an Amazon Prime offer. - `IsNationalPrime` boolean, required — Indicates whether the offer is an Amazon Prime offer throughout the entire marketplace where it is listed. - `IsBuyBoxWinner` boolean — 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` boolean — When true, the seller of the item is eligible to win the Buy Box. - `errors` Error[] — A list of error responses returned when a request is unsuccessful. - `code` string, required — An error code that identifies the type of error that occurred. - `message` string, required — A message that describes the error condition. - `details` string — Additional details that can help the caller understand or fix the issue. - `request` ItemOffersRequestParams, required — List of request parameters that can be accepted by `ItemOffersRequest` - `MarketplaceId` string, required — The identifier of the Amazon marketplace. For the list of all marketplace IDs, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids). - `ItemCondition` 'New' | 'Used' | 'Collectible' | 'Refurbished' | 'Club', required — Filters the offer listings to be considered based on item condition. Possible values: New, Used, Collectible, Refurbished, Club. - `CustomerType` 'Consumer' | 'Business' — Indicates whether to request Consumer or Business offers. Default is Consumer. - `Asin` string — The Amazon Standard Identification Number (ASIN) of the item. This is the same Asin passed as a request parameter. ## Other responses - `400` — Request has missing or invalid parameters and cannot be parsed. - `401` — The request's Authorization header is not formatted correctly or does not contain a valid token. - `403` — Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature. - `404` — The specified resource does not exist. - `429` — The frequency of requests was greater than allowed. - `500` — An unexpected condition occurred that prevented the server from fulfilling the request. - `503` — Temporary overloading or maintenance of the server. --- [API](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01.md) · [All operations](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/a-content-management-v2020-11-01/revisions/815a5b6dbaa6/schema)