Product Advertising API
Developer Guide (API Version 2011-08-01)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

Availability Values

The Offer Summary Report lists the availability of an item using the Availability element. The value of the element indicates if the item can be purchased and how soon it will be shipped, as shown.

  <Availability>Usually ships in 24 hours</Availability>

This response, which is returned by the Offers and OfferFull response groups, confirms that an item is available to buy.

The value returned by the Availability element may not match the one on the Amazon retail web site's product detail page because typically there is a short and long version of an availability message:. Product Advertising API returns the short version. The more verbose availability message is used on the retail web site.

For non-Amazon products in JP, FR, DE, and CA; the value returned by the Availability element is “1-2 business days,” or the localized equivalent, regardless of the actual availability.

The following table describes the possible Availability element values.

MessageDescription
Usually ships in %XA dynamic response where %X represents a variable amount of time.
Not yet releasedThe item is not available for purchase. The item may or may not have a projected release date. If there is a release date, it may show up in the ReleaseDate element of the item attributes.
Not yet publishedThe item is not available for purchase. The item may or may not have a projected release date. If there is a release date, it may show up in the ReleaseDate element of the item attributes.
This item is not stocked or has been discontinued.The item is not available for purchase.
Out of StockThe item is currently not available for purchase, but may be in the future.
Limited AvailabilityUsed for items sold by third-parties if an item is out of stock, but may be available for purchase later.
Out of Print--Limited AvailabilityCustomers can choose to be notified if a copy becomes available.
Special OrderTitles occasionally go out of print or publishers run out of stock. The buyer is notified if the item becomes unavailable."
This item is currently not available by this merchantThe message is sent primarily for Amazon offers that are missing an availability message.

These availability messages apply to Amazon only. Sellers might return a completely different set of availability messages.