Skip to main content

eBay sends an ItemClosed notification to all subscribed parties of interest when a fixed-price listing ends without sales, or when an auction listing ends with no winning bidder. This notification is sent shortly after the ItemUnsold notification is sent to the seller. The typical flow of events is:

  1. A third party subscribes to the ItemClosed notification on behalf of a buyer or seller.
  2. The item closes with an ItemUnsold event.
  3. eBay sends the ItemClosed notification to the third party, indicating the item has closed.

Data Fields Returned

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

The data fields returned by the ItemClosed 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 ItemClosed 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">F*******=</ebl:NotificationSignature>
  </ebl:RequesterCredentials>
  </soapenv:Header>
  <soapenv:Body>
    <GetItemResponse xmlns="urn:ebay:apis:eBLBaseComponents">
      <Timestamp>2010-05-10T21:59:36.810Z</Timestamp>
      <Ack>Success</Ack>
      <CorrelationID>2*******0</CorrelationID>
      <Version>669</Version>
      <Build>E669_CORE_BUNDLED_11196875_R1</Build>
      <NotificationEventName>ItemClosed</NotificationEventName>
      <RecipientUserID>s*******y</RecipientUserID>
      <EIASToken>nY+sHZ2PrBmdj6wVnY+sEZ2PrA2dj6wJkoejAJKFqQqdj6x9nY+seQ**</EIASToken>
      <Item>
        <AutoPay>false</AutoPay>
        <BuyerProtection>ItemEligible</BuyerProtection>
        <BuyItNowPrice currencyID="USD">10.0</BuyItNowPrice>
        <Country>US</Country>
        <Currency>USD</Currency>
        <HitCounter>NoHitCounter</HitCounter>
        <ItemID>2*******9</ItemID>
        <ListingDetails>
          <Adult>false</Adult>
          <BindingAuction>false</BindingAuction>
          <CheckoutEnabled>true</CheckoutEnabled>
          <ConvertedBuyItNowPrice currencyID="USD">10.0</ConvertedBuyItNowPrice>
          <ConvertedStartPrice currencyID="USD">1.0</ConvertedStartPrice>
          <ConvertedReservePrice currencyID="USD">0.0</ConvertedReservePrice>
          <HasReservePrice>false</HasReservePrice>
          <StartTime>2010-05-10T21:30:45.000Z</StartTime>
          <EndTime>2010-05-10T21:31:26.000Z</EndTime>
          <ViewItemURL>https://ebay.com/ws/eBayISAPI.dll?ViewItem&amp;item=2*******9&amp;category=357</ViewItemURL>
          <HasUnansweredQuestions>false</HasUnansweredQuestions>
          <HasPublicMessages>false</HasPublicMessages>
          <BuyItNowAvailable>true</BuyItNowAvailable>
        </ListingDetails>
        <ListingDuration>Days_1</ListingDuration>
        <ListingType>Chinese</ListingType>
        <Location>S*******A</Locationn>
        <PrimaryCategory>
          <CategoryID>357</CategoryID>
          <CategoryName>Art:Art from Dealers &amp; Resellers:Folk Art &amp; Primitives</CategoryName>
        </PrimaryCategory>
        <PrivateListing>false</PrivateListing>
        <Quantity>1</Quantity>
        <ReservePrice currencyID="USD">0.0</ReservePrice>
        <ReviseStatus>
          <ItemRevised>false</ItemRevised>
        </ReviseStatus>
        <Seller>
          <AboutMePage>false</AboutMePage>
          <Email>n*******1@*******.com</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*******y</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>
            <LiveAuctionAuthorized>false</LiveAuctionAuthorized>
            <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>
          <LeadCount>0</LeadCount>
          <MinimumToBid currencyID="USD">1.0</MinimumToBid>
          <QuantitySold>0</QuantitySold>
          <ReserveMet>true</ReserveMet>
          <SecondChanceEligible>false</SecondChanceEligible>
          <ListingStatus>Completed</ListingStatus>
        </SellingStatus>
        <ShippingDetails>
          <AllowPaymentEdit>true</AllowPaymentEdit>
          <ApplyShippingDiscount>false</ApplyShippingDiscount>
          <InsuranceFee currencyID="USD">0.0</InsuranceFee>
          <InsuranceOption>NotOffered</InsuranceOption>
          <ShippingServiceOptions>
            <ShippingService>UPSGround</ShippingService>
            <ShippingServiceCost currencyID="USD">5.0</ShippingServiceCost>
            <ShippingServicePriority>1</ShippingServicePriority>
            <ExpeditedService>false</ExpeditedService>
            <ShippingTimeMin>1</ShippingTimeMin>
            <ShippingTimeMax>6</ShippingTimeMax>
          </ShippingServiceOptions>
          <ShippingType>Flat</ShippingType>
          <InsuranceDetails>
            <InsuranceOption>NotOffered</InsuranceOption>
          </InsuranceDetails>
        </ShippingDetails>
        <ShipToLocations>US</ShipToLocations>
        <Site>US</Site>
        <StartPrice currencyID="USD">1.0</StartPrice>
        <SubTitle>sub title</SubTitle>
        <TimeLeft>PT0S</TimeLeft>
        <Title>Test Norman ItemUnsold notify</Title>
        <HitCount>0</HitCount>
        <PostalCode>9***2</PostalCode>
        <PictureDetails>
          <PhotoDisplay>None</PhotoDisplay>
        </PictureDetails>
        <DispatchTimeMax>5</DispatchTimeMax>
        <ProxyItem>false</ProxyItem>
        <BuyerGuaranteePrice currencyID="USD">20.0</BuyerGuaranteePrice>
        <IntangibleItem>false</IntangibleItem>
        <ReturnPolicy>
          <RefundOption>MoneyBack</RefundOption>
          <Refund>MoneyBack</Refund>
          <ReturnsWithinOption>Days_30</ReturnsWithinOption>
          <ReturnsWithin>30 Days</ReturnsWithin>
          <ReturnsAcceptedOption>ReturnsAccepted</ReturnsAcceptedOption>
          <ReturnsAccepted>Returns Accepted</ReturnsAccepted>
          <ShippingCostPaidByOption>Buyer</ShippingCostPaidByOption>
          <ShippingCostPaidBy>Buyer</ShippingCostPaidBy>
        </ReturnPolicy>
      </Item>
    </GetItemResponse>
  </soapenv:Body>
</soapenv:Envelope>

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