Skip to main content

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

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

The data fields returned by the EndOfAuction notification are the same as those for the GetItemTransactions call with ReturnAll details requested. Refer to the GetItemTransactions call reference documentation for additional information.

Refer to SOAP Message Body for information about 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>4********0</CorrelationID>
      <Version>699</Version>
      <Build>E699_CORE_BUNDLED_12457306_R1</Build>
      <NotificationEventName>EndOfAuction</NotificationEventName>
      <RecipientUserID>t********r</RecipientUserID>
      <EIASToken>n********Q</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>1********9</ItemID>
        <ListingDetails>
          <RelistedItemID>1********4</RelistedItemID>
          <StartTime>2011-01-06T08:08:17.000Z</StartTime>
          <EndTime>2011-01-06T08:08:24.000Z</EndTime>
          <ViewItemURL>https://ebay.com/ws/eBayISAPI.dll?ViewItem&Item=1********9</ViewItemURL>
        </ListingDetails>
        <ListingType>Chinese</ListingType>
        <PrimaryCategory>
          <CategoryID>377</CategoryID>
        </PrimaryCategory>
        <PrivateListing>false</PrivateListing>
        <Quantity>1</Quantity>
        <Seller>
          <AboutMePage>false</AboutMePage>
          <EIASToken>n********=</EIASToken>
          <Email>t********r@********.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>t********r</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.ebay.com/id=1********6</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>
        <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>n********=</EIASToken>
            <Email>b********r@********.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>t********r</UserID>
            <UserIDChanged>false</UserIDChanged>
            <UserIDLastChanged>2009-02-12T05:01:49.000Z</UserIDLastChanged>
            <VATStatus>NoVATTax</VATStatus>
            <BuyerInfo>
              <ShippingAddress>
                <Name>B********r</Name>
                <Street1>7********e</Street1>
                <CityName>S********o</CityName>
                <StateOrProvince>CA</StateOrProvince>
                <Country>US</Country>
                <PostalCode>9***2</PostalCode>
                <AddressID>5********2</AddressID>
                <AddressOwner>eBay</AddressOwner>
                <AddressUsage>DefaultShipping</AddressUsage>
               </ShippingAddress>
            </BuyerInfo>
            <UserAnonymized>false</UserAnonymized>
          </Buyer>
          <ShippingDetails>
            <ChangePaymentInstructions>true</ChangePaymentInstructions>
            <PaymentEdited>false</PaymentEdited>
            <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>1********2</SellingManagerSalesRecordNumber>
          </ShippingDetails>
          <ConvertedAmountPaid currencyID="USD">3.5</ConvertedAmountPaid>
          <ConvertedTransactionPrice currencyID="USD">1.0</ConvertedTransactionPrice>
          <CreatedDate>2011-01-06T08:08:24.000Z</CreatedDate>
          <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>
          <BuyerGuaranteePrice currencyID="USD">20000.0</BuyerGuaranteePrice>
          <IntangibleItem>false</IntangibleItem>
        </Transaction>
      </TransactionArray>
      <PayPalPreferred>false</PayPalPreferred>
    </GetItemTransactionsResponse>
  </soapenv:Body>
</soapenv:Envelope>