Parameter Restrictions for Availability

previous page next page

The following table describes the ItemSearch parameters that must be included to return available items (only).

ItemSearch Parameter	Description
Availability	Must be set to “Available.” When the Availability parameter is not set, `ItemSearch` returns available and unavailable items. “Available” is the only valid value for `Availability`. Setting it to another value returns an error message. Parameter values are case sensitive. When the Availability parameter is set to "Available," the Condition parameter cannot be set to "New."
Condition	Must be set to “All”. The default value is "New." When the Availability parameter is set to "Available," the Condition parameter cannot be set to "New."
MerchantId	Alphanumeric token that uniquely identifies a merchant. Valid values are “Amazon,” “All,” or a specific merchant ID. When the `Availability` parameter is used and `MerchantId` is set to "Amazon," the availability results for Amazon, Toys R Us, and Target are merged.

The following search indices do not work with the Availability parameter:

In both cases, because Amazon does not warehouse the items for sale, Amazon cannot determine the availability of them.

previous page start next page