Sign in

v1

latestOpenAPI 3.0.0eBay API License Agreement2026-07-1441431.0 KB
event

This method retrieves the details for an eBay event. The result set contains detailed information associated with the specified event ID, such as applicable coupons, start and end dates, and event terms. 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. Restrictions This method can return a maximum of 10,000 items. For a list of supported sites and other restrictions, see API Restrictions. eBay Partner Network: In order to receive a commission for your sales, you must use the URL returned in the itemAffiliateWebUrl field to forward your buyer to the ebay.com site.

get/event/{event_id}

Path parameters

event_idstring required

The unique identifier for the eBay event.

Headers

X-EBAY-C-MARKETPLACE-IDstring required

A header used to specify the eBay marketplace ID.

Response

OK

descriptionstring

The event description.

endDatestring

The end date for the event.

eventAffiliateWebUrlstring

The URL of the View Event page for the event, which includes the affiliate tracking ID.

eventIdstring

The unique identifier for the event.

eventWebUrlstring

The web URL for the event.

startDatestring

The start date for the event.

titlestring

The title of the event.