Skip to main content

Inventory Mapping API

Release VersionRelease DateDescription of Release
1.0.02025-08-11
The initial version of the Inventory Mapping API

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.

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

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

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

Leads API

Release VersionRelease DateDescription of Release
1.0.02025-12-15

Initial release of Leads API

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.

Message API

Release VersionRelease DateDescription of Release
1.0.02025-11-03

Initial release of version 1.0.0

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

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: getExcludeShippingLocationsgetHandlingTimesgetShippingCarriersgetShippingLocations, 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: getCategoryPoliciesgetClassifiedAdPoliciesgetListingTypePoliciesgetMotorsListingPolicies, 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
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