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.

Release Version

Release Date

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

v.1.3.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.

v.1.2.0

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.

Request headers

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.

API Restrictions

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.

v.1.1.0

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

Error Code

Message

180010 Invalid filter 'delivery_country'. Please refer to the documentation for assistance.

v1.0.0

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.