Skip to main content

metadata APIv1.4.1

Metadata API release notes

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


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.4.1 2021-06-22 Expanded marketplace support for the marketplace resource
Version 1.4.0 2021-03-24 Enhanced the getItemConditionPolicies method to return the Certified Refurbished item condition for sellers who are eligible to list with that item condition
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.4.1

The following section details the updates that have been made for this release.

New marketplace support

This release expands the marketplace support for the marketplace resource. The marketplace resource methods now support the following marketplaces and locales:

  • EBAY_CA (fr-CA)
  • EBAY_BE (fr-BE)
  • EBAY_BE (nl-BE)

Tip: Refer to the Metadata API overview for a full list of supported marketplaces and locales.

Version 1.4.0

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

Schema changes

The scope was added to the getItemConditionPolicies method.

New Features

The getItemConditionPolicies method has been enhanced to retrieve the Certified Refurbished item condition (Condition ID 2000). For this item condition to be returned by the applicable categories, the seller must be eligible to list with the Certified Refurbished item condition, they must use a an OAuth token created with the authorization code grant flow and scope. See the getItemConditionPolicies reference document for more information.

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 resources and methods, see the Metadata API Reference.