ListingStatusCodeType ( token )
Specifies an active or ended listing's status in eBay's processing workflow. If a listing ends with a sale (or sales), eBay needs to update the sale details (e.g., total price and buyer/high bidder) and the final value fee. This processing can take several minutes. If you retrieve a sold item and no details about the buyer/high bidder are returned or no final value fee is available, use this listing status information to determine whether eBay has finished processing the listing.

Types that use ListingStatusCodeType:

Enumeration Values
Value Description Which calls use this value *
Active The listing is still active or the listing has ended with a sale but eBay has not completed processing the sale details (e.g., total price and high bidder). A multi-item listing is considered active until all items have winning bids or purchases or the listing ends with at least one winning bid or purchase. If the listing has ended with a sale but this Active status is returned, please allow several minutes for eBay to finish processing the listing. GetAllBidders, GetBidderList, GetHighBidders, GetItem, GetItemTransactions, GetMyMessages, GetOrderTransactions, GetSellerEvents, GetSellerList, GetSellerTransactions, GetSellingManagerTemplates
Completed The listing has closed and eBay has completed processing the sale. All sale information returned from eBay (e.g., total price and high bidder) should be considered accurate and complete. Although the Final Value Fee (FVF) for FixedPriceItem and StoresFixedPrice items is returned by GetSellerTransactions and GetItemTransactions, all other listing types (excluding Buy It Now purchases) require the listing status to be Completed before the Final Value Fee is returned.

Dutch (multi-listing) Buy It Now auctions are Completed on a transaction-by-transaction basis, and the Final Value Fee is returned by GetSellerTransactions and GetItemTransactions.

Note: As of version 619, Dutch-style (multi-item) competitive-bid auctions are deprecated. eBay throws an error if you submit a Dutch item listing with AddItem or VerifyAddItem. If you use RelistItem to update a Dutch auction listing, eBay generates a warning and resets the Quantity value to 1.
GetAllBidders, GetBidderList, GetHighBidders, GetItem, GetItemTransactions, GetMyMessages, GetOrderTransactions, GetSellerEvents, GetSellerList, GetSellerTransactions, GetSellingManagerTemplates
Custom Reserved for internal or future use. GetAllBidders, GetBidderList, GetHighBidders, GetItem, GetItemTransactions, GetMyMessages, GetOrderTransactions, GetSellerEvents, GetSellerList, GetSellerTransactions, GetSellingManagerTemplates
CustomCode Reserved for internal or future use. GetAllBidders, GetBidderList, GetHighBidders, GetItem, GetItemTransactions, GetMyMessages, GetOrderTransactions, GetSellerEvents, GetSellerList, GetSellerTransactions, GetSellingManagerTemplates
Ended The listing has ended. If the listing ended with a sale, eBay has completed processing of the sale. All sale information returned from eBay (e.g., total price and high bidder) should be considered accurate and complete. However, the final value fee is not yet available. GetAllBidders, GetBidderList, GetHighBidders, GetItem, GetItemTransactions, GetMyMessages, GetOrderTransactions, GetSellerEvents, GetSellerList, GetSellerTransactions, GetSellingManagerTemplates
  * See the Enumeration Index to see exact use of each enumeration value in the API.

This document was generated with a customized version of the apireferencedocs tool.

© 2005–2010 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.