HomeDocumentationCode SamplesAPI ReferenceAnnouncementsModelsRelease NotesFAQGitHubVideos
Developer HubAPI StatusSupport
API Reference
Developer HubAPI StatusSupport

getItemOffers

Returns the lowest priced offers for a single item based on ASIN.

Usage Plan:

Rate (requests per second)Burst
0.51

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.

Path Params
string
required

The Amazon Standard Identification Number (ASIN) of the item.

Query Params
string
required

A marketplace identifier. Specifies the marketplace for which prices are returned.

string
required

Filters the offer listings to be considered based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.

string

Indicates whether to request Consumer or Business offers. Default is Consumer.

Responses

Response body
object
payload
object

The payload for the getListingOffers and getItemOffers operations.

string
required

A marketplace identifier.

string

The Amazon Standard Identification Number (ASIN) of the item.

string

The stock keeping unit (SKU) of the item.

string
required

Indicates the condition of the item. Possible values: New, Used, Collectible, Refurbished, Club.

New Used Collectible Refurbished Club

Show Details
NewNew
UsedUsed
CollectibleCollectible
RefurbishedRefurbished
ClubClub
string
required

The status of the operation.

Identifier
object
required

Information that identifies an item.

Summary
object
required

Contains price information about the product, including the LowestPrices and BuyBoxPrices, the ListPrice, the SuggestedLowerPricePlusShipping, and NumberOfOffers and NumberOfBuyBoxEligibleOffers.

Offers
array of objects
required
length ≤ 20

A list of offer details. The list is the same length as the TotalOfferCount in the Summary or 20, whichever is less.

Offers*
object
boolean

When true, this is the seller's offer.

string

Indicates whether the offer is a B2B or B2C offer

B2C B2B

Show Details
B2CB2C
B2BB2B
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.

string

The seller identifier for the offer.

string

Information about the condition of the item.

SellerFeedbackRating
object

Information about the seller's feedback, including the percentage of positive feedback, and the total number of ratings received.

ShippingTime
object
required

The time range in which an item will likely be shipped once an order has been placed.

ListingPrice
object
required

Currency type and monetary value. Schema for demonstrating pricing info.

quantityDiscountPrices
array of objects

List of QuantityDiscountPrice that contains item's pricing information when buy in bulk.

quantityDiscountPrices
object
int32
required

Indicates at what quantity this price becomes active.

string
required

Indicates the type of quantity discount this price applies to.

QUANTITY_DISCOUNT

Show Details
QUANTITY_DISCOUNTQuantity Discount
listingPrice
object
required

Currency type and monetary value. Schema for demonstrating pricing info.

Points
object

The number of Amazon Points offered with the purchase of an item, and their monetary value.

Shipping
object
required

Currency type and monetary value. Schema for demonstrating pricing info.

ShipsFrom
object

The state and country from where the item is shipped.

boolean
required

When true, the offer is fulfilled by Amazon.

PrimeInformation
object

Amazon Prime information.

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.

boolean

When true, the seller of the item is eligible to win the Buy Box.

errors
array of objects

A list of error responses returned when a request is unsuccessful.

errors
object
string
required

An error code that identifies the type of error that occurred.

string
required

A message that describes the error condition.

string

Additional details that can help the caller understand or fix the issue.

Headers
object
string

Your rate limit (requests per second) for this operation.

string

Unique request reference identifier.

Language