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

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

Notification

Release VersionRelease DateDescription of Release
1.6.72025-12-12

Added notification topic: Item Marked Shipped

1.6.62025-12-01Short details on the release (e.g., Added new API endpoints for product search).
1.6.52025-11-17
Added two notification topics: Buyer Question and New Message</p>
1.6.42025-10-01

Added three notification topics:

  • Feedback Left

  • Feedback Received

  • Feedback Star Rating

Updated Topic Descriptions for current Notification Topics for accuracy and consistency.

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

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

Added support for the sellerUserId response field to the following methods: getItemFeed and getItemSnapshotFeed.

Added support for focus categories for the qualfiedPrograms field of the getItemFeed method.

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