Just getting started with the Deal API? See the following documents for details on using this API:
See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.
The API release history
The following table lists recent Deal API releases.
Description of Release
|Version 1.3.0||2020-12-18||Updated the descriptions of price and shippingCost for the getDealItems method for VAT|
|Version 1.2.0||2020-10-30||Added request headers, API restrictions, and eBay Partner Network information to the getDealItems, getEvent, getEvents, and getEventItems resources|
|Version 1.1.0||2020-10-06||Added a new filter delivery_country to the deal_item and event_item resources|
|Version 1.0.0||2020-07-09||Initial release of Version 1.0.0|
This release updates the descriptions of price and shippingCost for the getDealItems method to reflect that value-added tax (VAT) is included in the cost for an item in applicable jurisdictions.
Added references to VAT to getDealItems
The descriptions of price and shippingCost for the getDealItems method have been updated to include references to VAT. VAT applies in over 160 countries around the world. For items that are purchased from VAT-applicable jurisdictions, VAT will apply.
This release updates the descriptions of the getDealItems, getEvent, getEvents, and getEventItems resources.
Added request headers, API restrictions, and eBay Partner Network information
The descriptions of the getDealItems, getEvent, getEvents, and getEventItems resources has been updated to include information on request headers, API restrictions, and the eBay Partner Network.
Specific updates to these descriptions are below.
This method uses the X-EBAY-C-ENDUSERCTX request header to support revenue sharing for eBay Partner Networks and to improve the accuracy of shipping and delivery time estimations. For details see, Request headers in the Buying Integration Guide.
For a list of supported sites and other restrictions, see API Restrictions.
eBay Partner Network
eBay Partner Network: In order to be commissioned for your sales, you must use the URL returned in the itemAffiliateWebUrl field to forward your buyer to the ebay.com site.
This release introduces a new filter, delivery_country, and a corresponding error code for invalid values. This new filter applies to both deal_item and event_item resources.
Added new error message
|180010||Invalid filter 'delivery_country'. Please refer to the documentation for assistance.|
This is the initial release of the Deal API, Version 1.0.0. For a list of the new resource and methods, see the Deal API Reference.