Skip to main content

eBay sends an ItemAddedToWatchList notification to third parties subscribed on the buyer's behalf whenever a buyer adds an item to their watch list. The typical flow of events is:

  1. A third party subscribes to the ItemAddedToWatchList notification on behalf of a buyer.
  2. The buyer adds an item to their watch list.
  3. eBay sends the ItemAddedToWatchList notification to the third party, indicating the item was just added to the watch list.

eBay also sends ItemAddedToWatchList notifications to the third party for all items the buyer adds, either through the eBay sites or programmatically from an API or SDK.

Data Fields Returned

API Call that displays this notification: GetItem with default detail level

The data fields returned by the ItemAddedToWatchList notification are the same as those returned by GetItemResponse with default details requested. Refer to the GetItem call reference documentation for additional information.

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

Example

Sample ItemAddedToWatchList 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">w********=</
ebl:NotificationSignature>
</ebl:RequesterCredentials>
</soapenv:Header>
  <soapenv:Body>
    <GetItemResponse xmlns="urn:ebay:apis:eBLBaseComponents">
      <Timestamp>2008-02-12T00:07:45.500Z</Timestamp>
      <Ack>Success</Ack>
      <CorrelationID>1*******0</CorrelationID>
      <Version>553</Version>
      <Build>e553_core_Bundled_6057805_R1</Build>
      <NotificationEventName>ItemAddedToWatchList</NotificationEventName>
      <RecipientUserID>B*******1</RecipientUserID>
      <Item>
        <AutoPay>false</AutoPay>
        <BuyerProtection>ItemEligible</BuyerProtection>
        <BuyItNowPrice currencyID="USD">10.0</BuyItNowPrice>
        <Country>US</Country>
        <Currency>USD</Currency>
        <HitCounter>NoHitCounter</HitCounter>
        <ItemID>2*******6</ItemID>
        <ListingDetails>
          <Adult>false</Adult>
          <BindingAuction>false</BindingAuction>
          <CheckoutEnabled>true</CheckoutEnabled>
          <ConvertedBuyItNowPrice currencyID="USD">10.0</ConvertedBuyItNowPrice>
          <ConvertedStartPrice currencyID="USD">1.0</ConvertedStartPrice>
          <HasReservePrice>false</HasReservePrice>
          <StartTime>2008-02-12T00:06:25.000Z</StartTime>
          <EndTime>2008-02-17T00:06:25.000Z</EndTime>
          <ViewItemURL>https://ebay.com/ws/eBayISAPI.dll?ViewItem&amp;item=2*******6&amp;category=1463</ViewItemURL>
          <HasUnansweredQuestions>false</HasUnansweredQuestions>
          <HasPublicMessages>false</HasPublicMessages>
          <BuyItNowAvailable>true</BuyItNowAvailable>
        </ListingDetails>
        <ListingDuration>Days_5</ListingDuration>
        <ListingType>Chinese</ListingType>
        <Location>S*******A</Location>
        <PrimaryCategory>
          <CategoryID>1463</CategoryID>
          <CategoryName>Collectibles:Trading Cards:Phone Cards</CategoryName>
        </PrimaryCategory>
        <PrivateListing>false</PrivateListing>
        <Quantity>1</Quantity>
        <ReviseStatus>
          <ItemRevised>false</ItemRevised>
        </ReviseStatus>
         <Seller>
          <AboutMePage>false</AboutMePage>
          <Email>Invalid Request</Email>
          <FeedbackScore>100</FeedbackScore>
          <PositiveFeedbackPercent>98.1</PositiveFeedbackPercent>
          <FeedbackPrivate>false</FeedbackPrivate>
          <FeedbackRatingStar>Turquoise</FeedbackRatingStar>
          <IDVerified>false</IDVerified>
          <eBayGoodStanding>true</eBayGoodStanding>
          <NewUser>false</NewUser>
          <RegistrationDate>2004-02-23T23:50:13.000Z</RegistrationDate>
          <Site>US</Site>
          <Status>Confirmed</Status>
          <UserID>S*******1</UserID>
          <UserIDChanged>false</UserIDChanged>
          <UserIDLastChanged>2004-02-23T23:48:54.000Z</UserIDLastChanged>
          <VATStatus>NoVATTax</VATStatus>
          <SellerInfo>
            <AllowPaymentEdit>true</AllowPaymentEdit>
            <CheckoutEnabled>true</CheckoutEnabled>
            <CIPBankAccountStored>false</CIPBankAccountStored>
            <GoodStanding>true</GoodStanding>
            <MerchandizingPref>OptIn</MerchandizingPref>
            <QualifiesForB2BVAT>false</QualifiesForB2BVAT>
            <SellerLevel>None</SellerLevel>
            <StoreOwner>false</StoreOwner>
            <SafePaymentExempt>true</SafePaymentExempt>
          </SellerInfo>
          <MotorsDealer>false</MotorsDealer>
        </Seller>
        <SellingStatus>
          <BidCount>0</BidCount>
          <BidIncrement currencyID="USD">0.25</BidIncrement>
          <ConvertedCurrentPrice currencyID="USD">1.0</ConvertedCurrentPrice>
          <CurrentPrice currencyID="USD">1.0</CurrentPrice>
          <MinimumToBid currencyID="USD">1.0</MinimumToBid>
          <QuantitySold>0</QuantitySold>
          <ReserveMet>true</ReserveMet>
          <SecondChanceEligible>false</SecondChanceEligible>
          <ListingStatus>Active</ListingStatus>
         </SellingStatus>
         <ShippingDetails>
          <ApplyShippingDiscount>false</ApplyShippingDiscount>
          <InsuranceOption>NotOffered</InsuranceOption>
        </ShippingDetails>
        <ShipToLocations>US</ShipToLocations>
        <Site>US</Site>
        <StartPrice currencyID="USD">1.0</StartPrice>
        <TimeLeft>P4DT23H58M40S</TimeLeft>
        <Title>Test ItemAddedToWatchList notify</Title>
        <HitCount>0</HitCount>
        <PictureDetails>
          <PhotoDisplay>None</PhotoDisplay>
        </PictureDetails>
        <ProxyItem>false</ProxyItem>
      </Item>
    </GetItemResponse>
  </soapenv:Body>
</soapenv:Envelope>

Got thoughts? Click the feedback button – your insights help us improve!