Skip to main content

  • Important: Due to EU & UK Payments regulatory requirements, an additional security verification via Digital Signatures is required for certain API calls that are made by EU/UK sellers. Please refer to Digital Signatures for APIs to learn more on the impacted APIs and the process to create signature to be included in the HTTP payload.

  • OpenAPI Specification - Version 2.0 for all of our RESTful APIs will no longer be available starting April 5, 2023. We will continue leveraging OpenAPI Specification - Version 3.0 for new features in our RESTful APIs.

The Metadata API has operations that retrieve configuration details pertaining to the different eBay marketplaces. In addition to marketplace information, the API also has operations that get information that helps sellers list items on eBay.


Method NameHTTP MethodPathSummarySamples
getAutomotivePartsCompatibilityPoliciesGET/marketplace/{marketplace_id}/get_automotive_parts_compatibility_policiesReturns the eBay policies that define how to list automotive-parts-compatibility items in the categories of a specific marketplace.View getAutomotivePartsCompatibilityPolicies - /marketplace/{marketplace_id}/get_automotive_parts_compatibility_policies
getExtendedProducerResponsibilityPoliciesGET/marketplace/{marketplace_id}/get_extended_producer_responsibility_policiesReturns the Extended Producer Responsibility policies in the categories of a specific marketplace.View getExtendedProducerResponsibilityPolicies - /marketplace/{marketplace_id}/get_extended_producer_responsibility_policies
getHazardousMaterialsLabelsGET/marketplace/{marketplace_id}/get_hazardous_materials_labelsReturns the available hazardous materials label information of a specific marketplace.View getHazardousMaterialsLabels - /marketplace/{marketplace_id}/get_hazardous_materials_labels
getItemConditionPoliciesGET/marketplace/{marketplace_id}/get_item_condition_policiesReturns the eBay policies that define how to specify item conditions in the categories of a specific marketplace.View getItemConditionPolicies - /marketplace/{marketplace_id}/get_item_condition_policies
getListingStructurePoliciesGET/marketplace/{marketplace_id}/get_listing_structure_policiesReturns the eBay policies that define the allowed listing structures (i.e. whether item variations are supported) for the categories of a specific marketplace.View getListingStructurePolicies - /marketplace/{marketplace_id}/get_listing_structure_policies
getNegotiatedPricePoliciesGET/marketplace/{marketplace_id}/get_negotiated_price_policiesReturns the eBay policies that define the supported negotiated price features (like "best offer") for the categories of a specific marketplace.View getNegotiatedPricePolicies - /marketplace/{marketplace_id}/get_negotiated_price_policies
getReturnPoliciesGET/marketplace/{marketplace_id}/get_return_policiesReturns the eBay policies that define whether or not you must include a return policy for the items you list in the categories of a specific marketplace and the guidelines for creating domestic and international return policies in different categories.View getReturnPolicies - /marketplace/{marketplace_id}/get_return_policies


Method NameHTTP MethodPathSummarySamples
getSalesTaxJurisdictionsGET/country/{countryCode}/sales_tax_jurisdictionRetrieves sales tax jurisdictions for the countries with tax jurisdictions: CA and US.View getSalesTaxJurisdictions - /country/{countryCode}/sales_tax_jurisdiction