Developers Program
HomeDevelopAPIs
Guides
Release Notes
Request Headers
Notification Topics
Response Status and Error Codes
Traditional API Errors
Post-Order API Errors

Buy Marketing API

Release VersionRelease DateDescription of Release
1.1.02026-01-05
Added a two new methods: getMostWatchedItems and getSimilarItems.
1.0.02022-01-05
v1 beta version has transitioned to the v1 version after removal of getAlsoBoughtProducts and getAlsoViewedProducts methods.
Show more

Charity API

Release VersionRelease DateDescription of Release
1.2.12023-01-16

The getCharityOrgByLegacyId method has been deprecated and removed.

1.2.02020-08-14
Added postal code and country to the Address container of the Charity API.
1.1.02020-05-15
Added a new getCharityOrgByLegacyId resource method.
1.0.02020-04-20
The initial version of the Charity API.
Show more

Catalog API

Release VersionRelease DateDescription of Release
1.5.32025-11-13

Added a new field, compatibilityCount, to the getProduct response

1.5.22024-08-27

Added support for the Spanish and French marketplaces

1.5.12024-06-18

Added support for the Italian marketplace

1.5.02020-05-18

Two product metadata methods decommissioned

1.4.02020-04-01

Three change request methods decommissioned

1.3.12019-07-11

Three change request methods deprecated

1.3.02018-07-31

New fields returned in product metadata methods

1.2.02018-05-24

Two new calls were added to the Catalog API

1.1.02018-04-15

Three new calls were added to the Catalog API

1.0.02018-02-15

The initial version of the Catalog API

Show more

Identity API

Release VersionRelease DateDescription of Release
1.1.02019-10-24

Moved the status field to its own scope

1.0.02019-06-24
The initial version of the Identity API
Show more

Message API

Release VersionRelease DateDescription of Release
1.0.02025-11-03

Initial release of version 1.0.0

Show more

Notification

Release VersionRelease DateDescription of Release
1.6.32025-09-10

Added notification topic: Listing Preview Creation Task Status

1.6.22025-09-03

Added notification topic: Buyer Requested Purchase Quote

1.6.12024-09-12

Enabled sandbox support

1.6.02024-08-05

Added notification topics: Seller Customer Service Metric Rating and Seller Standards Profile Metrics

1.5.12023-12-14

Added new error codes to createSubscriptionFilter method

1.5.02023-06-07

Added one new notification topic: Priority Listing Revision

1.4.02023-03-14

Added three new methods: createSubscriptionFilter, getSubscriptionFilter, and deleteSubscriptionFilter

1.3.02022-11-01Short details on the release (e.g., Added new API endpoints for product search).
1.2.02021-09-15

Enabled the authorization code grant flow for user-based subscriptions in the subscription resource methods

1.1.02021-06-30

Added four new resources

Show more

Taxonomy API

Release VersionRelease DateDescription of Release
1.1.12025-05-07
Adds a new aspectConstraint field, aspectAdvancedDataType, to the fetchItemAspects and getItemAspectsForCategory responses.
1.1.02024-08-26
Added a new method, getExpiredCategories, that retrieves mappings of expired leaf categories to corresponding active leaf categories.
1.0.12023-04-04
A backslash (\) may now be inserted immediately prior to an embedded comma within a filter value when calling getCompatibilityPropertyValues. This will prevent the comma from being interpreted as a delimiter between successive property name/value pairs.
1.0.02020-10-15
The initial version of the GA version of Taxonomy API
Show more

Translation API

Release VersionRelease DateDescription of Release
1.1.6-beta2023-02-27

The following translations have been added in this release:

  • French text may be translated into English, German, Italian, and Spanish
  • Italian text may be translated into English, German, French, and Spanish
  • Spanish text may be translated into English, German, French, and Italian
  • Chinese (Mandarin) text may be translated into English
1.1.5-beta2022-10-03

The following changes have been made in this release:

  • The maximum number of characters for ITEM_DESCRIPTION is reduced to 20,000, excluding markup/tags
  • German text may be translated into Polish
  • Polish text may be translated into German
  • Updated error message for Error Code 110007
  • Added new Error Code 110008
Short details on the release (e.g., Added new API endpoints for product search).
1.1.4-beta2020-11-10
English text may now be translated into either Portuguese or Russian, and German text can be translated into English
1.1.3-beta2020-07-08
English and German text may now be translated into either French, Italian, or Spanish
1.1.2-beta2020-06-08
Added support for English-to-Japanese translations
1.1.1-beta2020-06-08
  • Updated translation context support
  • Updated text field string length
1.1.0-beta2020-01-14
Added item description for English-to-Chinese translations
1.0.0-beta2019-11-08
Initial API release
Show more

Offer API

Release VersionRelease DateDescription of Release
1.0.12020-01-09
The highBidder value is now always returned.
1.0.02018-10-11
Initial release of the Offer API.
Show more

Deal API

Release VersionRelease DateDescription of Release
1.3.02020-12-18
Updated the descriptions of price and shippingCost for the getDealItems method for VAT
1.2.02020-10-30
Added request headers, API restrictions, and eBay Partner Network information to the getDealItems, getEvent, getEvents, and getEventItems resources
1.1.02020-10-06
Added a new filter delivery_country to the deal_item and event_item resources
1.0.02020-07-09
Initial release of Version 1.0.0
Show more

VeRO API

Release VersionRelease DateDescription of Release
1.0.02025-03-26
Initial release of Version 1.0.0
Show more

Buy Marketing Beta API

Release VersionRelease DateDescription of Release
1.2.02022-01-05
Removed the methods getAlsoBoughtProducts and getAlsoViewedProducts
1.1.02017-09-26
Added the getAlsoBoughtProducts and getAlsoViewedProducts calls
1.0.02017-06-07
Initial Beta Marketing API release
Show more

Developer Analytics API

Release VersionRelease DateDescription of Release
1.0.1-beta2025-04-02
Added a new response field, count, to the getRateLimits and getUserRateLimits methods.
1.0.0-beta2018-08-20
Initial release of Version 1, beta.0.0
Show more

Client Registration API

Release VersionRelease DateDescription of Release
1.0.02022-10-19
This is the initial release of the Client Registration API
Show more

Key Management API

Release VersionRelease DateDescription of Release
1.0.02022-10-19
This is the initial release of the Key Management API
Show more

Feedback API

Release VersionRelease DateDescription of Release
1.0.02025-10-15

Initial release of the Feedback API.

Show more

Browse API

Release VersionRelease DateDescription of Release
1.20.52026-07-14
New error code added to 'get item' methods for malformed headers.
1.20.42025-06-01
Added a new error code for malformed URL encoding to the search and searchByImage methods.
1.20.32025-09-17
Added support for the charityTerms response container to the following methods: getItem, getItemByLegacyId, and getItemsByItemGroup.
1.20.22025-04-15
Added the itemOriginDate response field to the search and searchByImage methods.
1.20.12025-01-17
Added the contactUrl response field to the getItem, getItems, getItemByLegacyId, and getItemsByItemGroup methods.
1.20.02025-01-07
Added a new query parameter, quantity_for_shipping_estimate, and response field, immediatePay, to getItem, getItems, getItemByLegacyId, and getItemsByItemGroup methods.
1.19.92024-09-09
Added return of a listing's actual remaining quantity available for delivery in getItem, getItems, getItemByLegacyId, and getItemsByItemGroup methods.
1.19.82024-08-08
Added support for GPSR information.
1.19.72024-04-17
Added support for affiliate links for the Polish marketplace.
1.19.62024-03-19
Expanded values for the itemLocationRegion filter for the search method. Added support for the Belgium marketplace.
Show more

Feed API

Release VersionRelease DateDescription of Release
1.3.02026-03-05
Added support for the PROMOTION_V2 feed type.
1.2.12025-06-10
Added support for the EBAY_IE marketplace for the CBT_ITEM_ALL_ACTIVE feed type.
1.2.02025-05-15
Added support for the CBT_ITEM_ALL_ACTIVE feed type.
1.1.12025-01-06
Added a new enumerated type, promotionSourceType, to the PROMOTION feed type.
1.1.02024-05-28
Added support for the PROMOTION feed type.
1.0.32023-09-19
A new error code has been added to the getFeedType method.
1.0.22022-09-19
Added support for Product Feeds to new marketplaces.
1.0.12022-02-07
Added support for the PRODUCT_FEED feed type.
1.0.02021-11-22
Initial Release
Show more

Feed Beta API

Release VersionRelease DateDescription of Release
1.35.32024-04-17

Added support for affiliate links for the Polish marketplace for the following methods: getItemFeed and getItemSnapshotFeed.

1.35.22024-01-23

The sellerUserId field can now be returned for the getItemFeed and getItemSnapshotFeed methods. This field provides the unique identifier of a seller across all eBay sites. This value does not change, even when a user changes their username.

The qualifiedPrograms response field of the getItemFeed method has been updated to include the FEATURED value. This value indicates that an item is eligible to be placed in a Focus Category.

1.35.12023-07-27

Removed support for a number of existing fields in the getItemFeed, getItemSnapshot, and getItemGroupFeed methods

1.35.02023-07-11

Added support for condition grading for select trading card categories through the conditionDescriptors field.

1.34.12023-04-26

Removed support for the Switzerland (EBAY_CH) marketplace.

1.34.02023-02-07

Added support for the following new fields in the getItemFeed and getItemSnapshot methods: hazmatSignalWordId, hazmatSignalWord, hazmatStatementIds, hazmatStatementDescriptions, hazmatPictogramIds, hazmatPictogramDescriptions, hazmatPictogramImageUrls, hazmatAdditionalInformation, and repairScore

1.33.02022-05-04

Added support for coupons in the getItemSnapshotFeed method

1.32.02022-03-14

Added support for the following new fields in the getItemFeed method: ecoParticipationFeeValue, ecoParticipationFeeCurrency, takeBackPolicyLabel, and takeBackPolicyDescription

1.31.02022-02-15

Added support for the following new fields in the getItemSnapshotFeed method: authenticityGuaranteeServiceId, authenticityGuaranteeSelection, authenticityGuaranteeFeeValue, authenticityGuaranteeFeeCurrency

1.30.02021-12-15

Added the following new fields to the getItemSnapshotFeed method: ecoParticipationFeeCurrency, ecoParticipationFeeValue, takeBackPolicyDescription, takeBackPolicyLabel

Show more

Order API v2

Release VersionRelease DateDescription of Release
2.1.22023-10-04
Added itemOnHold field to OrderLineItemV2 type.
2.1.12023-07-25
Revised error messages for initiateGuestCheckoutSession and updateGuestQuantity methods.
2.1.02022-01-21
Added the ImportChargesV2 type and the ApplicableChargeTypeEnum enumeration type.
2.0.02021-06-01
Initial release of Order API Version 2.0.0
Show more

Order API v1

Release VersionRelease DateDescription of Release
1.36.32026-06-22

Corrected payment-related schema details

1.36.22025-05-21

Added support for the IT marketplace and associated CBT flows

1.36.12025-02-05

Added new BUYER_PROTECTION enum to ServiceTypeEnum

1.36.02023-10-04

Added itemOnHold field to OrderLineItem type.

1.35.02023-07-25

Added support for purchasing auction items

1.34.02022-01-10

Added support for paying the international duties at checkout

1.33.12022-10-10

Updated error messages about PayPal accounts for the placeOrder method

1.33.02022-09-22

Added ebayShipping boolean to Checkout and Order

1.32.02022-08-15

Added enumeration values for tax classifications

1.31.02022-06-14
  • Added support to collect and remit (C&R) Canada sales tax
  • Removed guest checkout payment flows
Show more

VeRO API v2

Release VersionRelease DateDescription of Release
2.0.02026-07-31
Initial release of Version 2.0.0
Show more

Traditional Merchandising API

Release VersionRelease DateDescription of Release
1.5.02011-08-20
1.4.02010-03-03
1.2.02009-08-19
1.1.02008-08-12
1.0.02008-06-11
Show more