metadata APIv1.3.0

Metadata API release notes

Just getting started with the Metadata API? See the following documents for details on using this API:

Announcements

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

The API release history

The following table lists the releases for the Metadata API:

Version Release Date Summary of Release
Version 1.3.0 2018-10-15 Expanded response payload for getReturnPolicies.
Version 1.2.0 2018-05-15 One new method added to the marketplace resource: getProductAdoptionPolicies
Version 1.1.0 2017-06-06 Five new methods added to the marketplace resource.
Version 1.0.0 2016-10-19 Initial release of Version 1.

Version 1.3.0

The following sections detail the updates that have been made for this release.

Schema changes

This release adds new response fields to the getReturnPolicies method. The response payload now includes the domestic and international complex fields which provide the guidelines for configuring domestic and international return policies for each eBay category. The new domestic and international fields each include the following policy fields:

  • policyDescriptionEnabled - A Boolean value that indicates whether or not a seller can populate the returnInstructions field for the associated return policy.
  • refundMethods - Defines the allowable refund methods.
  • returnMethods - Defines the allowable return methods.
  • returnPeriods - Defines the allowable periods of time you can configure for the time the buyer has to return an item.
  • returnsAcceptanceEnabled - Defines whether or not a seller accepts returns. While not endorsed by eBay, not accepting a return is a valid return policy.
  • returnShippingCostPayers - Defines the allowable values for specifying who pays for the return shipping (SELLER or BUYER). Note that the return shipping for SNAD-related items must always be paid for by the seller.

Version 1.2.0

The following sections detail the updates that have been made for this release.

New methods

This release adds one new method to marketplace resource:

This new method returns a list of leaf categories from the category tree of the specified marketplace. Each node in the response shows the policies that govern whether or not items listed in that category require an ePID value in their item descriptions. If productRequired equals true, then that category is governed by the product-adoption policies and you must include an ePID value in the body of any items you list in that category.

Version 1.1.0

This release introduces five new methods in the new marketplace resource.

API updates

This release contains several new methods that let you retrieve specific listing policies for a specified eBay marketplace. You can filter the response by category IDs:

New methods

Version 1.0.0

This is the initial release of the Metadata API, Version 1.

For a list of the new calls, see the Metadata API Reference.