The value indicates the quantity of items available for purchase in the listing. This field is required for all auction listings and for non-variation, fixed-price listings. For auction listings, this value is always '1'. For a non-variation, fixed-price listing, the Item.Quantity
value indicates the number of identical items the seller has available for purchase in the listing.
You can set the Quantity
to 0 (zero) and keep the listing active if you set SetUserPreferences.OutOfStockControlPreference
to 'true'. For AddFixedPriceItem, VerifyAddFixedPriceItem, RelistFixedPriceItem, and ReviseFixedPriceItem:
in a multi-variation, fixed-price listing, the Item.Quantity
should not be used; instead, the quantity of each variation is specified in the Variation.Variation.Quantity
field instead. See the Creating a listing with variations
eBay Help page for more information on variations. For RelistItem, RelistFixedPriceItem, and VerifyRelistItem:
Previously in RelistItem
, and VerifyRelistItem
field retained its value from the previous listing unless you specifically changed it by including the field in a relist call and giving it a new value. And this value was often not accurate with the quantity that was really still available for purchase and it was often out of synch with the QuantityAvailable
value that is returned with the GetMyeBaySelling
call. As of March 13, 2014, this behavior has been changed in the following manner:
- For a listing that has ended with an available quantity greater than zero, the Quantity value of the newly relisted item is set to the actual QuantityAvailable value (see the GetMyeBaySelling call) when the previous listing ended.
- For listings that ended with an available quantity of zero, the relisted item will retain the Quantity value that was passed in at creation time of the previous listing.
So, if you are relisting an item that had an available quantity of zero when the listing ended, we strongly recommend that you pass in the correct available quantity through the Quantity
field of a relist call. Alternatively, you can update the correct quantity available by using a ReviseInventoryStatus
call and passing in a Quantity
When eBay auto-renews a GTC listing (ListingDuration=GTC) on your behalf, eBay relists with correct quantity available. Note: There are seller limits on the US site for users who registered after October 2010. Seller limits control the quantity of items and/or the total value of the item(s) in the listing. (The GetMyeBaySelling call returns the remaining item quantity and remaining total value under the limits for the seller, if any such limits exist for the seller). If a call to add an item or revise an item would result in the exceeding of these limits, the add item or revise item call will fail. For auction listings, the total value limit applies to the start price, not the final sale amount. For more information, see the link to Seller Limits below. For GetSellerEvents:
Quantity is only returned for listings where item quantity is greater than 1. For GetItem and related calls:
This is the total of the number of items available for sale plus the quantity already sold. To determine the number of items available, subtract SellingStatus.QuantitySold from this value. Even for items that supported Dutch auctions, where one of several items can be purchased during the auction, this number does not change. For order line item calls with variations:
In GetItemTransactions, Item.Quantity is the same as GetItem (the total quantity across all variations). In GetSellerTransactions, Transaction.Item.Quantity is the total quantity of the applicable variation (quantity available plus quantity sold). For GetDispute:
Quantity is the number of items being raised in the dispute. For SetCart:
This input is required only when the parent container is submitted.
Also applicable to Half.com (valid range 1 to 1000). You can revise this field for Half.com listings. Note: The number in the Quantity field represents the current quantity of items that are available using the "Ship to home" fulfillment method. This number does not take into account any quantity of the item that is available through "local" fulfillment methods such as In-Store Pickup, eBay Now, or Click and Collect. This is due to the fact that there is no current implementation (or API field) where the seller informs eBay about the quantity of items available through each local fulfillment method. In the case where a listing is only offering the item through a local fulfillment method, this value should default to '0', and the Item.IgnoreQuantity will also be returned as 'True'.