v1

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

This method returns paginated results containing all eBay events for the specified marketplace. 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

Query parameters

limitstring

The maximum number of items, from the current result set, returned on a single page. Default: 20 Maximum Value: 100

offsetstring

The number of items that will be skipped in the result set. This is used with the limit field to control the pagination of the output. For example, if the offset is set to 0 and the limit is set to 10, the method will retrieve items 1 through 10 from the list of items returned. If the offset is set to 10 and the limit is set to 10, the method will retrieve items 11 through 20 from the list of items returned. Default: 0

Headers

X-EBAY-C-MARKETPLACE-IDstring required

A header used to specify the eBay marketplace ID.

Response

OK

hrefstring

The relative path to the current set of results.

limitinteger

The maximum number of items, from the current result set, returned on a single page. Default: 20

nextstring

The relative path to the next set of results.

offsetinteger

The number of items that will be skipped in the result set. This is used with the limit field to control the pagination of the output. For example, if the offset is set to 0 and the limit is set to 10, the method will retrieve items 1 through 10 from the list of items returned. If the offset is set to 10 and the limit is set to 10, the method will retrieve items 11 through 20 from the list of items returned. Default: 0

prevstring

The relative path to the previous set of results.

totalinteger

The total number of matches for the specified search criteria.