Skip to main content

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 most recent releases for the Metadata API. For prior releases, refer to the Metadata API Release Notes Archive.

Version Release Date Summary of Release

Version 1.11.1

2025-07-17

The valueCategory boolean was added to the getCategoryPolicies response to indicate if the returned category is a value category.

Version 1.11.0

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

Version 1.10.0

2025-03-17

Six methods were added to the marketplace resource: getCategoryPolicies, getClassifiedAdPolicies, getListingTypePolicies, getMotorsListingPolicies, getShippingPolicies, and getSiteVisibilityPolicies

Version 1.9.0

2024-12-18

A new resource, compatibility,has been added, with five new methods to support parts compatibility features

Version 1.8.0

2024-07-09

Two methods were added to the marketplace resource: getProductSafetyLabels and getRegulatoryPolicies

Version 1.7.1

2023-08-29

In getExtendedProducerResponsibilityPolicies the Extended Producer Responsibility fields are now supported on all marketplaces

Version 1.7.0

2023-06-26

Expanded response payload for getItemConditionPolicies to support condition grading related information

Version 1.6.1

2023-06-22

Extended Producer Responsibility IDs are no longer set at the listing level

Version 1.6.0

2023-01-09

New Schema added to support hazardous material labels related information and repair score index

Version 1.5.0

2021-12-13

One new method was added to the marketplace resource: getExtendedProducerResponsibilityPolicies

Version 1.11.1

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

Schema changes

In this release, the valueCategory boolean has been added to the categoryPolicies container of the getCategoryPolicies response. If returned as true, this boolean indicates that the leaf category for the specified site is designated by eBay as a value category. Value categories can be used as a secondary category for a listing at no extra charge.

Version 1.11.0

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

Schema changes

The getCurrencies method that supports currency metadata was added to the marketplace resource. This method returns the default currency supported by the eBay system for the site specified in the request.

The getCategoryPolicies method now supports Global Trade Item Numbers (GTINs) metadata by adding three fields to the get_category_policies resource:

Note: GTINs are a set of globally recognized identifiers used to uniquely identify products.

  • eanSupport: Indicates whether or not European Article Numbers (EANs) are supported/required when listing products in the category.

  • isbnSupport: Indicates whether or not International Standard Book Numbers (ISBNs) are supported/required when listing products in the specified category.

  • upcSupport: Indicates whether or not the category on the specified eBay site supports the use of Universal Product Codes (UPCs) to help create a listing.

To support these fields, the enumerated type ProductIdentiferEnabledEnum was added. This type contains values to indicate whether or not the feature can be used or not, or is required or not.

The getMotorsListingPolicies method now provides additional compatibility metadata through two fields in the get_motors_listing_policies resource.

  • kTypeSupported: Indicates the category supports the use of a K Type to identify the cars and trucks compatible with a motor vehicle part or accessory. Only the AU, DE, ES, FR, IT, and UK marketplaces support the use of K Types.

  • minItemCompatibility: Indicates the minimum number of required compatible applications for listing items.

Version 1.10.0

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

Support for leaf category metadata added

This release adds support for that allows sellers to retrieve leaf category metadata for a site.

New methods

This release adds the following methods to the marketplace resource: 

Version 1.9.0

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

Support for compatibility search

This release adds a new resource, compatibility, that allows sellers to retrieve part compatibility details for a specific category, or for a specific product.

New methods

This release adds the following methods to the compatibility resource: 

Version 1.8.0

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

Two methods added

This release adds two new endpoints to the marketplace resource. The getProductSafetyLabels method retrieves available product safety label information for a given eBay marketplace. The getRegulatoryPolicies method allows users to retrieve all eBay categories that support/require regulatory policies data for a given eBay marketplace.

Version 1.7.1

The following section details the update that has been made for this release.

In getExtendedProducerResponsibilityPolicies method the Extended Producer Responsibility fields are now supported on all marketplaces. The following content is changed.

Note: Currently, the Extended Producer Responsibility policies are only applicable to a limited number of categories.

Version 1.7.0

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

Support for condition grading related information added

Sellers now have the ability to provide condition grading related information for items in applicable categories. The condition descriptors that an eBay category supports can be returned using the getItemConditionPolicies method.

Note: Condition grading is currently only available for the following trading card categories:

  • Non-Sport Trading Card Singles
  • CCG Individual Cards
  • Sports Trading Card Singles

Schema changes

The following container and its child fields are now available in the getItemConditionPolicies response payload:

  • conditionDescriptors- This container holds the information relating to condition descriptors and condition descriptor values for the specified category or categories.

Version 1.6.1

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

Extended Producer Responsibility IDs

Extended Producer Responsibility IDs are no longer set at the listing level so category-level metadata is no longer returned for PRODUCER_PRODUCT_ID, PRODUCT_DOCUMENTATION_ID, PRODUCT_PACKAGE_ID, and SHIPMENT_PACKAGE_ID. Sellers will provide/manage these IDs at the account level by going to Account Settings. These enumerated values were returned in the ExtendedProducerResponsibilityEnum type.

Version 1.6.0

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

Support for hazardous material labels related information added

Due to regulatory requirement changes, sellers now have the ability to provide hazardous material related information.

New methods

This release adds the getHazardousMaterialsLabels method to marketplace resource:

This new method returns hazardous materials label information for the specified eBay marketplace. The information includes IDs, descriptions, and URLs (as applicable) for the available signal words, statements, and pictograms.

Schema changes

The following containers and their child fields are available in the getHazardousMaterialsLabels response:

  • signalWords - This container consists of available signal words for hazardous materials for the specified marketplace.
  • statements - This container consists of available hazard statements for the specified marketplace.
  • pictograms - This container consists of available hazard pictograms for the specified marketplace.

Support for repair score index added

eBay is required to provide sellers the ability to specify the repair score index in certain categories and if the attribute is RECOMMENDED or REQUIRED. The repair score index describes how easy is it to repair the product.

Schema changes

The following enumerated values have been added to the getExtendedProducerResponsibilityPolicies response through extendedProducerResponsibilities.supportedAttributes:

  • REPAIR_SCORE - This enum value is used to identify the repair score attribute. Available through the name field.
  • RECOMMENDED - This enum value indicates that the attribute is recommended. Available through the usage field.

Version 1.5.0

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

New method added

This release adds a new endpoint to the marketplace resource. The getExtendedProducerResponsibilityPolicies method allows users to retrieve the Extended Producer Responsibility policies for one, multiple, or all eBay categories in an eBay marketplace.

Note: The Extended Producer Responsibility policies are currently only applicable to a limited number of categories, and only in the EBAY_FR marketplace.