Skip to main content
Published: July 31 2006, 4:39:00 PMUpdated: November 28 2020, 2:18:27 PM

What does the CallMode parameter in GetAllBidders do? How should I use this flag with the GetAllBiddersRequest ?

The GetAllBidders API call can be used to retrieve bidding related information for an eBay Auction. The CallMode defines certain basic behaviors of the call, and filters the returned Bid List. Below is a description of each Call Mode, and the common use cases for when each mode is relevant.

The GetAllBidders call below will behave differently, depending on the <CallMode> input parameter.

<?xml version="1.0" encoding="utf-8"?>
<GetAllBiddersRequest xmlns="urn:ebay:apis:eBLBaseComponents">
<Version>467</Version>
<ItemID>330009554934</ItemID>
<CallMode>ViewAll</CallMode>
<RequesterCredentials>
<eBayAuthToken>x</eBayAuthToken>
</RequesterCredentials>
</GetAllBiddersRequest>

CallMode = ViewAll
--------------------------
The ViewAll call mode will return all bids for active and ended items. In this mode, the <HighBidder> will represent the winner of the Auction. This call mode can be used by any user ( not restricted to the seller). This call mode returns a single <Offer> node for each user that participated in bidding for the item, with the Offer.HighestBid amount representing the highest bid made by that particular eBay User. Use this mode when investigating general bidding history or activity on an item. Personal information, such as email address, is not returned when the caller is not the seller.

CallMode = SecondChanceEligibleEndedListing
--------------------------------------------------------
The SecondChanceEligibleEndedListing returns all Non-Winning Bidders that are eligible for a Second Chance Offer. The call must be made by the Item's Seller, and the <HighBidder> node will represent the highest non-winning bidder eligible for a SecondChanceOffer. For example, if no Second Chance offers have been made, the <HighBidder> will be the second to highest bidder. If the second to highest bidder has already recieved a Second Chance Offer, then the <HighBidder> will be the 3rd highest bidder.

CallMode = EndedListing
-------------------------------
The EndedListing mode returns all Non-Winning Bidders for ended Items only.

How well did this answer your question?
Answers others found helpful