SellingStatus

Information about the current status of the item.

Types that use SellingStatus:

Calls that use one or more fields of SellingStatus:

Fields

bidCount ( int ) [0..1]
The number of bids that have been placed on the item. Returned only if the selling format is an auction.
See the Field Index to learn which calls use bidCount.

convertedCurrentPrice ( Amount (double) ) [1]
The listing's current price converted to the currency of the site from which the request is sent (the request's globalId value).
See the Field Index to learn which calls use convertedCurrentPrice.

currentPrice ( Amount (double) ) [1]
The current price of the item given in the currency of the site on which the item is listed. That is, currentPrice is returned in the original listing currency.

For competitive-bid item listings, currentPrice is the current minimum bid price if the listing has no bids, or the current high bid if the listing has bids. A Buy It Now price has no effect on currentPrice.

For Basic Fixed-Price (FixedPrice), Store Inventory (StoreInventory), and Ad Format (AdFormat) listings, currentPrice is the current fixed price.
See the Field Index to learn which calls use currentPrice.

sellingState ( token ) [1]
Specifies the listing's status in eBay's processing workflow. If an item's EndTime is in the past, but there are no details about the buyer or high bidder (and the user is not anonymous), you can use sellingState information to determine whether eBay has finished processing the listing.
sellingState values:
Active
The listing is still live. It is also possible that the auction has recently ended, but eBay has not completed the final processing (e.g., the high bidder is still being determined).
Canceled
The listing has been canceled by either the seller or eBay.
Ended
The listing has ended and eBay has completed the processing of the sale (if any).
See the Field Index to learn which calls use sellingState.

timeLeft ( duration ) [1]
Time left before the listing ends. The duration is represented in the ISO 8601 duration format (PnYnMnDTnHnMnS). For listings that have ended, the time left is PT0S (zero seconds). See the "duration" type for information about this time format.
See the Field Index to learn which calls use timeLeft.

Copyright © 2009–2012 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developer Network and API License Agreement.