Skip to main content

eBay sends a BestOfferPlaced notification to third parties subscribed on the buyer's behalf whenever a buyer places a Best Offer. A buyer can place a Best Offer by making an initial Best Offer or by countering a counteroffer. The typical flow of events is:

  • A third party subscribes to the BestOfferPlaced notification on behalf of a buyer.
  • The buyer places a Best Offer or counters a counteroffer.
  • eBay sends the BestOfferPlaced notification to the third party, indicating the buyer placed a Best Offer.

eBay also sends BestOfferPlaced notifications to the third party each time a buyer places a Best Offer, either through the eBay site or programmatically from an API or SDK.

Data Fields Returned

API Call that displays this notification: GetBestOffers with ReturnAll detail level

The data fields returned by the BestOfferPlaced notification are the same as those returned by GetBestOffersResponse with ReturnAll details requested. 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 BestOfferPlaced Notification 

<?xml version="1.0" encoding="utf-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://
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 xmlns:ebl="urn:ebay:apis:eBLBaseComponents">WSS9Y+tw+UfADY4rJF2YZQ==</
ebl:NotificationSignature>
    </ebl:RequesterCredentials>
  </soapenv:Header>
  <soapenv:Body>
    <GetBestOffersResponse xmlns="urn:ebay:apis:eBLBaseComponents">
      <Timestamp>2008-02-13T02:38:17.950Z</Timestamp>
      <Ack>Success</Ack>
      <CorrelationID>1********0</CorrelationID>
      <Version>553</Version>
      <Build>e553_core_Bundled_6057805_R1</Build>
      <NotificationEventName>BestOfferPlaced</NotificationEventName>
      <RecipientUserID>…********…</RecipientUserID>
      <BestOfferArray>
        <BestOffer>
          <BestOfferID>6********0</BestOfferID>
          <ExpirationTime>2008-02-15T02:38:02.000Z</ExpirationTime>
          <Buyer>
            <Email>s********r@a********3.com</Email>
            <FeedbackScore>1</FeedbackScore>
            <RegistrationDate>2004-02-23T23:50:13.000Z</RegistrationDate>
            <UserID>B********1</UserID>
          </Buyer>
          <Price currencyID="USD">1000.0</Price>
          <Status>Pending</Status>
          <Quantity>1</Quantity>
          <BestOfferCodeType>BuyerBestOffer</BestOfferCodeType>
        </BestOffer>
      </BestOfferArray>
      <Item>
        <BuyItNowPrice currencyID="USD">1000.0</BuyItNowPrice>
        <ItemID>2********2</ItemID>
        <ListingDetails>
          <EndTime>2008-02-18T02:37:17.000Z</EndTime>
        </ListingDetails>
        <Location>S********A</Location>
        <Title>Test BestOfferPlaced notify</Title>
      </Item>
    </GetBestOffersResponse>
  </soapenv:Body>
</soapenv:Envelope>