Menu
Product Advertising API
Developer Guide (API Version 2013-08-01)

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.

Copy
<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.

Message Description
Usually ships in %X A dynamic response where %X represents a variable amount of time.
Not yet released The 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 published The 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 Stock The item is currently not available for purchase, but may be in the future.
Limited Availability Used for items sold by third-parties if an item is out of stock, but may be available for purchase later.
Out of Print--Limited Availability Customers can choose to be notified if a copy becomes available.
Special Order Titles 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 merchant The 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.