EndOfAuction Notification

The EndOfAuction notification is sent to all subscribed bidders of an auction item and to the subscribed seller of the auction item as soon as the auction listing ends with or without a winning bidder. This notification will also be sent to subscribed bidders and the subscribed seller if a buyer ends the auction as a result of using the auction listing's Buy It Now feature.

Platform Choice

When a user requests, via the notification preferences web page, to be notified of this event, the default is for the notification to be sent via API ("Platform"). The user can choose instead to be notified via wireless ("SMS").

Data Fields Returned

The EndOfAuction notification returns the same data as the GetItemTransactions call with the ReturnAll detail level.

See SOAP Message Body for details on the standard elements returned for all notifications.

Example

In this example, MagicalBookSeller is notified that her listing of "Harry Potter and the Philosopher's Stone" has ended with a successful bid from BountifulBuyer.

Sample EndOfAuction 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">1w5Fdyr9V9ofTq67etR0lA==</ebl:NotificationSignature>
  `ebl:RequesterCredentials>
  </soapenv:Header>
  <soapenv:Body>
    <GetItemTransactionsResponse xmlns="urn:ebay:apis:eBLBaseComponents">
      <Timestamp>2011-01-06T08:08:27.715Z</Timestamp>
      <Ack>Success</Ack>
      <CorrelationID>476457120</CorrelationID>
      <Version>699</Version>
      <Build>E699_CORE_BUNDLED_12457306_R1</Build>
      <NotificationEventName>EndOfAuction</NotificationEventName>
      <RecipientUserID>testuser_magicalbookseller</RecipientUserID>
      <EIASToken>nY+sHZ2PrBmdj6wVnY+sEZ2PrA2dj6wFk4CpDZSLpwqdj6x9nY+seQ**</EIASToken>
      <PaginationResult>
        <TotalNumberOfPages>1</TotalNumberOfPages>
        <TotalNumberOfEntries>1</TotalNumberOfEntries>
      </PaginationResult>
      <HasMoreTransactions>false</HasMoreTransactions>
      <TransactionsPerPage>100</TransactionsPerPage>
      <PageNumber>1</PageNumber>
      <ReturnedTransactionCountActual>1</ReturnedTransactionCountActual>
      <Item>
        <AutoPay>false</AutoPay>
        <BuyItNowPrice currencyID="USD">0.0</BuyItNowPrice>
        <Currency>USD</Currency>
        <ItemID>110066229559</ItemID>
        <ListingDetails>
          <RelistedItemID>110066229564</RelistedItemID>
          <StartTime>2011-01-06T08:08:17.000Z</StartTime>
          <EndTime>2011-01-06T08:08:24.000Z</EndTime>
          <ViewItemURL>http://cgi.sandbox.ebay.com/ws/eBayISAPI.dll?ViewItem&Item=110066229559</ViewItemURL>
          <ViewItemURLForNaturalSearch>http://cgi.sandbox.ebay.com/ws/eBayISAPI.dll?ViewItem&item=110066229559&category=0</ViewItemURLForNaturalSearch>
        </ListingDetails>
        <ListingType>Chinese</ListingType>
        <PaymentMethods>PayPal</PaymentMethods>
        <PrimaryCategory>
          <CategoryID>377</CategoryID>
        </PrimaryCategory>
        <PrivateListing>false</PrivateListing>
        <Quantity>1</Quantity>
        <SecondaryCategory>
          <CategoryID>0</CategoryID>
        </SecondaryCategory>
        <Seller>
        <AboutMePage>false</AboutMePage>
        <EIASToken>nY+sHZ2PrBmdj6wVnY+sEZ2PrA2dj6wFk4CpDZSLpwqdj6x9nY+seQ==</EIASToken>
        <Email>testuser_magicalbookseller@yahoo.com</Email>
        <FeedbackScore>31</FeedbackScore>
        <PositiveFeedbackPercent>100.0</PositiveFeedbackPercent>
        <FeedbackPrivate>false</FeedbackPrivate>
        <FeedbackRatingStar>Yellow</FeedbackRatingStar>
        <IDVerified>true</IDVerified>
        <eBayGoodStanding>true</eBayGoodStanding>
        <NewUser>false</NewUser>
        <RegistrationDate>2010-01-01T00:00:00.000Z</RegistrationDate>
        <Site>US</Site>
        <Status>Confirmed</Status>
        <UserID>testuser_magicalbookseller</UserID>
        <UserIDChanged>false</UserIDChanged>
        <UserIDLastChanged>2007-11-29T18:43: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>
            <StoreOwner>true</StoreOwner>
            <StoreURL>http://www.stores.sandbox.ebay.com/id=132854966</StoreURL>
            <SafePaymentExempt>false</SafePaymentExempt>
          </SellerInfo>
        </Seller>
         <SellingStatus>
          <BidCount>1</BidCount>
          <ConvertedCurrentPrice currencyID="USD">1.0</ConvertedCurrentPrice>
          <CurrentPrice currencyID="USD">1.0</CurrentPrice>
          <QuantitySold>1</QuantitySold>
          <ListingStatus>Completed</ListingStatus>
        </SellingStatus>
        <Site>US</Site>
        <StartPrice currencyID="USD">1.0</StartPrice>
        <Title>Harry Potter and the Philosopher&apos;s Stone</Title>
        <GetItFast>false</GetItFast>
        <IntegratedMerchantCreditCardEnabled>false</IntegratedMerchantCreditCardEnabled>
        <ConditionID>3000</ConditionID>
        <ConditionDisplayName>Like New</ConditionDisplayName>
      </Item>
      <TransactionArray>
        <Transaction>
          <AmountPaid currencyID="USD">3.5</AmountPaid>
          <AdjustmentAmount currencyID="USD">0.0</AdjustmentAmount>
          <ConvertedAdjustmentAmount currencyID="USD">0.0</ConvertedAdjustmentAmount>
          <Buyer>
            <AboutMePage>false</AboutMePage>
            <EIASToken>nY+sHZ2PrBmdj6wVnY+sEZ2PrA2dj6wFk4CoDZKDpQqdj6x9nY+seQ==</EIASToken>
            <Email>bountifulbuyer@gmail.com</Email>
            <FeedbackScore>32</FeedbackScore>
            <PositiveFeedbackPercent>100.0</PositiveFeedbackPercent>
            <FeedbackPrivate>false</FeedbackPrivate>
            <FeedbackRatingStar>Yellow</FeedbackRatingStar>
            <IDVerified>false</IDVerified>
            <eBayGoodStanding>true</eBayGoodStanding>
            <NewUser>false</NewUser>
            <RegistrationDate>1995-01-01T00:00:00.000Z</RegistrationDate>
            <Site>US</Site>
            <Status>Confirmed</Status>
            <UserID>testuser_bountifulbuyer</UserID>
            <UserIDChanged>false</UserIDChanged>
            <UserIDLastChanged>2009-02-12T05:01:49.000Z</UserIDLastChanged>
            <VATStatus>NoVATTax</VATStatus>
            <BuyerInfo>
            <ShippingAddress>
              <Name>Bountiful Buyer</Name>
              <Street1>777 Klamath Drive</Street1>
              <CityName>Sacramento</CityName>
              <StateOrProvince>CA</StateOrProvince>
              <Country>US</Country>
              <CountryName>United States</CountryName>
              <PostalCode>95842</PostalCode>
              <AddressID>5383702</AddressID>
              <AddressOwner>eBay</AddressOwner>
              <AddressUsage>DefaultShipping</AddressUsage>
            </ShippingAddress>
            </BuyerInfo>
            <UserAnonymized>false</UserAnonymized>
          </Buyer>
          <ShippingDetails>
            <ChangePaymentInstructions>true</ChangePaymentInstructions>
            <PaymentEdited>false</PaymentEdited>
            <SalesTax>
              <SalesTaxPercent>0.0</SalesTaxPercent>
              <ShippingIncludedInTax>false</ShippingIncludedInTax>
              <SalesTaxAmount currencyID="USD">0.0</SalesTaxAmount>
            </SalesTax>
            <ShippingServiceOptions>
              <ShippingService>USPSMedia</ShippingService>
              <ShippingServiceCost currencyID="USD">2.5</ShippingServiceCost>
              <ShippingServicePriority>1</ShippingServicePriority>
              <ExpeditedService>false</ExpeditedService>
              <ShippingTimeMin>2</ShippingTimeMin>
              <ShippingTimeMax>9</ShippingTimeMax>
            </ShippingServiceOptions>
            <ShippingType>Flat</ShippingType>
            <SellingManagerSalesRecordNumber>1262</SellingManagerSalesRecordNumber>
            <ThirdPartyCheckout>false</ThirdPartyCheckout>
            <TaxTable/>
            <GetItFast>false</GetItFast>
          </ShippingDetails>
          <ConvertedAmountPaid currencyID="USD">3.5</ConvertedAmountPaid>
          <ConvertedTransactionPrice currencyID="USD">1.0</ConvertedTransactionPrice>
          <CreatedDate>2011-01-06T08:08:24.000Z</CreatedDate>
          <DepositType>None</DepositType>
          <QuantityPurchased>1</QuantityPurchased>
          <Status>
            <eBayPaymentStatus>NoPaymentFailure</eBayPaymentStatus>
            <CheckoutStatus>CheckoutIncomplete</CheckoutStatus>
            <LastTimeModified>2011-01-06T08:08:25.000Z</LastTimeModified>
            <PaymentMethodUsed>None</PaymentMethodUsed>
            <CompleteStatus>Incomplete</CompleteStatus>
            <BuyerSelectedShipping>false</BuyerSelectedShipping>
            <PaymentHoldStatus>None</PaymentHoldStatus>
            <IntegratedMerchantCreditCardEnabled>false</IntegratedMerchantCreditCardEnabled>
          </Status>
          <TransactionID>0</TransactionID>
          <TransactionPrice currencyID="USD">1.0</TransactionPrice>
          <BestOfferSale>false</BestOfferSale>
          <ShippingServiceSelected>
            <ShippingService>USPSMedia</ShippingService>
            <ShippingServiceCost currencyID="USD">2.5</ShippingServiceCost>
          </ShippingServiceSelected>
          <FinalValueFee currencyID="USD">0.09</FinalValueFee>
          <TransactionSiteID>US</TransactionSiteID>
          <Platform>eBay</Platform>
          <PayPalEmailAddress>magicalbookseller@yahoo.com</PayPalEmailAddress>
          <BuyerGuaranteePrice currencyID="USD">20000.0</BuyerGuaranteePrice>
          <IntangibleItem>false</IntangibleItem>
        </Transaction>
      </TransactionArray>
      <PayPalPreferred>true</PayPalPreferred>
    </GetItemTransactionsResponse>
  </soapenv:Body>
</soapenv:Envelope>