Skip to main content
Guides
Release Notes
Request Headers
Notification Topics
Response Status and Error Codes

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

1.0.02021-03-22

Initial release of Version 1.0.0

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.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.
1.19.52024-02-13
Added support for the itemLocationRegion filter for the search method.
1.19.42024-01-30
Added support for required Economic Operator information.
1.19.32024-01-29
Expanded marketplace support for auto correction of browse terms.
1.19.22023-10-24
Added support for the userId response field to the following methods: getItem, getItemByLegacyId, and getItemsByItemGroup.
1.19.12023-08-10
Added new Error Code 12516 for search method.
1.19.02023-06-26
Added support for the conditionDescriptors field to the following methods: getItem, getItemByLegacyId, getItemsByItemGroup
1.18.42023-05-31
Waste Electrical and Electronic Equipment (WEEE) registration number is now returned.
1.18.32023-03-17
Removed the shopping_cart resource and methods as the Browse API no longer supports the Shopping Cart.
1.18.22023-02-08
Added support for the fields hazardousMaterialsLabels and repairScore to the following methods: getItem, getItemByLegacyId, and getItemsByItemGroup.
1.18.12022-11-09
Added check and error for limit and offset relation condition for the search and searchByImage methods
1.18.02022-09-02

Added the field categoryName to category objects in responses for the methods search and searchByImage

Added leafCategoryIds to items in responses for the methods search and searchByImage

Added INTERNATIONAL_SHIPPING to the list of enumerated values for the field fulfilledThrough; this affects the methods getItem, getItemByLegacyId, and getItemsByItemGroup

1.17.02022-07-21
Added the response field categoryIdPath to the methods getItem, getItemByLegacyId, getItems, and getItemsByItemGroup
1.16.02022-05-05
CLASSIFIED_AD has been added as a new option for the buyingOptions filter and the BUYING_OPTIONS_REFINEMENT fieldgroup
1.15.02022-04-13
Added the itemCreationDate response field to the getItem, getItemByLegacyId, getItems, and getItemsByItemGroup methods
1.14.02022-03-28
Added the shippingOptions array to the response fields returned by the getItems method and when the parameter "fieldgroups=COMPACT" is passed in with the getItem method.
1.13.02022-02-16
Added the response field addOnServices to the getItem, getItemByLegacyId, and getItemsByItemGroup methods in the Browse Search API
1.12.02022-01-24

Added the response field itemCreationDate to the search method in the Browse Item API

Added the response field listingMarketplaceId to the getItem, getItemByLegacyId, getItemsByItemGroup, and search methods in the Browse Search API

1.11.02021-12-15

Added the response fields sellerCustomPolicies and ecoParticipationFee to the getItem, getItemByLegacyId, and getItemsByItemGroup methods in the Browse Item API

Added five auction-related response fields to the getItem and getItems methods in the Browse Item API.

1.10.02021-11-01

Added the response fields priorityListing and watchCount to the getItem, getItems, getItemByLegacyId, and getItemsByItemGroup methods in the Browse Item API

Added the response field watchCount to the search and searchByImage methods in the Browse Search API

Added the filter priorityListing to the search method in the Browse Search API

1.9.02021-10-18
Added Browse API support for two new marketplaces: Austria (AT) and Switzerland (CH)
1.8.02021-09-08

Added the priorityListing response field to the search method

Added the sort option EndingSoonest for listings in search results

1.7.02021-08-12
Added support for AUTHENTICITY_GUARANTEE to the qualifiedPrograms filter URI parameter in the search and searchByImage resource methods
1.6.02021-06-15

Added new itemEndDate and topRatedBuyingExperience response fields to the search and searchByImage methods

Added new bidCount filter to the search and searchByImage methods

1.5.02021-05-03
Added a new tyreLabelImageUrl response field to the item, item_summary, and search_by_image resources
1.4.22021-04-08
Added support for the following marketplaces to the item and item_summary resources:
  • Ireland (EBAY_IE)
  • Netherlands (EBAY_NL)
  • Poland (EBAY_PL)
1.4.12021-02-03
Updated error code 12029 and added error code 12032 for the search and searchByImage methods
1.4.02020-12-18Short details on the release (e.g., Added new API endpoints for product search).
1.3.02020-12-03
Added support for the searchInDescription filter URI parameter in the search resource method
1.2.02020-11-13
  • Added support for AUTHENTICITY_VERIFICATION to the qualifiedPrograms filter URI parameter in the search and searchByImage resource methods
  • Added a new AuthenticityVerificationProgram type to the item resource methods
1.1.02020-10-27
New regionId field returned for included and excluded shipping regions.
1.0.02020-10-19
The Browse API has moved out of the beta stage and has entered into general availability (GA).
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
1.30.02022-02-22

Added types and methods to support the selection of add-on services to items in an order.

1.29.12021-03-10

Removed support for applied coupons and promotion codes from the getPurchaseOrder and getGuestPurchaseOrder methods.

1.29.02020-12-23
  • Added support for line item tax details.
  • Updated response field descriptions to inform of value-added tax (VAT) inclusion in applicable jurisdictions.
Show more