SellingStatus

Selling details pertaining to the respective item.

Type that uses SellingStatus:

Calls that use SellingStatus:

findCompletedItems, findItemsAdvanced, findItemsByCategory, findItemsByKeywords, findItemsByProduct, findItemsIneBayStores

Fields

bidCount ( int )

convertedCurrentPrice ( Amount (double) )

currentPrice ( Amount (double) )

sellingState ( token )

timeLeft ( duration )

bidCount ( int ) [0..1]

The number of bids that have been placed on the item.

See the Field Index to learn which calls use bidCount.

convertedCurrentPrice ( Amount (double) ) [0..1]

The listing's current price converted to the currency of the site specified in the find request (globalId).

See the Field Index to learn which calls use convertedCurrentPrice.

currentPrice ( Amount (double) ) [0..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), Ad Format (AdFormat), and Classified Ad (Classified) listings, currentPrice is the current fixed price.

See the Field Index to learn which calls use currentPrice.

sellingState ( token ) [0..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).
EndedWithSales: The listing has been ended with sales.
EndedWithoutSales: The listing has been ended without sales.

See the Field Index to learn which calls use sellingState.

timeLeft ( duration ) [0..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.