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

Inventory Mapping API

Release VersionRelease DateDescription of Release
1.0.02025-08-11
The initial version of the Inventory Mapping API
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

Negotiation API

Release VersionRelease DateDescription of Release
1.1.22025-10-29

Removed supported for 2 day offerDuration for US and UK marketplaces

1.1.12025-01-16

Updates the default offer duration time on the US and UK marketplaces to 4 days

1.1.02019-10-11

Added support for the Canadian marketplace (EBAY_CA).

1.0.02019-09-25

The initial version of the Negotiation API

Show more

Leads API

Release VersionRelease DateDescription of Release
1.0.02025-12-15

Initial release of Leads API

Show more

Finances API

Release VersionRelease DateDescription of Release
1.19.02026-03-16
Added the ability to return sets of earnings insights through the order_earnings resource
1.18.02026-01-27
Added ability to retrieve filtered billing activities through the billing_activity resource.
1.17.32025-05-23
New 5-year constraint and 36-month date range constraint added for all transactions and seller payouts.
1.17.22024-04-08
A new enumeration value has been added to FeeTypeEnum.
1.17.12024-03-12
A new purchase transaction type is now supported for the getTransactions and getTransactionSummary methods.
1.17.02023-11-15

The following changes are included in the release.

  • Added new field donations in type OrderLineItem.
  • Added new enum value CHARITY_DONATION in FeeTypeEnum.
  • Added new types Tax and TaxTypeEnum and a new field taxes in type Transaction.
1.16.02023-08-28
Added support for split payouts for sellers in mainland China.
1.15.02022-11-10
Support has been added for the withholding of income tax at the State and Province level.
1.14.12022-10-19
EU and UK Payments regulations now require Digital Signatures to be included in HTTP payloads for all Finances API methods.
1.14.02022-10-17
This release adds support for eBay Seller Capital loan repayments and the reporting of taxes collected by eBay at the account level.
Show more

Message API

Release VersionRelease DateDescription of Release
1.0.02025-11-03

Initial release of version 1.0.0

Show more

Fulfillment API

Release VersionRelease DateDescription of Release
1.19.152022-09-19

Added support for eBay International Shipping.

1.19.142022-06-16

Added and updated error codes for the uploadEvidenceFile method.

1.19.132022-06-16

Effective July 1, 2022, eBay is required to collect and remit sales tax in Canada; the following changes have been incorporated in this release:

  • Added support to collect and remit (C&R) Canada sales tax
  • Sales tax is now being collected for Digitally Delivered Goods (DDG)
1.19.122022-05-31

Two error codes were added and three error codes were updated for the issueRefund method.

1.19.112022-05-05

Added new Schema to support eBay's Vault program.

1.19.102021-10-18

Changed the limit maximum value to 200 for getOrders method.

1.19.92021-08-18

Added two enumeration values (APPEAL_DENIED and APPEAL_GRANTED) for the ActivityEnum type.

1.19.82021-07-26

Added a new enumeration value (DISPUTE_REVERSED) for the ActivityEnum type.

1.19.72021-06-21

Updated description of Amount for the getOrder and getOrders methods; added VAT support to be collected in EU countries starting on July 1, 2021.

1.19.62021-06-08

Added new Schema to support the return of fulfillment program information.

Show more

Feed API

Release VersionRelease DateDescription of Release
1.3.12022-10-27

This API release aligns inventory_task reference documentation with existing filter criteria functionality and adds an error to the uploadFile method.

1.3.02021-04-26

This API release contains the following updates:

  • Seller Hub and LMS feed types are supported
  • New inventory_task resource
  • Updated FeedStatusEnum type with new enumeration value
1.2.02020-11-13

This API release contains two updates:

  • New Schedule API capabilities
  • Upload summary returned for upload feeds
1.1.02020-08-05

Release of customer_service_metric_task

1.0.12020-07-09

This release of the Sell Feed API includes changes to the documentation and other updates

1.0.02020-05-20

This is the initial release of the Sell Feed API

Show more

Metadata API

Release VersionRelease DateDescription of Release
1.13.22026-06-22
Expanded support for condition grading to salvage categories.
1.13.12026-05-14
Expanded support for condition grading to coin categories.
1.13.02026-03-06
A new method was added to the marketplace resource: getMinimumListingPricePolicies.
1.12.12026-03-05
Added the reservePriceAllowed field to the response of getCategoryPolicies.
1.12.02025-10-30
Added shipping support through the new shipping:marketplace resource, including five methods: getExcludeShippingLocations, getHandlingTimes, getShippingCarriers, getShippingLocations, and getShippingServices.
1.11.12025-07-17
The valueCategory boolean was added to the getCategoryPolicies response to indicate if the returned category is a value category.
1.11.02025-05-21
The getCurrencies method was added to the marketplace resource; Metadata support for Global Trade Item Numbers (GTINs) was added and compatibility for motors was enhanced through fields added to the get_category_policies and get_motors_listing_policies resources
1.10.02025-03-17
Six methods were added to the marketplace resource: getCategoryPolicies, getClassifiedAdPolicies, getListingTypePolicies, getMotorsListingPolicies, getShippingPolicies, and getSiteVisibilityPolicies
1.9.02024-12-18
A new resource, compatibility, has been added, with five new methods to support parts compatibility features
1.8.02024-07-09
Two methods were added to the shipping:marketplace resource: getProductSafetyLabels and getRegulatoryPolicies
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

Analytics API

Release VersionRelease DateDescription of Release
1.3.22024-02-14
Updated date_range filter of the getTrafficReport method to include support for additional time zones.
1.3.12023-12-04
New metric TOTAL_IMPRESSION_TOTAL added to getTrafficReport method.
1.3.02021-10-04
New sorting error codes added to getTrafficReport method.
1.2.02019-11-05
The new customer_service_metric resource introduces the new method getCustomerServiceMetric.
1.1.02018-10-18
Documentation update release.
1.0.02016-10-19
Initial release of Version 1.
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

Media API (REST)

Release VersionRelease DateDescription of Release
1.5.12026-06-16

Added EEK_PRODUCT_INFORMATION_SHEET and EEK_ENERGY_LABEL to DocumentTypeEnum.

1.5.0-beta2026-05-05

Added support for return shipping labels.

1.4.3-beta2026-05-04

Added new DocumentTypeEnum values: GENERAL_CERTIFICATE_OF_CONFORMITY and CHILDRENS_PRODUCT_CERTIFICATE

1.4.2-beta2026-03-26

Added support to access the maximum dimension version of the uploaded image.

1.4.1-beta2026-02-23

Added a new DocumentTypeEnum value: SAFETY_TEST_LAB_REPORTS

1.4.0-beta2025-04-17

Added support for images.

1.3.1-beta2025-04-10

Added a new languageEnum value: PORTUGUESE

1.3.0-beta2025-02-03

Added the createDocumentFromUrl method to the document resource.

1.2.0-beta2024-07-16

Added support for Documents.

1.1.1-beta2024-04-08

Reduced video retention time to 30 days.

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

VeRO API

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

Inventory API

Release VersionRelease DateDescription of Release
1.18.72026-07-07
Added new warnings for product aspects.
1.18.62026-06-22
Added support for condition grading for salvage categories.
1.18.52026-05-14
Added support for condition grading for coin categories.
1.18.42025-07-15

New error and warning added for new P&A Returns Policy.

1.18.32025-06-27

This release adds 57 new error codes for createOrReplaceInventoryItem.

1.18.22025-01-22

Added two new ConditionEnum values: PRE_OWNED_EXCELLENT and PRE_OWNED_FAIR.

1.18.12025-01-16

Added a new field, contactUrl, to Manufacturer and ResponsiblePerson types.

1.18.02024-10-22

Added three new location mapping methods to the listing resource, as well as a new fulfillment center location type to support this feature.

1.17.62024-08-01

This release adds support for GPSR information.

1.17.52024-05-29

New requirement when adding EPA approved products.

Show more

Account API v2

Release VersionRelease DateDescription of Release
2.2.02026-02-26
Added eight methods through the combined_shipping_rules resource and two methods through the user_preferences resource.
2.1.02023-08-28
Added eight new methods, getPayoutSettings and updatePayoutPercentage, to support split payout functionality for sellers in Mainland China.
2.0.02022-03-03
Initial release of Version 2.
Show more

eDelivery International Shipping

Release VersionRelease DateDescription of Release
1.2.02026-07-07
Added support for CPSC profiles.
1.1.02025-09-18
Added support for bundles.
1.0.02025-02-25
Initial release of Version 1.0.0
Show more

Recommendation API

Release VersionRelease DateDescription of Release
1.1.02020-08-25
Added support for a new ITEM enum value in the bidPercentages response field
1.0.02019-03-27
Initial release of Version 1.0.0
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

Stores API

Release VersionRelease DateDescription of Release
1.0.02024-02-22

Initial API release

Show more

Feedback API

Release VersionRelease DateDescription of Release
1.0.02025-10-15

Initial release of the Feedback API.

Show more

Account API v1

Release VersionRelease DateDescription of Release
1.9.32025-10-28

Added the new bulkCreateOrReplaceSalesTax method to the sales_tax resource.

1.9.22024-03-18

Removed cashOnDeliveryFee container from Fulfillment policies.

1.9.12022-10-11

Added a new AdvertisingProgramEnum value to support Offsite Ads.

1.9.02022-12-10

Added fields to support domestic or international promotional shipping discount profile ID

1.8.02022-12-10

Added the new advertising_eligibility resource, which includes the getAdvertisingEligibility method.

1.7.02021-12-15

Added the new custom_policy resource with four new methods to create and manage Custom Policies

1.6.32021-06-21

Added support for multi-rate tables in the Spain (EBAY_ES) and France (EBAY_FR) marketplaces for the getRateTables method.

1.6.22021-04-20

Added support for multi-rate tables in the Germany (EBAY_DE) and United Kingdom (EBAY_GB) marketplaces for the getRateTables method

1.6.12021-03-10

Added a new programTypeEnum value to support Partner Motors Program sellers

1.6.02020-06-10

Added the kyc resource and the getKYC method to support eBay managed payments sellers

Show more

Marketing API

Release VersionRelease DateDescription of Release
1.24.02026-07-21

Promoted Listings: This release adds support for video preferences to Cost per Click campaigns.

1.23.22026-06-04
Added new error codes to support specific campaign-management scenarios for the createCampaign, cloneCampaign, pauseCampaign, updateCampaignIdentification, and updateAdRateStrategy methods.
1.23.12026-04-27
Promoted Listings: Promoted Listings with priority campaign strategy is now open to the public and is no longer restricted to approved users only.
1.23.02026-03-31
Promoted Listings: Decommissioned two methods from the campaign resource: setupQuickCampaign and launchCampaign.
1.22.42026-01-27
Promoted Listings: Add a new annotation key value and new metric key values to Promoted Listings reports.
1.22.32025-08-21
Promoted Listings: Added new annotation key values to Promoted Listings reports; expanded support for the sales_type dimension key for transaction reports .
1.22.22025-07-23
A new error message was added to createReportTask method to handle invalid dates in the date range filters.
1.22.12025-06-30
Added new error and warning codes to the UpdateCampaignBudget method to support new daily limit.
1.22.02024-07-16
Priority strategy campaign: Added new suggestMaxCpc method
1.21.22024-04-29
Promoted Listings Standard: Added support for auction listings for PLS campaigns on all marketplaces.
Show more

Logistics API

Release VersionRelease DateDescription of Release
1.0.0-beta2018-08-20

Initial release of the Logistics API.

Show more

VeRO API v2

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