Skip to main content

eBay sends a BestOffer notification when a bidder makes an offer on a listing that is enabled for the Best Offer feature. The notification is not sent to the buyer or seller, but only to a third party such as an eBay development partner. The flow of events is this:

  • A third party subscribes to the BestOffer notification on behalf of a seller who has opted a listing into the Best Offer feature.
  • eBay sends a notification to the third party each time a bidder makes an offer on that listing.

Data Fields Returned

API Call that displays this notification: GetBestOffers

The data fields returned by the BestOffer notification are the same as those returned by GetBestOffersResponse. Refer to the GetBestOffers call reference documentation for additional information.

Refer to SOAP Message Body for information about the standard elements returned for all notifications.

Example

Sample BestOffer Notification 

<?xml version="1.0" encoding="utf-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="https://www.w3.org/2001/XMLSchema"
    xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
  <soapenv:Header>
    <ebl:RequesterCredentials soapenv:mustUnderstand="0"
        xmlns:ns="urn:ebay:apis:eBLBaseComponents"
        xmlns:ebl="urn:ebay:apis:eBLBaseComponents">
      <ebl:NotificationSignature>abc123==</ebl:NotificationSignature>
    </ebl:RequesterCredentials>
  </soapenv:Header>
  <soapenv:Body>
    <GetBestOffersResponse xmlns="urn:ebay:apis:eBLBaseComponents">
      <Timestamp>2005-01-20T01:46:15.839Z</Timestamp>
      <Ack>Success</Ack>
      <CorrelationID>6********0</CorrelationID>
      <Version>361</Version>
      <Build>20050119095443</Build>
      <NotificationEventName>BestOffer</NotificationEventName>
      <BestOfferArray>
        <BestOffer>
          <BestOfferID>4********1</BestOfferID>
          <ExpirationTime>2005-01-21T02:46:23.000Z</ExpirationTime>
          <Buyer>
            <Email>s********r@a********3.com</Email>
            <FeedbackScore>115</FeedbackScore>
            <RegistrationDate>1999-01-19T08:00:00.000Z</RegistrationDate>
            <UserID>s********r</UserID>
          </Buyer>
          <Currency>USD</Currency>
          <Price>0.5</Price>
          <Status>Pending</Status>
          <Quantity>1</Quantity>
        </BestOffer>
      </BestOfferArray>
      <Item>
        <BuyItNowPrice>1.0</BuyItNowPrice>
        <Currency>USD</Currency>
        <ListingDetails>
          <EndTime>2005-01-24T02:45:36.000Z</EndTime>
        </ListingDetails>
        <Location>S********e</Location>
        <Title>BestOffer notification test.</Title>
      </Item>
    </GetBestOffersResponse>
  </soapenv:Body>
</soapenv:Envelope>