eBay Trading APIVersion 1031

NotificationEventTypeCodeType ( token )

Enumerated type that contains the complete list of platform notifications that can be sent out to subscribed users, servers, or applications. Some notifications are only sent to buyers or sellers, and some are sent to both buyers and sellers.

Types that use NotificationEventTypeCodeType:

Calls that use one or more values of NotificationEventTypeCodeType:

Enumeration Values

Value Description
AccountSummary An informational alert about account activity. A buyer or seller can subscribe to receive an account activity summary via SMS or Client Alerts. The user can specify the period (time range) for the account summary and can select how often the summary is to be sent. It is not triggered by an event but rather by an eBay daemon process that monitors a schedule database.
AccountSuspended This notification is sent to a subscribed buyer or seller when that eBay user's account is suspended. This notification is available for Client Alerts and for SMS only. Not applicable to Platform Notifications.
AskSellerQuestion This notification is sent to a subscribed seller when an eBay user has used the Ask a Question feature on the seller's active listing. An eBay user does not have to be an active bidder on an auction listing to ask a seller a question.

If subscribed to by a seller and when applicable, this notification will appear in the GetMemberMessages call response.
AuctionCheckoutComplete This notification is sent to the subscribed seller when the winning bidder or buyer has paid for the auction or fixed-price item and completed the checkout process.

For multiple line item orders, an AuctionCheckoutComplete notification is only generated for one of the line items in the order. In this case, the seller would look for the containing order number for the line item in the Transaction.ContainingOrder.OrderID field, and then make a GetOrders call (using the container order ID as an input filter) to retrieve complete information for the order.
BestOffer This notification is sent to a subscribed seller if a potential buyer has made a Best Offer on a Best Offer-enabled listing.

If subscribed to by a seller and when applicable, this notification will appear in the GetBestOffers call response.

Note: Historically, the Best Offer feature has not been available for auction listings, but beginning with Version 1027, scheduled to roll out the first week in August 2017, sellers in the US, UK, and DE sites will be able to offer the Best Offer feature in auction listings. Once this new capability rolls out, the seller can offer Buy It Now or Best Offer in an auction listing, but not both.
BestOfferDeclined This notification is sent to a subscribed buyer when a seller declines the buyer's Best Offer on an item.

If subscribed to by a buyer and when applicable, this notification will appear in the GetBestOffers call response.
BestOfferPlaced This notification is sent to a subscribed seller each time a prospective buyer places a Best Offer on an item.
BidItemEndingSoon This notification is sent to a subscribed buyer when the listing of the auction item where the buyer has an active bid is about to end. This event has a TimeLeft property that defines the 'ending soon' threshold value.
BidPlaced This notification is sent to a subscribed buyer when that buyer places a bid for an auction item.

If subscribed to by a buyer and when applicable, this notification will appear in the GetItem call response.
BidReceived This notification is sent to a subscribed seller each time a prospective buyer places a bid for the seller's auction item.

If subscribed to by a seller and when applicable, this notification will appear in the GetItem call response.
BulkDataExchangeJobCompleted This notification is sent to a subscribed seller when that seller's Bulk Data Exchange job completes.
BuyerCancelRequested This notification is sent to a subscribed seller when a buyer has requested an order cancellation.
BuyerNoShow This notification is sent to a subscribed seller if an eBay courier was unable to deliver an eBay Scheduled Delivery order to a buyer. This notification is only applicable for eBay Scheduled Delivery orders, which are only available in the London (UK) area.
BuyerResponseDispute This notification is sent to a subscribed seller each time a buyer responds to an Unpaid Item or Cancel Transaction case that the subscribed seller has opened up against the buyer.
CheckoutBuyerRequestsTotal This notification is sent to a subscribed seller when a buyer/winning bidder is requesting a total price before paying for the item.

This notification is applicable for auction listings and for fixed-price listings that do not require immediate payment.
CounterOfferReceived This notification is sent to a subscribed buyer when a seller makes a counter offer to the buyer's Best Offer on an item.

If subscribed to by a buyer and when applicable, this notification will appear in the GetBestOffers call response.
CustomCode Reserved for future use.
EBNOrderCanceled This notification is sent to a subscribed seller if an eBay Scheduled Delivery order has been cancelled. This notification is only applicable for eBay Scheduled Delivery orders, which are only available in the London (UK) area.
EBNOrderPickedUp This notification is sent to a subscribed seller if an eBay courier has picked up an eBay Scheduled Delivery order from a store for delivery to a buyer. This notification is only applicable for eBay Scheduled Delivery orders, which are only available in the London (UK) area.
EBPAppealedCase This notification is sent to the subscribed buyer or seller when the decision of an eBay Money Back Guarantee case is appealed.
EBPClosedAppeal This notification is sent to the subscribed buyer or seller when an appeal of an eBay Money Back Guarantee case decision has been closed.
EBPClosedCase This notification is sent to the subscribed buyer or seller when an eBay Money Back Guarantee case has been closed.
EBPEscalatedCase This notification is sent to the subscribed buyer or seller when an eBay Money Back Guarantee case is escalated to eBay customer support.
EBPMyPaymentDue This notification is sent to the subscribed seller when payment (to eBay or buyer) related to the outcome of an eBay Money Back Guarantee case is due.
EBPMyResponseDue This notification is sent to a subscribing buyer or seller when a response to the eBay Money Back Guarantee case is due from that user. When an eBay Money Back Guarantee case is opened, this notification is only sent to the seller involved in the case and not the buyer.
EBPOnHoldCase This notification is sent to a subscribed buyer or seller when an eBay Money Back Guarantee case has been put on hold by eBay customer support.
EBPOtherPartyResponseDue This notification is sent to the subscribed buyer or seller when a response to the eBay Money Back Guarantee case is due from the other party in the case.
EBPPaymentDone This notification is sent to the subscribed seller when payment (to eBay or buyer) related to the outcome of an eBay Money Back Guarantee case is processed.
EmailAddressChanged This notification is sent to a subscribed buyer or seller when that user has changed the email address associated with the user account. This notification is available for Client Alerts and for SMS only. Not applicable to Platform Notifications.
EndOfAuction This 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 the auction ends as a result of a buyer using the auction listing's Buy It Now feature.

This notification is only applicable for auction listings.
Feedback This notification is sent to a subscribed buyer or seller when that buyer or seller has left Feedback for the other party in the order, or has received Feedback from the other party in the order. Feedback is given at the order line item level.
FeedbackLeft This notification is sent to a subscribed buyer or seller when that user leaves feedback for an order partner.

If subscribed to by a buyer or seller, and when applicable, this notification will appear in the GetFeedback call response.
FeedbackReceived This notification is sent to a subscribed buyer or seller when that user receives feedback from an order partner.

If subscribed to by a buyer or seller, and when applicable, this notification will appear in the GetFeedback call response.
FeedbackStarChanged This notification is sent to a subscribed buyer or seller when that user's Feedback star has changed. Sent to a subscribing third party when a user's Feedback star level changes.

If subscribed to by a buyer or seller, and when applicable, this notification will appear in the GetUser call response.
FixedPriceTransaction This notification is sent to a subscribed seller each time a buyer purchases an item in a single or multiple-quantity, fixed-price listing.

This notification is only applicable for fixed-price listings.
INRBuyerClosedDispute This notification is sent to a subscribed seller when a buyer closes an Item Not Received dispute opened by that buyer.

If subscribed to by the seller and when applicable, this notification will appear in the GetDispute call response.
INRBuyerOpenedDispute This notification is sent to a subscribed seller when a buyer opens an Item Not Received dispute against that seller.

If subscribed to by the seller and when applicable, this notification will appear in the GetDispute call response.
INRBuyerRespondedToDispute This notification is sent to a subscribed seller when a buyer responds to an Item Not Received dispute opened by that buyer.

If subscribed to by the seller and when applicable, this notification will appear in the GetDispute call response.
INRSellerRespondedToDispute This notification is sent to a subscribed buyer when a seller responds to an Item Not Received dispute opened by the buyer.

If subscribed to by the buyer and when applicable, this notification will appear in the GetDispute call response.
ItemAddedToWatchList This notification is sent to a subscribed buyer when that buyer adds an item to the Watch List.

If subscribed to by a buyer and when applicable, this notification will appear in the GetItem call response.
ItemClosed This notification is sent to a subscribed buyer or seller when a listing ends. This notification can be triggered by an ItemWon, an ItemSold, or an ItemUnsold event.
ItemExtended This notification is sent to a subscribed seller when the duration of an eBay listing has been extended.
ItemListed This notification is sent to a subscribed seller each time one of the subscribed seller's items is listed or relisted. This notification is also triggered when the Unpaid Item Assistant mechanism relists an item for the seller.
ItemLost This notification is sent to a subscribed buyer if that buyer did not end up as the highest bidder for an auction item.

If subscribed to by a buyer and when applicable, this notification will appear in the GetItem call response.
ItemMarkedPaid This notification is sent to a subscribed buyer and seller when that seller has marked an order as 'paid'.
ItemMarkedShipped This notification is sent to a subscribed buyer and seller when that seller has marked an item as 'shipped'.
ItemOutOfStock This notification is sent to a subscribed seller when the quantity of a multiple-quantity, Good 'Til Cancelled, fixed-price listing has reached '0'. This notification will only be sent if the seller has the out-of-stock feature turned on in My eBay Preferences.
ItemReadyForPickup This notification is sent to a subscribed buyer when an In-Store Pickup or Click and Collect order is ready to be picked up at the merchant's store.
ItemRemovedFromWatchList This notification is sent to a subscribed buyer when that buyer removes an item from the Watch List.

If subscribed to by a buyer and when applicable, this notification will appear in the GetItem call response.
ItemRevised This notification is sent to a subscribed seller when one of the subscribed seller's items is revised.

If subscribed to by a seller and when applicable, this notification will appear in the GetItem call response.
ItemRevisedAddCharity This notification is sent to a subscribed seller when the seller has revised a listing and added a nonprofit organization to receive a percentage (10 percent up to 100 percent) of the proceeds.
ItemSold This notification is sent to a subscribed seller when an eBay listing ends in a sale.
ItemSuspended This notification is sent to a subscribed buyer or seller when a listing is administratively taken down by eBay.
ItemUnsold This notification is sent to a subscribed seller when an auction listing ends with no winning bidder or when a fixed-price listing ends with no sale(s).

If subscribed to by a seller and when applicable, this notification will appear in the GetItem call response.
ItemWon This notification is sent to a subscribed buyer if that buyer is the winner of an auction item.

If subscribed to by a buyer and when applicable, this notification will appear in the GetItem call response.
M2MMessageStatusChange This notification is sent to a subscribed buyer or seller if the status of a member-to-member message has changed.
MyMessageseBayMessage This notification is sent to a subscribed buyer or seller when eBay sends a message to that user's InBox.

If subscribed to by a buyer or seller, and when applicable, this notification will appear in the GetMyMessages call response. For this notification to be returned in GetMyMessages, the DetailLevel value in the GetMyMessages request must be set to ReturnMessages.

MyMessageseBayMessageHeader and MyMessageseBayMessage cannot be subscribed to at the same time or specified in the same call.
MyMessageseBayMessageHeader This notification is sent to a subscribed buyer or seller when eBay sends a message to that user's InBox.

If subscribed to by a buyer or seller, and when applicable, this notification will appear in the GetMyMessages call response. For this notification to be returned in GetMyMessages, the DetailLevel value in the GetMyMessages request must be set to ReturnHeaders.

MyMessageseBayMessageHeader and MyMessageseBayMessage cannot be subscribed to at the same time or specified in the same call.
MyMessagesHighPriorityMessage This notification is sent to a subscribed buyer or seller when that user receives a high-priority message in InBox.

If subscribed to by a buyer or seller, and when applicable, this notification will appear in the GetMyMessages call response. For this notification to be returned in GetMyMessages, the DetailLevel value in the GetMyMessages request must be set to ReturnMessages.

MyMessagesHighPriorityMessage, MyMessagesM2MMessage, and MyMessagesHighPriorityMessageHeader cannot be subscribed to at the same time or specified in the same call.
MyMessagesHighPriorityMessageHeader This notification is sent to a subscribed buyer or seller when that user receives a high-priority message in InBox.

If subscribed to by a buyer or seller, and when applicable, this notification will appear in the GetMyMessages call response. For this notification to be returned in GetMyMessages, the DetailLevel value in the GetMyMessages request must be set to ReturnHeaders.

MyMessagesHighPriorityMessage, MyMessagesM2MMessage, and MyMessagesHighPriorityMessageHeader cannot be subscribed to at the same time or specified in the same call.
MyMessagesM2MMessage This notification is sent to a subscribed buyer or seller when another eBay user sends a message to that user's InBox.

If subscribed to by a buyer or seller, and when applicable, this notification will appear in the GetMyMessages call response. For this notification to be returned in GetMyMessages, the DetailLevel value in the GetMyMessages request must be set to ReturnMessages.

MyMessagesM2MMessageHeader and MyMessagesM2MMessage cannot be subscribed to at the same time or specified in the same call.
MyMessagesM2MMessageHeader This notification is sent to a subscribed buyer or seller when another eBay user sends a message to that user's InBox.

If subscribed to by a buyer or seller, and when applicable, this notification will appear in the GetMyMessages call response. For this notification to be returned in GetMyMessages, the DetailLevel value in the GetMyMessages request must be set to ReturnHeaders.

MyMessagesM2MMessageHeader and MyMessagesM2MMessage cannot be subscribed to at the same time or specified in the same call.
None This notification is for internal or future use.
OrderInquiryClosed This notification is sent to a subscribed seller when an Item Not Received inquiry against an order line item has closed.
OrderInquiryEscalatedToCase This notification is sent to a subscribed seller when an Item Not Received inquiry against an order line item has been escalated to an eBay Money Back Guarantee case.
OrderInquiryOpened This notification is sent to a subscribed seller when the buyer has opened up an Item Not Received inquiry against an order line item.
OrderInquiryProvideShipmentInformation This notification is sent to a subscribed seller alerting the seller that he/she should provide shipment tracking information to the buyer in order to expedite the closure of an Item Not Received inquiry, and to avoid the possibility that the buyer will escalate the inquiry into an eBay Money Back Guarantee case.
OrderInquiryReminderForEscalation This notification is sent to a subscribed seller alerting the seller that the buyer will soon be eligible to escalate an Item Not Received inquiry into an eBay Money Back Guarantee case.
OutBid This notification is sent to a subscribed buyer when another buyer has outbid (placed a higher bid) the subscribed buyer on an auction listing, and the subscribed buyer is no longer the current high bidder.

This notification is only applicable for auction listings.
PasswordChanged This notification is sent to a subscribed buyer or seller when that user has changed the password used for login. This notification is available for Client Alerts and for SMS only. Not applicable to Platform Notifications.
PasswordHintChanged This notification is sent to a subscribed buyer or seller when that user has changed the password hint. This notification is available for Client Alerts and for SMS only. Not applicable to Platform Notifications.
PaymentDetailChanged This notification is sent to a subscribed seller when that seller has changed the payment methods used to pay seller fees for the account. This notification is available for Client Alerts and for SMS only. Not applicable to Platform Notifications.
PaymentReminder This notification is sent to a subscribed buyer if payment is still due for an order.
ReturnClosed This notification is sent to a subscribed buyer or seller when a return request is closed.
ReturnCreated This notification is sent to a subscribed buyer or seller when a return request involving those users is created.
ReturnDelivered This notification is sent to a subscribed buyer or seller when a return item is received by the seller.
ReturnEscalated This notification is sent to a subscribed buyer or seller when a return request is escalated into a eBay Money Back Guarantee case.
ReturnRefundOverdue This notification is sent to a subscribed buyer or seller when a refund to the buyer is overdue on a return.
ReturnSellerInfoOverdue This notification is sent to a subscribed buyer or seller when information from the seller (e.g. a Return Merchandise Authorization number) is overdue.
ReturnShipped This notification is sent to a subscribed buyer or seller when the buyer has shipped a return item back to the seller.
ReturnWaitingForSellerInfo This notification is sent to a subscribed seller when a return request is waiting for information from the seller, like a Return Merchandise Authorization (RMA) number or a correct return address.
SecondChanceOffer This notification is sent to a subscribed buyer when that buyer is offered a Second Chance Offer from the seller, after that buyer failed to win the original auction of the item.

If subscribed to by a buyer and when applicable, this notification will appear in the GetItem call response.
SellerClosedDispute This notification is sent to the subscribed buyer and seller if the seller closes an Unpaid Item or Cancel Transaction case against the buyer.

If subscribed to by a buyer or seller, and when applicable, this notification will appear in the GetDispute call response.
SellerOpenedDispute This notification is sent to a subscribed buyer if a seller opens up an Unpaid Item or Cancel Transaction case against the subscribed buyer.

If subscribed to by a buyer and when applicable, this notification will appear through the GetDispute call response.
SellerRespondedToDispute This notification is sent to a subscribed buyer each time a seller responds to an Item Not Received or (Item) Significantly Not As Described case that the subscribed buyer has opened up against the seller.

If subscribed to by a buyer and when applicable, this notification will appear in the GetDispute call response.
ShoppingCartItemEndingSoon This notification is sent to a subscribed buyer when an item in the buyer's shopping cart is about to end. This event has a TimeLeft property that defines the 'ending soon' threshold value.
TokenRevocation This notification is sent to a subscribed buyer or seller if that user's authentication token is revoked.

If subscribed to by a buyer or seller, and when applicable, this notification will appear in the GetTokenStatus call response.
UserIDChanged This notification is sent to a subscribed buyer or seller when that user has modified their eBay user ID.
WatchedItemEndingSoon This notification is sent to a subscribed buyer when a listing that the buyer is watching is ending soon. This event has a TimeLeft property that defines the 'ending soon' threshold value.
WebnextMobilePhotoSync This notification is no longer applicable.
  * See the Enumeration Index to see exact use of each enumeration value in the API.