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

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.22024-08-27

Added support for the Spanish and French marketplaces

1.5.22025-11-13

Added a new field, compatibilityCount, to the getProduct response

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.

1.19.52021-06-01

Added new Schema to support the return of VAT identifiers.

1.19.42021-05-10

Added new error code to the issueRefund method for seller-initiated refunds.

1.19.32021-01-15

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

1.19.22020-11-09

Updated the getOrder and getOrders methods to return a cumulative total of fees accrued that are deducted from seller payouts.

1.19.12020-10-21

Added a new enumeration value for the PostSaleAuthenticationProgram type.

1.19.02020-09-28

Added a tax address container (taxAddress) that consists of address information that can be used by sellers for tax purposes and affects the getOrder and getOrders methods.

1.18.02020-09-14

Added new schema to getPaymentDispute method to provide details on monetary transactions that occur after payment disputes are resolved. As part of this project, the getPaymentDispute method was also updated to show currency conversion values for cross-border trade orders.

1.17.02020-09-01

Updated api type names, added new BOPIS seller/merchant evidence type (PROOF_OF_PICKUP) for buyer to pick up items directly from the store, and corrections to documentation.

1.16.02020-08-24

Added support for the Authenticity Guarantee service program to the getOrder and getOrders methods. The Authenticity Guarantee service program informs the seller of the authentication status of an order as it passes through the item authentication process.

1.15.02020-07-09

Updated getOrder and getOrders methods to return selling fees that are deducted from seller payouts. Also, added a new PaymentMethodTypeEnum enumeration value.

1.14.02020-06-19

Added support for providing optional breakdown of taxes and fees to getOrder and getOrders methods.

1.13.02020-05-05

Five new payment method enums added to handle eBay managed payments and offline payment methods.

1.12.02020-03-31

Five new payment dispute methods for sellers opted in to eBay managed payments.

1.11.12020-01-17

New error code for the issueRefund method.

1.11.02019-10-30

Four new payment dispute methods for sellers opted in to eBay managed payments.

1.10.12019-10-24

Logic change for eBay 'Collect and Remit' taxes and two new error codes for the issueRefund method.

1.10.02019-08-08

getOrder and getOrders now return refundId values created with issueRefund method.

1.9.02019-06-24

New issueRefund method for sellers opted in to eBay managed payments.

1.8.02019-02-11

getOrder and getOrders now support In-Store Pickup orders.

1.7.02019-01-24

New field added to support Selling Manager order reference number

1.6.02018-10-09

New field to support items sold through ad campaign

1.5.02018-07-12

New types and fields to support AU import tax

1.4.02018-05-30

New fields to support legacy orders and email

1.3.02017-10-11

New field to support the Global Shipping Program; availability of OpenAPI specification

1.2.02017-06-12

New fields to support line item delivery timing

1.1.02017-01-25
Minor update
1.0.02017-10-19

Initial release of Version 1.0.0

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.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
1.7.12023-08-29
In getExtendedProducerResponsibilityPolicies the Extended Producer Responsibility fields are now supported on all marketplaces
1.7.02023-06-26
Expanded response payload for getItemConditionPolicies to support condition grading related information
1.6.12023-06-22
Extended Producer Responsibility IDs are no longer set at the listing level
1.6.02023-01-09
New Schema added to support hazardous material labels related information and repair score index
1.5.02021-12-13
One new method was added to the marketplace resource: getExtendedProducerResponsibilityPolicies
1.4.32021-11-30
The getProductAdoptionPolicies method was removed from the API
1.4.22021-09-01
A usage field was added under the itemConditions container to indicate item conditions that are only available for use by eligible sellers
1.4.12021-06-22
Expanded marketplace support for the marketplace resource
1.4.02021-03-24
Enhanced the getItemConditionPolicies method to return the Certified Refurbished item condition for sellers who are eligible to list with that item condition
1.3.02018-10-15
Expanded response payload for getReturnPolicies
1.2.02018-05-15
One new method added to the marketplace resource: getProductAdoptionPolicies
1.1.02017-06-06
Five new methods added to the marketplace resource
1.0.02016-10-19
Initial release of Version 1
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

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.

1.1.0-beta2021-10-06

Added video moderation functionality.

1.0.0-beta2021-04-29

Initial release of the Media 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

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.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.

1.17.42024-02-27

This release adds support for irregular shipping.

1.17.32024-02-05

This release adds support for required Economic Operator information.

1.17.22023-10-23

This release includes the following changes:

  • When listings are on hold due to policy violation then new boolean listingOnHold field is returned in getOffer/getOffers method. See the type Listing Details.
  • An official date January 22, 2024 is added to the note about revising single trading card listings with conditionDescriptors data. See the method creatorReplaceInventoryItem.
1.17.12023-08-29

Made changes to indicate that all DSA-related fields will become available on all eBay marketplaces, and is no longer restricted to just a couple of marketplaces.

1.17.02023-06-26

Added support for condition grading for select trading card categories.

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.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