NotificationEventTypeCodeType ( token )

Defines all notification events that can be used.

Types that use NotificationEventTypeCodeType:

Enumeration Values

Value Description Which calls use this value *
AccountSummary An informational alert about account activity. A user can subscribe to receive an account activity summary via SMS. 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.

Applies to both Buyers and Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
AccountSuspended The account was suspended. Available for SMS on the UK and Germany sites. Not applicable to Platform Notifications.

Applies to both Buyers and Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
AddToBidGroup An informational alert sent to a user when when an item is added to her or his bid group. DO NOT USE. This notification was REMOVED in 549. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
AddToWatchList An informational alert sent to a user when an item is added to her or his watch list. DO NOT USE. This notification was REMOVED in 549. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
AskSellerQuestion Sent to a seller when a question is posted about one of the seller's active listings.

Applies to Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
AuctionCheckoutComplete Sent to a seller when a buyer completes the checkout process for an item. Not sent when an auction ends without bids.

For checkouts that involve more than one item, AuctionCheckoutComplete is sent only for the first item. Because its payload is based on GetItemTransactions, only a single item is included in the notification.

Applies to Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
BestOffer Sent to a seller when a bidder makes a best offer on an item opted into the Best Offer feature by the seller.

Applies to Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
BestOfferDeclined Sent to a subscribing third-party for a buyer when a seller rejects the buyer's best offer on an item opted into the Best Offer feature by the seller. Also sent to a buyer when the buyer rejects a seller's counteroffer.

Applies to Buyers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
BestOfferPlaced Sent to a subscribing third party for a buyer who makes a best offer on an item opted into the Best Offer feature by a seller.

Applies to Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
BidItemEndingSoon A notification type where the listing of the bid item is about to end. This event has a property with which caller can specify the TimeLeft before the listing ends.

Applies to Buyers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
BidPlaced Sent to a subscribing third party for the buyer when a user places a bid for an item.

Applies to Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
BidReceived Sent to a subscribing third party for the seller when a user places a bid for an item.

Applies to Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
BulkDataExchangeJobCompleted An informational alert sent to a subscribing application when the Bulk exchange job completes.

Applies to Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
BuyerResponseDispute Sent to an eBay partner on behalf of a seller when a buyer responds to a dispute the seller has opened. Sent for each response the buyer makes.

Applies to Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
Checkout Do not use. This notification event is tied to eBay Express functionality which no longer exists. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
CheckoutBuyerRequestsTotal Sent to a seller each time a buyer requests a total price. Occurs before checkout is complete.

Applies to Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
CounterOfferReceived Sent to a subscribing third party for a buyer when a seller makes a counter offer to the buyer's best offer on an item opted into the Best Offer feature by the seller.

Applies to Buyers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
CustomCode Reserved for future use. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
EBPAppealedCase This notification is sent to the subscribed buyer or seller (or application) when the decision of an eBP case is appealed. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
EBPClosedAppeal This notification is sent to the subscribed buyer or seller (or application) when an appeal of an eBP case decision has been closed. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
EBPClosedCase This notification is sent to the subscribed buyer or seller (or application) when an eBP case has been closed. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
EBPEscalatedCase This notification is sent to the subscribed buyer or seller (or application) when an eBP case is escalated. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
EBPMyPaymentDue This notification is sent to the subscribed seller (or application) when payment (to eBay or buyer) is due. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
EBPMyResponseDue This notification is sent to a subscribing buyer or seller (or application) when a response to the eBP case is due from the call user. When a eBP case is opened, this notification is only sent to the seller involved in the case and not the buyer. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
EBPOnHoldCase This notification is sent to the subscribed buyer or seller (or application) when an eBP case has been onholded by CS. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
EBPOtherPartyResponseDue This notification is sent to the subscribed buyer or seller (or application) when a response to the eBP case is due from the other party in the case. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
EBPPaymentDone This notification is sent to the subscribed seller (or application) when payment (to eBay or buyer) is processed. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
EmailAddressChanged The email address was changed. Available for SMS on the UK and Germany sites. Not applicable to Platform Notifications.

Applies to both Buyers and Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
EndOfAuction Sent when an auction ends. An auction ends either when its duration expires or the buyer purchases an item with Buy It Now. Applies to all competitive-bid auctions.

Applies to both Buyers and Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
Feedback When a user leaves feedback, this notification is sent to a third party who has subscribed on a user's behalf. The user can be a buyer who leaves feedback for a seller or a seller who leaves feedback for a buyer.

Applies to both Buyers and Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
FeedbackForSeller If specified in SetNotificationPreferences, eBay drops this value and uses Feedback instead. Applications should remove any dependencies on this value.

Use Feedback Instead.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
FeedbackLeft Sent to third parties subscribed on a user's behalf when feedback comments are left by that user.

Applies to both Buyers and Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
FeedbackReceived Sent to third parties subscribed on a user's behalf when feedback comments are received by that user.

Applies to both Buyers and Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
FeedbackStarChanged Sent to a subscribing third party when a user's feedback star level changes.

Applies to both Buyers and Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
FixedPriceTransaction Sent to a seller when a buyer purchases a fixed-price item.

Applies to Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
INRBuyerClosedDispute A notification type where a specified user or application is notified on behalf of a buyer when a buyer closes Item Not Received dispute that buyer had opened. Sent for each closure the buyer performs.

Applies to Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
INRBuyerOpenedDispute A notification type where a specified user or application is notified on behalf of a buyer when a buyer opens an Item Not Received dispute. Sent for each dispute the buyer opens.

Applies to Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
INRBuyerRespondedToDispute A notification type where a specified user or application is notified on behalf of a buyer when a buyer responds to Item Not Received dispute that buyer had opened. Sent for each response the buyer makes.

Applies to Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
INRSellerRespondedToDispute A notification type where a specified user or application is notified on behalf of a seller when a seller responds to an Item Not Received dispute that buyer had opened. Sent for each response the seller makes.

Applies to Buyers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ItemAddedToBidGroup Sent to a subscribing third party when a user adds an item to her or his bid group.

Applies to Buyers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ItemAddedToWatchList Sent to a subscribing third party when a user adds an item to her or his watch list.

Applies to Buyers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ItemClosed Specifies that an ItemClosed notification event has occurred. This event is triggered by ItemWon, ItemSold, and ItemUnsold events.

Applies to both Buyers and Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ItemExtended Specifies an ItemExtended notification event, when a seller has extended the duration of a listing.

Applies to Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ItemListed Sent to an eBay partner on behalf of a seller when a seller lists or relists an item. Sent for each item the seller lists.

This notification is triggered by automatic relists. For example, a seller who has opted in to automated relisting of unpaid items using UnpaidItemAssistancePreferencesType.AutoRelist will receive this notification when an unpaid item is automatically relisted.

Applies to Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ItemLost Sent to a subscribing third party for the buyer when a user lost a bid for an item.

Applies to Buyers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ItemMarkedPaid Alert sent to a subscribing buyer or seller when item marked as paid by the seller.

Applies to Sellers and Buyers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ItemMarkedShipped Alert sent to a subscribing buyer or seller when item marked as shipped by the seller.

Applies to Sellers and Buyers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ItemRemovedFromBidGroup Sent to a subscribing third party when a user removes an item from her or his bid group.

Applies to Buyers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ItemRemovedFromWatchList Sent to a subscribing third party when a user removes an item from her or his watch list.

Applies to Buyers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ItemRevised Sent to an eBay partner on behalf of a seller when a seller has revised an item.

Applies to Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ItemRevisedAddCharity Sent to an eBay partner on behalf of a seller when a seller has revised an item and added charity.

Applies to Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ItemsCanceled This event is not functional. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ItemSold Specifies an ItemSold notification event, triggered when an eBay listing ends in a sale.

Applies to Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ItemSuspended Specifies an ItemSuspended notification event. Subscribe to this event to be notified when eBay has taken down a listing for a listing problem, for example, listing in the wrong category.

Applies to both Buyers and Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ItemUnsold Sent to a subscribing third party for the seller when an item was not sold.

Applies to Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ItemWon Sent to a subscribing third party for the buyer when a user bought an item.

Applies to Buyers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
MyMessagesAlert This field was deprecated in 685, and is no longer returned. It was replaced with MyMessagesHighPriorityMessage. SetNotificationPreferences requests for MyMessagesAlert using versions lower than 685 will result in an informational warning. Such requests using versions 685 and higher will return an error response. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
MyMessagesAlertHeader This field was deprecated in 685, and is no longer returned. It was replaced with MyMessagesHighPriorityMessageHeader. SetNotificationPreferences requests for MyMessagesAlertHeader using versions lower than 685 will result in an informational warning. Such requests using versions 685 and higher will return an error response. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
MyMessageseBayMessage A notification type where a specified user or application is notified when a message from eBay is sent to My Messages. This notification type sends a GetMyMessages response at a detail level of ReturnMessages. MyMessageseBayMessageHeader and MyMessageseBayMessage cannot be subscribed to at the same time or specified in the same call.

Applies to both Buyers and Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
MyMessageseBayMessageHeader A notification type where a specified user or application is notified when a message from eBay is sent to My Messages. This notification type sends a GetMyMessages response at a detail level of ReturnHeaders. MyMessageseBayMessageHeader and MyMessageseBayMessage cannot be subscribed to at the same time or specified in the same call.

Applies to both Buyers and Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
MyMessagesHighPriorityMessage A notification type in which a specified user or application is notified when a High Priority Message (of priority 1 or 2) is sent to My Messages. Only High Priority Message will be sent back as part of the Notification payload. This notification type sends a GetMyMessages response at a detail level of ReturnMessages. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
MyMessagesHighPriorityMessageHeader A notification type in which a specified user or application is notified when a High Priority Message (of priority 1 or 2) is sent to My Messages. Only High Priority Messages will be sent back as part of the notification payload. This notification type sends a GetMyMessages response at a detail level of ReturnHeaders. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
MyMessagesM2MMessage A notification type where a specified user or application is notified when a member to member (M2M) message is sent to My Messages. This notification type sends a GetMyMessages response at a detail level of ReturnMessages. MyMessagesM2MMessageHeader and MyMessagesM2MMessage cannot be subscribed to at the same time or specified in the same call.

Applies to both Buyers and Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
MyMessagesM2MMessageHeader A notification type where a specified user or application is notified when a member to member (M2M) message is sent to My Messages. This notification type sends a GetMyMessages response at a detail level of ReturnHeaders. MyMessagesM2MMessageHeader and MyMessagesM2MMessage cannot be subscribed to at the same time or specified in the same call.

Applies to both Buyers and Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
None Not a notification event. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
OutBid Sent to a user when another buyer has placed a higher maximum bid and the user is no longer the current high bidder.

Applies to Buyers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
PasswordChanged The password was changed. Available for SMS on the UK and Germany sites. Not applicable to Platform Notifications.

Applies to Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
PasswordHintChanged The password hint was changed. Available for SMS on the UK and Germany sites. Not applicable to Platform Notifications.

Applies to Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
PaymentDetailChanged The payment detail was changed. Available for SMS on the UK and Germany sites. Not applicable to Platform Notifications.

Applies to both Buyers and Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
PlaceOffer An informational alert sent to a user when he or she places an offer for an item. DO NOT USE. This notification was REMOVED in 549. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ReadyForPayout This notification is sent to a DE or AT seller when a seller payout for an order (subject to the new eBay payment process) is scheduled to be distributed to the seller's account in the next disbursement cycle. This notification is triggered and sent when the value of PaymentHoldStatus is 'Complete' in GetOrders and other order retrieval API calls. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ReadyToShip This notification is sent to a DE or AT seller when an order (subject to the new eBay payment process) has been paid for by the buyer. This notification is triggered and sent when Checkout status is complete in GetOrders and other order retrieval API calls. Shipping the item and providing proof of shipment can expedite the process of payout to the seller's account. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
RefundFailure A notification type where sellers are notified when voluntary refunds failed.

This notification type is only applicable for DE/AT orders going through the new eBay payment process.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
RefundSuccess A notification type where sellers are notified when voluntary refunds are successful.

This notification type is only applicable for DE/AT orders going through the new eBay payment process.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
RemoveFromBidGroup An informational alert sent to a user when an item is removed from her or his bid group. DO NOT USE. This notification was REMOVED in 549. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
RemoveFromWatchList An informational alert sent to a user when an item is removed from her or his watch list. DO NOT USE. This notification was REMOVED in 549. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ReturnClosed This notification is sent to the subscribed buyer or seller (or application) when a return is closed. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ReturnCreated This notification is sent to the subscribed buyer or seller (or application) when a return is created. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ReturnDelivered This notification is sent to the subscribed buyer or seller (or application) when a return is delivered. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ReturnEscalated This notification is sent to the subscribed buyer or seller (or application) when a return is escalated. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ReturnRefundOverdue This notification is sent to the subscribed seller (or application) when refund is overdue on a return. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ReturnSellerInfoOverdue This notification is sent to the subscribed buyer or seller (or application) when Seller information like RMA and Return Address is overdue. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ReturnShipped This notification is sent to the subscribed buyer or seller (or application) when a return is shipped. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ReturnWaitingForSellerInfo This notification is sent to the subscribed seller (or application) when a return is waiting for Seller information like RMA and Return Address. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
SecondChanceOffer Reserved for future use.

Applies to Buyers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
SellerClosedDispute Sent to an eBay partner on behalf of a seller when a seller closes a dispute they had opened. Sent for each closure the seller performs.

Applies to Sellers and Buyers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
SellerOpenedDispute Sent to an eBay partner on behalf of a seller when a seller opens a dispute. Sent for each dispute the seller opens.

Applies to Buyers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
SellerRespondedToDispute Sent to an eBay partner on behalf of a seller when a seller responds to a dispute they had opened. Sent for each response the seller makes.

Applies to Buyers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
ThirdPartyCartCheckout Not functional. This notification event is tied to eBay Express functionality, which no longer exists.

Sent to a third party when their cart completes checkout on eBay Express.

Applies to Buyers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
TokenRevocation An informational alert sent to a subscribing application when a user token has been revoked.

Applies to both Buyers and Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
UnmatchedPaymentReceived A notification type that is sent to German and Austrian sellers when eBay determines that a buyer has paid less than or more than the order amount using the EFT payment method. Upon receiving this notification, the seller can then either accept or reject the buyer's payment amount through the site or by using the AcceptAdjustment or RejectAdjustment call of the Order Adjustment API. GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
UserIDChanged The userid was changed. Available for SMS on the UK and Germany sites. Not applicable to Platform Notifications.

Applies to both Buyers and Sellers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
WatchedItemEndingSoon A notification type where the listing of the watched item is about to end. This event has a property with which caller can specify the TimeLeft before the listing ends.

Applies to Buyers.
GetNotificationPreferences, GetNotificationsUsage, SetNotificationPreferences
  * See the Enumeration Index to see exact use of each enumeration value in the API.

Copyright © 2005–2012 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.