eBay Trading APIVersion 1379
 

BestOfferType

Type defining the BestOffer container, which consists of information on one Best Offer or counter offer. This information includes the price of the offer, the expiration of the offer, and any messaging provided by the prospective buyer or seller.

Types that use BestOfferType:

Calls that use BestOfferType:

Fields



BestOfferCodeType ( BestOfferTypeCodeType ) [0..1]
This value indicates whether the corresponding offer is a Best Offer, a seller's counter offer, or a buyer counter offer to the seller's counter offer.
See the Field Index to learn which calls use BestOfferCodeType.

BestOfferID ( BestOfferIDType (string) ) [0..1]
Unique identifier for a Best Offer. This identifier is created once a prospective buyer makes a Best Offer on an item.
See the Field Index to learn which calls use BestOfferID.

Buyer ( UserType ) [0..1]
Container consisting of information about the prospective buyer who made the Best Offer.
See the Field Index to learn which calls use Buyer.

BuyerMessage ( string ) [0..1]
A prospective buyer has the option to include a comment when placing a Best Offer or making a counter offer to the seller's counter offer. This field will display that comment.
See the Field Index to learn which calls use BuyerMessage.

CallStatus ( string ) [0..1]
The value in this field (Success or Failure) will indicate whether or not the seller's attempt to accept, decline, or counter offer a Best Offer was successful. This field is only used by the RespondToBestOffer response.
See the Field Index to learn which calls use CallStatus.

ExpirationTime ( dateTime ) [0..1]
Timestamp indicating when a Best Offer will naturally expire (if the seller has not accepted or declined the offer).
See the Field Index to learn which calls use ExpirationTime.

ImmediatePayEligible ( boolean ) [0..1]
Not used by any call.

This field is no longer applicable, as it formerly supported the Best Offer Beta feature which is no longer active.
See the Field Index to learn which calls use ImmediatePayEligible.

NewBestOffer ( boolean ) [0..1]
Not used by any call.

This field is no longer applicable, as it formerly supported the Best Offer Beta feature which is no longer active.
See the Field Index to learn which calls use NewBestOffer.

Price ( AmountType (double) ) [0..1]
The amount of the Best Offer or counter offer. For this field to be returned, the user must have a relationship to the Best Offer, either as the seller, buyer, or potential buyer who has made the Best Offer or counter offer.
See the Field Index to learn which calls use Price.

Quantity ( int ) [0..1]
The quantity of the item for which the buyer is making a Best Offer. This value will usually be 1, unless the buyer is making an offer on multiple quantity of a line item in a multi-quantity listing.
See the Field Index to learn which calls use Quantity.

SellerMessage ( string ) [0..1]
A seller has the option to include a comment when making a counter offer to the prospective buyer's Best Offer. This field will display that comment.
See the Field Index to learn which calls use SellerMessage.

The status of the Best Offer or counter offer. For PlaceOffer, the only applicable values are Accepted, AdminEnded, Declined, and Expired.
See the Field Index to learn which calls use Status.