{"files":{"SKILL.md":"---\nname: metadata-api\ndescription: \"Metadata API skill. Use when working with Metadata for marketplace, compatibilities, shipping. Covers 27 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Metadata API\nAPI version: v1.12.1\n\n## Auth\nOAuth2\n\n## Base URL\nhttps://api.ebay.com/sell/metadata/v1\n\n## Setup\n1. Configure auth: OAuth2\n2. GET /marketplace/{marketplace_id}/get_automotive_parts_compatibility_policies -- this method returns the ebay policies that define how to list automotive parts compatibility items in the categories of the specified marketplace.  by default, this method returns all categories that support parts compatibility. you can limit the size of the result set by using the filter query parameter to specify only the category ids you want to review.note: to return policy information for the ebay us marketplace, specify ebay_motors_us as the path parameter for marketplace_id.tip: this method can potentially return a very large response payload. ebay recommends that the response payload be compressed by passing in the accept-encoding request header and setting the value to gzip.if you specify a valid marketplace id but that marketplace does not contain policy information, or if you filter out all results, a 204 no content status code is returned with an empty response body.\n3. POST /compatibilities/get_compatibilities_by_specification -- create first get_compatibilities_by_specification\n\n## Endpoints\n27 endpoints across 4 groups. See references/api-spec.lap for full details.\n\n### Marketplace\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /marketplace/{marketplace_id}/get_automotive_parts_compatibility_policies | This method returns the eBay policies that define how to list automotive parts compatibility items in the categories of the specified marketplace.  By default, this method returns all categories that support parts compatibility. You can limit the size of the result set by using the filter query parameter to specify only the category IDs you want to review.Note: To return policy information for the eBay US marketplace, specify EBAY_MOTORS_US as the path parameter for marketplace_id.Tip: This method can potentially return a very large response payload. eBay recommends that the response payload be compressed by passing in the Accept-Encoding request header and setting the value to gzip.If you specify a valid marketplace ID but that marketplace does not contain policy information, or if you filter out all results, a 204 No content status code is returned with an empty response body. |\n| GET | /marketplace/{marketplace_id}/get_category_policies | This method returns eBay category policy metadata for all leaf categories on the specified marketplace.By default, this method returns metadata on all leaf categories. You can limit the size of the result set by using the filter query parameter to specify only the leaf category IDs you want to review.If you specify a valid marketplace ID but that marketplace does not contain policy information, or if you filter out all results, a successful call returns a 204 No content status code with an empty response body. |\n| GET | /marketplace/{marketplace_id}/get_classified_ad_policies | This method returns eBay classified ad policy metadata for all leaf categories on the specified marketplace.By default, this method returns metadata on all leaf categories. You can limit the size of the result set by using the filter query parameter to specify only the leaf category IDs you want to review.If you specify a valid marketplace ID but that marketplace does not contain policy information, or if you filter out all results, a successful call returns a 204 No content status code with an empty response body.Note: This method does not support classified ads for eBay US Motors categories (EBAY_MOTORS_US). For eBay Motors Pro users, use getMotorsListingPolicies. |\n| GET | /marketplace/{marketplace_id}/get_currencies | This method returns the default currency used by the eBay marketplace specified in the request. This is the currency that the seller should use when providing price data for this marketplace through listing APIs. |\n| GET | /marketplace/{marketplace_id}/get_extended_producer_responsibility_policies | This method returns the Extended Producer Responsibility policies for one, multiple, or all eBay categories in an eBay marketplace.The identifier of the eBay marketplace is passed in as a path parameter, and unless one or more eBay category IDs are passed in through the filter query parameter, this method will return metadata on every applicable category for the specified marketplace.Note: Currently, the Extended Producer Responsibility policies are only applicable to a limited number of categories.Note: Extended Producer Responsibility IDs are no longer set at the listing level so category-level metadata is no longer returned. Instead, sellers will provide/manage these IDs at the account level by going to Account Settings.Tip: This method can potentially return a very large response payload. eBay recommends that the response payload be compressed by passing in the Accept-Encoding request header and setting the value to gzip. |\n| GET | /marketplace/{marketplace_id}/get_hazardous_materials_labels | This 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. The returned statements are localized for the default language of the marketplace. If a marketplace does not support hazardous materials label information, no response payload is returned, but only a 204 No content status code.This information is used by the seller to add hazardous materials label related information to their listings (see Specifying hazardous material related information). |\n| GET | /marketplace/{marketplace_id}/get_item_condition_policies | This method returns item condition metadata on one, multiple, or all eBay categories on an eBay marketplace. This metadata consists of the different item conditions (with IDs) that an eBay category supports, and a boolean to indicate if an eBay category requires an item condition. If applicable, this metadata also shows the different condition descriptors (with IDs) that an eBay category supports.Note: Currently, condition grading is only applicable to the following trading card categories: Non-Sport Trading Card SinglesCCG Individual CardsSports Trading Cards SinglesThe identifier of the eBay marketplace is passed in as a path parameter, and unless one or more eBay category IDs are passed in through the filter query parameter, this method will return metadata on every single category for the specified marketplace. If you only want to view item condition metadata for one eBay category or a select group of eBay categories, you can pass in up to 50 eBay category ID through the filter query parameter.Important: Certified - Refurbished-eligible sellers, and sellers who are eligible to list with the new values (EXCELLENT_REFURBISHED, VERY_GOOD_REFURBISHED, and GOOD_REFURBISHED) must use an OAuth token created with the authorization code grant flow and https://api.ebay.com/oauth/api_scope/sell.inventory scope in order to retrieve the refurbished conditions for the relevant categories.Refurbished item conditions are only supported in the Australia, Canada, French Canada, Germany, France, Italy, UK, and US marketplaces. See the eBay Refurbished Program page in help center for the categories that support refurbished conditions. These restricted item conditions will not be returned if an OAuth token created with the client credentials grant flow and https://api.ebay.com/oauth/api_scope scope is used, or if any seller is not eligible to list with that item condition.  See the Specifying OAuth scopes topic for more information about specifying scopes.Tip: This method can potentially return a very large response payload. eBay recommends that the response payload be compressed by passing in the Accept-Encoding request header and setting the value to gzip. |\n| GET | /marketplace/{marketplace_id}/get_listing_structure_policies | This method returns the eBay policies that define the allowed listing structures for the categories of a specific marketplace. The listing-structure policies currently pertain to whether or not you can list items with variations.  By default, this method returns the entire category tree for the specified marketplace. You can limit the size of the result set by using the filter query parameter to specify only the category IDs you want to review.Tip: This method can potentially return a very large response payload. eBay recommends that the response payload be compressed by passing in the Accept-Encoding request header and setting the value to gzip. |\n| GET | /marketplace/{marketplace_id}/get_listing_type_policies | This method returns eBay listing type policy metadata for all leaf categories on the specified marketplace. By default, this method returns metadata on all leaf categories. You can limit the size of the result set by using the filter query parameter to specify only the leaf category IDs you want to review.If you specify a valid marketplace ID but that marketplace does not contain policy information, or if you filter out all results, a successful call returns a 204 No content status code with an empty response body. |\n| GET | /marketplace/{marketplace_id}/get_motors_listing_policies | This method returns eBay Motors policy metadata for all leaf categories on the specified marketplace. By default, this method returns metadata on all leaf categories. You can limit the size of the result set by using the filter query parameter to specify only the leaf category IDs you want to review.If you specify a valid marketplace ID but that marketplace does not contain policy information, or if you filter out all results, a successful call returns a 204 No content status code with an empty response body.Note: To return policy information for eBay US Motors categories, specify marketplace_id as EBAY_MOTORS_US. |\n| GET | /marketplace/{marketplace_id}/get_negotiated_price_policies | This method returns the eBay policies that define the supported negotiated price features (like \"best offer\") for the categories of a specific marketplace.  By default, this method returns the entire category tree for the specified marketplace. You can limit the size of the result set by using the filter query parameter to specify only the category IDs you want to review.Tip: This method can potentially return a very large response payload. eBay recommends that the response payload be compressed by passing in the Accept-Encoding request header and setting the value to gzip. |\n| GET | /marketplace/{marketplace_id}/get_product_safety_labels | This method returns product safety label information for the specified eBay marketplace. The information includes IDs, descriptions, and URLs (as applicable) for the available statements and pictograms. The returned statements are localized for the default language of the marketplace. If a marketplace does not support product safety label information, no response payload is returned, but only a 204 No content status code.This information is used by the seller to add product safety label related information to their listings. The getRegulatoryPolicies method can be used to see which categories recommend or require product safety labels. |\n| GET | /marketplace/{marketplace_id}/get_regulatory_policies | This method returns regulatory policies for one, multiple, or all eBay categories in an eBay marketplace. The identifier of the eBay marketplace is passed in as a path parameter, and unless one or more eBay category IDs are passed in through the filter query parameter, this method will return metadata for every listing category in the specified marketplace.Tip: This method can potentially return a very large response payload. eBay recommends that the response payload be compressed by passing in the Accept-Encoding request header and setting the value to gzip. |\n| GET | /marketplace/{marketplace_id}/get_return_policies | This method returns 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, plus the guidelines for creating domestic and international return policies in the different eBay categories.  By default, this method returns the entire category tree for the specified marketplace. You can limit the size of the result set by using the filter query parameter to specify only the category IDs you want to review.Tip: This method can potentially return a very large response payload. eBay recommends that the response payload be compressed by passing in the Accept-Encoding request header and setting the value to gzip. |\n| GET | /marketplace/{marketplace_id}/get_shipping_policies | This method returns eBay shipping policy metadata for all leaf categories on the specified marketplace.By default, this method returns metadata on all leaf categories. You can limit the size of the result set by using the filter query parameter to specify only the leaf category IDs you want to review.If you specify a valid marketplace ID but that marketplace does not contain policy information, or if you filter out all results, a successful call returns a 204 No content status code with an empty response body. |\n| GET | /marketplace/{marketplace_id}/get_site_visibility_policies | This method returns eBay international site visibility policy metadata for all leaf categories on the specified marketplace.By default, this method returns metadata on all leaf categories. You can limit the size of the result set by using the filter query parameter to specify only the leaf category IDs you want to review.If you specify a valid marketplace ID but that marketplace does not contain policy information, or if you filter out all results, a successful call returns a 204 No content status code with an empty response body. |\n\n### Compatibilities\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /compatibilities/get_compatibilities_by_specification | This method is used to retrieve all compatible application name-value pairs for a part based on the provided specification(s).The part's relevant dimensions and/or characteristics can be provided through the specifications container. For example, when retrieving compatible application name-value pairs for a tire, the tire's dimensions (such as the section width or rim diameter) should be provided.By default, all compatible application name-value pairs for the specifications are returned. You can limit the size of the result set by using the compatibilityPropertyFilters array to specify the properties (such as make, model, year, or trim) you wish to be included in the response.Note: The getCompatibilityPropertyNames and getCompatibilityPropertyValues methods can be used to retrieve valid property names and values that can be used as the name-value pairs to define specifications. |\n| POST | /compatibilities/get_compatibility_property_names | This method is used to retrieve product compatibility property names for the specified compatibility-enabled category.Compatibility property names can be used alongside the corresponding compatibility property value (retrieved using the getCompatibilityPropertyValues method) to describe the assembly for which an item is compatible.The categoryId of the compatibility-enabled category for which to retrieve compatibility property names is required in the request body.By default, all property names within the compatibility category of the specified compatibility-enable category are returned. You can limit the size of the result set by using the dataset array to specify the types of properties you want returned. |\n| POST | /compatibilities/get_compatibility_property_values | This method is used to retrieve product compatibility property values associated with a single property name, in the specified category.Compatibility property values can be used alongside the corresponding compatibility property name (retrieved using the getCompatibilityPropertyNames method) to describe the assembly for which an item is compatible.The categoryId of the compatibility-enabled category for which to retrieve compatibility property values is required in the request body, as well as the propertyName for which you wish to retrieve associated values.By default, all property values associated with the specified propertyName are returned. You can limit the size of the result set by using the propertyFilter array. Only property values associated with the specified name-value pairs will be returned. |\n| POST | /compatibilities/get_multi_compatibility_property_values | This method is used to retrieve product compatibility property values associated with multiple property names, in the specified category.Compatibility property values can be used alongside the corresponding compatibility property name (retrieved using the getCompatibilityPropertyNames method) to describe the assembly for which an item is compatible.The categoryId of the compatibility-enabled category for which to retrieve compatibility property values is required in the request body, as well as the propertyNames for which you wish to retrieve associated property values. The propertyFilter array is also required to constrain the output. Only property values associated with the specified name-value pairs will be returned. |\n| POST | /compatibilities/get_product_compatibilities | This method is used to retrieve all available item compatibility details for the specified product.Item compatibility details can be used to see the properties for which an item is compatible. For example, if you are searching for a part for a specific vehicle, you can use this method to see the years, engine, and/or trim for which the part is compatible. Item compatibility details are returned as name-value pairs.The product for which to retrieve item compatibility details must be provided through the productIdentifier field. This value can be either an eBay specific identifier (such as an ePID) or an external identifier (such as a UPC).By default, all available item compatibility details for the specified product are returned. You can limit the size of the result set using the dataset or datasetPropertyName fields to specify the types of properties you want returned in the response. The applicationPropertyFilter array can also be used so that only parts compatible with the specified name-value pairs are returned. |\n\n### Shipping\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /shipping/marketplace/{marketplace_id}/get_exclude_shipping_locations | This method retrieves a list of locations that the seller can use as excluded shipping locations within their listings or in their fulfillment business policies for the specified marketplace. These are locations that a seller designates as areas where they will not ship items. Excluded shipping locations and ship-to locations are used in tandem at the listing level and in fulfillment business policies. Excluded shipping locations and ship-to locations share a lot of the same values and they should not contradict each other.Manage excluded shipping locations using business policies through the fulfillment_policy resource of the Account v1 API. |\n| GET | /shipping/marketplace/{marketplace_id}/get_handling_times | This method retrieves a list of supported handling times for the specified marketplace. The handling time returned specifies the maximum number of business days the eBay site allows for shipping an item to domestic buyers after receiving a cleared payment. Handling times apply to both domestic and international orders. If the handling time is 1 day, the seller commits to dropping the item off for shipment one business day after payment clears. Manage handing times using business policies through the fulfillment_policy resource of the Account v1 API. |\n| GET | /shipping/marketplace/{marketplace_id}/get_shipping_carriers | This method retrieves a list of supported shipping carriers for the specified marketplace. It provides essential information for sellers to understand which shipping carriers are available for use when listing items on that eBay marketplace. Knowing the supported carriers can help sellers optimize their shipping options and ensure efficient delivery to buyers.The value returned in the shippingCarrier field is the enumerated value required when providing shipment tracking information for that carrier.Tip:  Use the getShippingServices method to explore available shipping services for each carrier.Manage shipping carriers using business policies through the fulfillment_policy resource of the Account v1 API. |\n| GET | /shipping/marketplace/{marketplace_id}/get_shipping_locations | This method retrieves a list of supported shipping locations for the specified marketplace. It provides sellers with information on where they can ship their items. Sellers can use this information to configure their shipping settings. Tip:  Use the getExcludeShippingLocations method to return locations where the seller does not ship.Manage shipping locations using business policies through the fulfillment_policy resource of the Account v1 API. |\n| GET | /shipping/marketplace/{marketplace_id}/get_shipping_services | This method retrieves a list of shipping services supported for the specified marketplace, including valid shipping services, shipping times, and package constraints such as size and weight.Manage shipping services using business policies through the fulfillment_policy resource of the Account v1 API. |\n\n### Country\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /country/{countryCode}/sales_tax_jurisdiction | This method retrieves all sales-tax jurisdictions for the country specified in the countryCode path parameter. Countries with valid sales-tax jurisdictions are Canada and the US.The response from this call tells you the jurisdictions for which a seller can configure tax tables. Although setting up tax tables is optional, you can use the createOrReplaceSalesTax method in the Account API call to configure the tax tables for the jurisdictions into which you sell.Note: Sales-tax tables are only available for the US (EBAY_US) and Canada (EBAY_CA) marketplaces.Important! \">Important! In the US, eBay now calculates, collects, and remits sales tax to the proper taxing authorities in all 50 states and Washington, DC. Sellers can no longer specify sales-tax rates for these jurisdictions using a tax table.However, sellers may continue to use a sales-tax table to set rates for the following US territories:American Samoa (AS)Guam (GU)Northern Mariana Islands (MP)Palau (PW)US Virgin Islands (VI)For additional information, refer to Taxes and import charges. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all get_automotive_parts_compatibility_policies?\" -> GET /marketplace/{marketplace_id}/get_automotive_parts_compatibility_policies\n- \"List all get_category_policies?\" -> GET /marketplace/{marketplace_id}/get_category_policies\n- \"List all get_classified_ad_policies?\" -> GET /marketplace/{marketplace_id}/get_classified_ad_policies\n- \"List all get_currencies?\" -> GET /marketplace/{marketplace_id}/get_currencies\n- \"List all get_extended_producer_responsibility_policies?\" -> GET /marketplace/{marketplace_id}/get_extended_producer_responsibility_policies\n- \"List all get_hazardous_materials_labels?\" -> GET /marketplace/{marketplace_id}/get_hazardous_materials_labels\n- \"List all get_item_condition_policies?\" -> GET /marketplace/{marketplace_id}/get_item_condition_policies\n- \"List all get_listing_structure_policies?\" -> GET /marketplace/{marketplace_id}/get_listing_structure_policies\n- \"List all get_listing_type_policies?\" -> GET /marketplace/{marketplace_id}/get_listing_type_policies\n- \"List all get_motors_listing_policies?\" -> GET /marketplace/{marketplace_id}/get_motors_listing_policies\n- \"List all get_negotiated_price_policies?\" -> GET /marketplace/{marketplace_id}/get_negotiated_price_policies\n- \"List all get_product_safety_labels?\" -> GET /marketplace/{marketplace_id}/get_product_safety_labels\n- \"List all get_regulatory_policies?\" -> GET /marketplace/{marketplace_id}/get_regulatory_policies\n- \"List all get_return_policies?\" -> GET /marketplace/{marketplace_id}/get_return_policies\n- \"List all get_shipping_policies?\" -> GET /marketplace/{marketplace_id}/get_shipping_policies\n- \"List all get_site_visibility_policies?\" -> GET /marketplace/{marketplace_id}/get_site_visibility_policies\n- \"Create a get_compatibilities_by_specification?\" -> POST /compatibilities/get_compatibilities_by_specification\n- \"Create a get_compatibility_property_name?\" -> POST /compatibilities/get_compatibility_property_names\n- \"Create a get_compatibility_property_value?\" -> POST /compatibilities/get_compatibility_property_values\n- \"Create a get_multi_compatibility_property_value?\" -> POST /compatibilities/get_multi_compatibility_property_values\n- \"Create a get_product_compatibility?\" -> POST /compatibilities/get_product_compatibilities\n- \"List all get_exclude_shipping_locations?\" -> GET /shipping/marketplace/{marketplace_id}/get_exclude_shipping_locations\n- \"List all get_handling_times?\" -> GET /shipping/marketplace/{marketplace_id}/get_handling_times\n- \"List all get_shipping_carriers?\" -> GET /shipping/marketplace/{marketplace_id}/get_shipping_carriers\n- \"List all get_shipping_locations?\" -> GET /shipping/marketplace/{marketplace_id}/get_shipping_locations\n- \"List all get_shipping_services?\" -> GET /shipping/marketplace/{marketplace_id}/get_shipping_services\n- \"List all sales_tax_jurisdiction?\" -> GET /country/{countryCode}/sales_tax_jurisdiction\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\n- Error responses include status codes and descriptions in the spec\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Metadata API\n@base https://api.ebay.com{basePath}\n@version v1.12.1\n@auth OAuth2\n@endpoints 27\n@hint download_for_search\n@toc marketplace(16), compatibilities(5), shipping(5), country(1)\n\n@group marketplace\n@endpoint GET /marketplace/{marketplace_id}/get_automotive_parts_compatibility_policies\n@desc This method returns the eBay policies that define how to list automotive parts compatibility items in the categories of the specified marketplace.  By default, this method returns all categories that support parts compatibility. You can limit the size of the result set by using the filter query parameter to specify only the category IDs you want to review.Note: To return policy information for the eBay US marketplace, specify EBAY_MOTORS_US as the path parameter for marketplace_id.Tip: This method can potentially return a very large response payload. eBay recommends that the response payload be compressed by passing in the Accept-Encoding request header and setting the value to gzip.If you specify a valid marketplace ID but that marketplace does not contain policy information, or if you filter out all results, a 204 No content status code is returned with an empty response body.\n@required {marketplace_id: str # This path parameter specifies the eBay marketplace for which policy information is retrieved.  Note: Only the following eBay marketplaces support automotive parts compatibility:  EBAY_MOTORS_US EBAY_AU EBAY_CA EBAY_DE EBAY_ES EBAY_FR EBAY_GB EBAY_IT}\n@optional {filter: str # This query parameter limits the response by returning policy information for only the selected sections of the category tree. Supply categoryId values for the sections of the tree you want returned. Use the Taxonomy API to retrieve category ID values.The parameter takes a list of categoryId values and you can specify up to 50 separate category IDs. Separate multiple values with a pipe character ('|'). If you specify more than 50 categoryId values, eBay returns the policies for the first 50 IDs and a warning that not all categories were returned.  Example: filter=categoryIds:{183521|183523|183524}  Note: URL-encoding of the parameter list is no longer required., Accept-Encoding: str # This header indicates the compression-encoding algorithms the client accepts for the response. This value should be set to gzip.  For more information, refer to HTTP request headers.}\n@returns(200) {automotivePartsCompatibilityPolicies: [map], warnings: [map]} # Success\n@returns(204) No content\n@errors {400: Bad Request, 404: Not found, 500: Internal Server Error}\n\n@endpoint GET /marketplace/{marketplace_id}/get_category_policies\n@desc This method returns eBay category policy metadata for all leaf categories on the specified marketplace.By default, this method returns metadata on all leaf categories. You can limit the size of the result set by using the filter query parameter to specify only the leaf category IDs you want to review.If you specify a valid marketplace ID but that marketplace does not contain policy information, or if you filter out all results, a successful call returns a 204 No content status code with an empty response body.\n@required {marketplace_id: str # This path parameter specifies the eBay marketplace for which policy information is retrieved.See HTTP Request Headers for a list of supported eBay marketplace ID values.}\n@optional {filter: str # This query parameter limits the response by only returning metadata for the specified leaf categories. Supply the categoryId for one or more leaf categories. You can verify if a category is a leaf category by using the Taxonomy API and looking for a \"leafCategory\": true tag.  The parameter takes a list of categoryId values and you can specify up to 50 separate category IDs. Separate multiple values with a pipe character ('|'). If you specify more than 50 categoryId values, eBay returns the policies for the first 50 IDs and a warning that not all categories were returned.Example: filter=categoryIds:{3767|171784}, Accept-Language: str # This header is required to retrieve metadata for the French Canada, French Belgium, and Dutch Belgium marketplaces.Follow the instructions below to retrieve metadata for these three marketplaces:French Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of fr-BE.Dutch Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of nl-BE.French Canada: Set the marketplace_id path parameter value to EBAY_CA, and include the Accept-Language header with a value of fr-CA.Note: If EBAY_CA is set as the marketplace_id path parameter and the Accept-Language header is not used, the marketplace will default to the English Canada marketplace.}\n@returns(200) {categoryPolicies: [map], warnings: [map]} # Success\n@returns(204) No content\n@errors {400: Bad Request, 404: Not found, 500: Internal Server Error}\n\n@endpoint GET /marketplace/{marketplace_id}/get_classified_ad_policies\n@desc This method returns eBay classified ad policy metadata for all leaf categories on the specified marketplace.By default, this method returns metadata on all leaf categories. You can limit the size of the result set by using the filter query parameter to specify only the leaf category IDs you want to review.If you specify a valid marketplace ID but that marketplace does not contain policy information, or if you filter out all results, a successful call returns a 204 No content status code with an empty response body.Note: This method does not support classified ads for eBay US Motors categories (EBAY_MOTORS_US). For eBay Motors Pro users, use getMotorsListingPolicies.\n@required {marketplace_id: str # This path parameter specifies the eBay marketplace for which policy information is retrieved.See MarketplaceIdEnum for a list of supported eBay marketplace ID values.}\n@optional {filter: str # This query parameter limits the response by only returning metadata for the specified leaf categories. Supply the categoryId for one or more leaf categories. You can verify if a category is a leaf category by using the Taxonomy API and looking for a \"leafCategory\": true tag.   The parameter takes a list of categoryId values and you can specify up to 50 separate category IDs. Separate multiple values with a pipe character ('|'). If you specify more than 50 categoryId values, eBay returns the policies for the first 50 IDs and a warning that not all categories were returned.Example:filter=categoryIds:{3767|171784}, Accept-Language: str # This header is required to retrieve metadata for the French Canada, French Belgium, and Dutch Belgium marketplaces.Follow the instructions below to retrieve metadata for these three marketplaces:French Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of fr-BE.Dutch Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of nl-BE.French Canada: Set the marketplace_id path parameter value to EBAY_CA, and include the Accept-Language header with a value of fr-CA.Note: If EBAY_CA is set as the marketplace_id path parameter and the Accept-Language header is not used, the marketplace will default to the English Canada marketplace.}\n@returns(200) {classifiedAdPolicies: [map], warnings: [map]} # Success\n@returns(204) No content\n@errors {400: Bad Request, 404: Not found, 500: Internal Server Error}\n\n@endpoint GET /marketplace/{marketplace_id}/get_currencies\n@desc This method returns the default currency used by the eBay marketplace specified in the request. This is the currency that the seller should use when providing price data for this marketplace through listing APIs.\n@required {marketplace_id: str # This path parameter specifies the eBay marketplace for which currency information is retrieved.See the MarketplaceIdEnum type for a list of supported eBay marketplace ID values.}\n@optional {Accept-Language: str # This header is required to retrieve metadata for the French Canada and French Belgium marketplaces.Follow the instructions below to retrieve metadata for these marketplaces:French Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of fr-BE.Note: If EBAY_BE is set as the marketplace_id path parameter and the Accept-Language header is not used, the marketplace will default to the Dutch Belgium marketplace.French Canada: Set the marketplace_id path parameter value to EBAY_CA and include the Accept-Language header with a value of fr-CA.Note: If EBAY_CA is set as the marketplace_id path parameter and the Accept-Language header is not used, the marketplace will default to the English Canada marketplace.}\n@returns(200) {defaultCurrency: map{code: str, description: str}, marketplaceId: str} # Success\n@returns(204) No Content\n@errors {400: Bad Request, 404: Not Found, 500: Internal Server Error}\n\n@endpoint GET /marketplace/{marketplace_id}/get_extended_producer_responsibility_policies\n@desc This method returns the Extended Producer Responsibility policies for one, multiple, or all eBay categories in an eBay marketplace.The identifier of the eBay marketplace is passed in as a path parameter, and unless one or more eBay category IDs are passed in through the filter query parameter, this method will return metadata on every applicable category for the specified marketplace.Note: Currently, the Extended Producer Responsibility policies are only applicable to a limited number of categories.Note: Extended Producer Responsibility IDs are no longer set at the listing level so category-level metadata is no longer returned. Instead, sellers will provide/manage these IDs at the account level by going to Account Settings.Tip: This method can potentially return a very large response payload. eBay recommends that the response payload be compressed by passing in the Accept-Encoding request header and setting the value to gzip.\n@required {marketplace_id: str # This path parameter specifies the eBay marketplace for which policy information shall be retrieved.See HTTP Request Headers for a list of supported eBay marketplace ID values.}\n@optional {filter: str # A query parameter that can be used to limit the response by returning policy information for only the selected sections of the category tree. Supply categoryId values for the sections of the tree that should be returned.When a categoryId value is specified, the returned category tree includes the policies for that parent node, as well as the policies for any child nodes below that parent node.Pass in the categoryId values using a URL-encoded, pipe-separated ('|') list. For example:filter=categoryIds%3A%7B100%7C101%7C102%7DMaximum: 50, Accept-Encoding: str # This header indicates the compression-encoding algorithms the client accepts for the response. This value should be set to gzip.  For more information, refer to HTTP request headers., Accept-Language: str # This header is required to retrieve metadata for the French Canada, French Belgium, and Dutch Belgium marketplaces.Follow the instructions below to retrieve metadata for these three marketplaces:French Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of fr-BE.Dutch Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of nl-BE.French Canada: Set the marketplace_id path parameter value to EBAY_CA, and include the Accept-Language header with a value of fr-CA.Note: If EBAY_CA is set as the marketplace_id path parameter and the Accept-Language header is not used, the marketplace will default to the English Canada marketplace.}\n@returns(200) {extendedProducerResponsibilities: [map], warnings: [map]} # Success\n@returns(204) No content\n@errors {400: Bad Request, 404: Not found, 500: Internal Server Error}\n\n@endpoint GET /marketplace/{marketplace_id}/get_hazardous_materials_labels\n@desc This 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. The returned statements are localized for the default language of the marketplace. If a marketplace does not support hazardous materials label information, no response payload is returned, but only a 204 No content status code.This information is used by the seller to add hazardous materials label related information to their listings (see Specifying hazardous material related information).\n@required {marketplace_id: str # This path parameter specifies the eBay marketplace for which hazardous materials label information shall be retrieved.See HTTP Request Headers for a list of supported eBay marketplace ID values.}\n@optional {Accept-Language: str # This header is required to retrieve metadata for the French Canada, French Belgium, and Dutch Belgium marketplaces.Follow the instructions below to retrieve metadata for these three marketplaces:French Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of fr-BE.Dutch Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of nl-BE.French Canada: Set the marketplace_id path parameter value to EBAY_CA, and include the Accept-Language header with a value of fr-CA.Note: If EBAY_CA is set as the marketplace_id path parameter and the Accept-Language header is not used, the marketplace will default to the English Canada marketplace.}\n@returns(200) {signalWords: [map], statements: [map], pictograms: [map]} # Success\n@returns(204) No content\n@errors {400: Bad Request, 404: Not found, 500: Internal Server Error}\n\n@endpoint GET /marketplace/{marketplace_id}/get_item_condition_policies\n@desc This method returns item condition metadata on one, multiple, or all eBay categories on an eBay marketplace. This metadata consists of the different item conditions (with IDs) that an eBay category supports, and a boolean to indicate if an eBay category requires an item condition. If applicable, this metadata also shows the different condition descriptors (with IDs) that an eBay category supports.Note: Currently, condition grading is only applicable to the following trading card categories: Non-Sport Trading Card SinglesCCG Individual CardsSports Trading Cards SinglesThe identifier of the eBay marketplace is passed in as a path parameter, and unless one or more eBay category IDs are passed in through the filter query parameter, this method will return metadata on every single category for the specified marketplace. If you only want to view item condition metadata for one eBay category or a select group of eBay categories, you can pass in up to 50 eBay category ID through the filter query parameter.Important: Certified - Refurbished-eligible sellers, and sellers who are eligible to list with the new values (EXCELLENT_REFURBISHED, VERY_GOOD_REFURBISHED, and GOOD_REFURBISHED) must use an OAuth token created with the authorization code grant flow and https://api.ebay.com/oauth/api_scope/sell.inventory scope in order to retrieve the refurbished conditions for the relevant categories.Refurbished item conditions are only supported in the Australia, Canada, French Canada, Germany, France, Italy, UK, and US marketplaces. See the eBay Refurbished Program page in help center for the categories that support refurbished conditions. These restricted item conditions will not be returned if an OAuth token created with the client credentials grant flow and https://api.ebay.com/oauth/api_scope scope is used, or if any seller is not eligible to list with that item condition.  See the Specifying OAuth scopes topic for more information about specifying scopes.Tip: This method can potentially return a very large response payload. eBay recommends that the response payload be compressed by passing in the Accept-Encoding request header and setting the value to gzip.\n@required {marketplace_id: str # This path parameter specifies the eBay marketplace for which policy information is retrieved.See HTTP Request Headers for a list of supported eBay marketplace ID values.}\n@optional {filter: str # This query parameter limits the response by returning policy information for only the selected sections of the category tree. Supply categoryId values for the sections of the tree you want returned.  When you specify a categoryId value, the returned category tree includes the policies for that parent node, plus the policies for any leaf nodes below that parent node.  The parameter takes a list of categoryId values and you can specify up to 50 separate category IDs. Separate multiple values with a pipe character ('|'). If you specify more than 50 categoryId values, eBay returns the policies for the first 50 IDs and a warning that not all categories were returned.  Example: filter=categoryIds:{100|101|102}  Note that you must URL-encode the parameter list, which results in the following filter for the above example:    filter=categoryIds%3A%7B100%7C101%7C102%7D, Accept-Encoding: str # This header indicates the compression-encoding algorithms the client accepts for the response. This value should be set to gzip.  For more information, refer to HTTP request headers., Accept-Language: str # This header is required to retrieve metadata for the French Canada, French Belgium, and Dutch Belgium marketplaces.Follow the instructions below to retrieve metadata for these three marketplaces:French Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of fr-BE.Dutch Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of nl-BE.French Canada: Set the marketplace_id path parameter value to EBAY_CA, and include the Accept-Language header with a value of fr-CA.Note: If EBAY_CA is set as the marketplace_id path parameter and the Accept-Language header is not used, the marketplace will default to the English Canada marketplace.}\n@returns(200) {itemConditionPolicies: [map], warnings: [map]} # Success\n@returns(204) No content\n@errors {400: Bad Request, 404: Not found, 500: Internal Server Error}\n\n@endpoint GET /marketplace/{marketplace_id}/get_listing_structure_policies\n@desc This method returns the eBay policies that define the allowed listing structures for the categories of a specific marketplace. The listing-structure policies currently pertain to whether or not you can list items with variations.  By default, this method returns the entire category tree for the specified marketplace. You can limit the size of the result set by using the filter query parameter to specify only the category IDs you want to review.Tip: This method can potentially return a very large response payload. eBay recommends that the response payload be compressed by passing in the Accept-Encoding request header and setting the value to gzip.\n@required {marketplace_id: str # This path parameter specifies the eBay marketplace for which policy information is retrieved. See HTTP Request Headers for a list of supported eBay marketplace ID values.}\n@optional {filter: str # This query parameter limits the response by returning policy information for only the selected sections of the category tree. Supply categoryId values for the sections of the tree you want returned.  When you specify a categoryId value, the returned category tree includes the policies for that parent node, plus the policies for any leaf nodes below that parent node.  The parameter takes a list of categoryId values and you can specify up to 50 separate category IDs. Separate multiple values with a pipe character ('|'). If you specify more than 50 categoryId values, eBay returns the policies for the first 50 IDs and a warning that not all categories were returned.  Example: filter=categoryIds:{100|101|102}  Note that you must URL-encode the parameter list, which results in the following filter for the above example:    filter=categoryIds%3A%7B100%7C101%7C102%7D, Accept-Encoding: str # This header indicates the compression-encoding algorithms the client accepts for the response. This value should be set to gzip.  For more information, refer to HTTP request headers., Accept-Language: str # This header is required to retrieve metadata for the French Canada, French Belgium, and Dutch Belgium marketplaces.Follow the instructions below to retrieve metadata for these three marketplaces:French Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of fr-BE.Dutch Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of nl-BE.French Canada: Set the marketplace_id path parameter value to EBAY_CA, and include the Accept-Language header with a value of fr-CA.Note: If EBAY_CA is set as the marketplace_id path parameter and the Accept-Language header is not used, the marketplace will default to the English Canada marketplace.}\n@returns(200) {listingStructurePolicies: [map], warnings: [map]} # Success\n@returns(204) No content\n@errors {400: Bad Request, 404: Not found, 500: Internal Server Error}\n\n@endpoint GET /marketplace/{marketplace_id}/get_listing_type_policies\n@desc This method returns eBay listing type policy metadata for all leaf categories on the specified marketplace. By default, this method returns metadata on all leaf categories. You can limit the size of the result set by using the filter query parameter to specify only the leaf category IDs you want to review.If you specify a valid marketplace ID but that marketplace does not contain policy information, or if you filter out all results, a successful call returns a 204 No content status code with an empty response body.\n@required {marketplace_id: str # This path parameter specifies the eBay marketplace for which policy information is retrieved.See HTTP Request Headers for a list of supported eBay marketplace ID values.}\n@optional {filter: str # This query parameter limits the response by only returning metadata for the specified leaf categories. Supply the categoryId for one or more leaf categories. You can verify if a category is a leaf category by using the Taxonomy API and looking for a \"leafCategory\": true tag.The parameter takes a list of categoryId values and you can specify up to 50 separate category IDs. Separate multiple values with a pipe character ('|'). If you specify more than 50 categoryId values, eBay returns the policies for the first 50 IDs and a warning that not all categories were returned.Example: filter=categoryIds:{3767|171784}, Accept-Language: str # This header is required to retrieve metadata for the French Canada, French Belgium, and Dutch Belgium marketplaces.Follow the instructions below to retrieve metadata for these three marketplaces:French Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of fr-BE.Dutch Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of nl-BE.French Canada: Set the marketplace_id path parameter value to EBAY_CA, and include the Accept-Language header with a value of fr-CA.Note: If EBAY_CA is set as the marketplace_id path parameter and the Accept-Language header is not used, the marketplace will default to the English Canada marketplace.}\n@returns(200) {listingTypePolicies: [map], warnings: [map]} # Success\n@returns(204) No content\n@errors {400: Bad Request, 404: Not found, 500: Internal Server Error}\n\n@endpoint GET /marketplace/{marketplace_id}/get_motors_listing_policies\n@desc This method returns eBay Motors policy metadata for all leaf categories on the specified marketplace. By default, this method returns metadata on all leaf categories. You can limit the size of the result set by using the filter query parameter to specify only the leaf category IDs you want to review.If you specify a valid marketplace ID but that marketplace does not contain policy information, or if you filter out all results, a successful call returns a 204 No content status code with an empty response body.Note: To return policy information for eBay US Motors categories, specify marketplace_id as EBAY_MOTORS_US.\n@required {marketplace_id: str # This path parameter specifies the eBay marketplace for which policy information is retrieved.See HTTP Request Headers for a list of supported eBay marketplace ID values.}\n@optional {filter: str # This query parameter limits the response by only returning metadata for the specified leaf categories. Supply the categoryId for one or more leaf categories. You can verify if a category is a leaf category by using the Taxonomy API and looking for a \"leafCategory\": true tag. The parameter takes a list of categoryId values and you can specify up to 50 separate category IDs. Separate multiple values with a pipe character ('|'). If you specify more than 50 categoryId values, eBay returns the policies for the first 50 IDs and a warning that not all categories were returned.Example: filter=categoryIds:{3767|171784}, Accept-Language: str # This header is required to retrieve metadata for the French Canada, French Belgium, and Dutch Belgium marketplaces.Follow the instructions below to retrieve metadata for these three marketplaces:French Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of fr-BE.Dutch Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of nl-BE.French Canada: Set the marketplace_id path parameter value to EBAY_CA, and include the Accept-Language header with a value of fr-CA.Note: If EBAY_CA is set as the marketplace_id path parameter and the Accept-Language header is not used, the marketplace will default to the English Canada marketplace.}\n@returns(200) {motorsListingPolicies: [map], warnings: [map]} # Success\n@returns(204) No content\n@errors {400: Bad Request, 404: Not found, 500: Internal Server Error}\n\n@endpoint GET /marketplace/{marketplace_id}/get_negotiated_price_policies\n@desc This method returns the eBay policies that define the supported negotiated price features (like \"best offer\") for the categories of a specific marketplace.  By default, this method returns the entire category tree for the specified marketplace. You can limit the size of the result set by using the filter query parameter to specify only the category IDs you want to review.Tip: This method can potentially return a very large response payload. eBay recommends that the response payload be compressed by passing in the Accept-Encoding request header and setting the value to gzip.\n@required {marketplace_id: str # This path parameter specifies the eBay marketplace for which policy information is retrieved.See HTTP Request Headers for a list of supported eBay marketplace ID values.}\n@optional {filter: str # This query parameter limits the response by returning policy information for only the selected sections of the category tree. Supply categoryId values for the sections of the tree you want returned.  When you specify a categoryId value, the returned category tree includes the policies for that parent node, plus the policies for any leaf nodes below that parent node.  The parameter takes a list of categoryId values and you can specify up to 50 separate category IDs. Separate multiple values with a pipe character ('|'). If you specify more than 50 categoryId values, eBay returns the policies for the first 50 IDs and a warning that not all categories were returned.  Example: filter=categoryIds:{100|101|102}  Note that you must URL-encode the parameter list, which results in the following filter for the above example:    filter=categoryIds%3A%7B100%7C101%7C102%7D, Accept-Encoding: str # This header indicates the compression-encoding algorithms the client accepts for the response. This value should be set to gzip.  For more information, refer to HTTP request headers., Accept-Language: str # This header is required to retrieve metadata for the French Canada, French Belgium, and Dutch Belgium marketplaces.Follow the instructions below to retrieve metadata for these three marketplaces:French Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of fr-BE.Dutch Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of nl-BE.French Canada: Set the marketplace_id path parameter value to EBAY_CA, and include the Accept-Language header with a value of fr-CA.Note: If EBAY_CA is set as the marketplace_id path parameter and the Accept-Language header is not used, the marketplace will default to the English Canada marketplace.}\n@returns(200) {negotiatedPricePolicies: [map], warnings: [map]} # Success\n@returns(204) No content\n@errors {400: Bad Request, 404: Not found, 500: Internal Server Error}\n\n@endpoint GET /marketplace/{marketplace_id}/get_product_safety_labels\n@desc This method returns product safety label information for the specified eBay marketplace. The information includes IDs, descriptions, and URLs (as applicable) for the available statements and pictograms. The returned statements are localized for the default language of the marketplace. If a marketplace does not support product safety label information, no response payload is returned, but only a 204 No content status code.This information is used by the seller to add product safety label related information to their listings. The getRegulatoryPolicies method can be used to see which categories recommend or require product safety labels.\n@required {marketplace_id: str # This path parameter specifies the eBay marketplace for which policy information is retrieved.See HTTP Request Headers for a list of supported eBay marketplace ID values. See the following note for exceptions.Note: This method is not supported in the EBAY_HK, EBAY_MY, EBAY_TW, or EBAY_PH marketplaces.}\n@returns(200) {pictograms: [map], statements: [map]} # Success\n@returns(204) No content\n@errors {400: Bad Request, 404: Not found, 500: Internal Server Error}\n\n@endpoint GET /marketplace/{marketplace_id}/get_regulatory_policies\n@desc This method returns regulatory policies for one, multiple, or all eBay categories in an eBay marketplace. The identifier of the eBay marketplace is passed in as a path parameter, and unless one or more eBay category IDs are passed in through the filter query parameter, this method will return metadata for every listing category in the specified marketplace.Tip: This method can potentially return a very large response payload. eBay recommends that the response payload be compressed by passing in the Accept-Encoding request header and setting the value to gzip.\n@required {marketplace_id: str # This path parameter specifies the eBay marketplace for which policy information shall be retrieved.See HTTP Request Headers for a list of supported eBay marketplace ID values.Note: This method is not supported in the EBAY_HK, EBAY_MY, EBAY_TW, or EBAY_PH marketplaces.}\n@optional {filter: str # A query parameter that can be used to limit the response by returning policy information for only the selected sections of the category tree. Supply categoryId values for the sections of the tree that should be returned.Pass in the categoryId values using a URL-encoded, pipe-separated ('|') list. For example: filter=categoryIds%3A%7B100%7C101%7C102%7DMaximum: 50, Accept-Language: str # This header is required to retrieve metadata for the French Canada, French Belgium, and Dutch Belgium marketplaces.Follow the instructions below to retrieve metadata for these three marketplaces:French Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of fr-BE.Dutch Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of nl-BE.French Canada: Set the marketplace_id path parameter value to EBAY_CA, and include the Accept-Language header with a value of fr-CA.Note: If EBAY_CA is set as the marketplace_id path parameter and the Accept-Language header is not used, the marketplace will default to the English Canada marketplace.}\n@returns(200) {regulatoryPolicies: [map], warnings: [map]} # Success\n@returns(204) No content\n@errors {400: Bad Request, 404: Not found, 500: Internal Server Error}\n\n@endpoint GET /marketplace/{marketplace_id}/get_return_policies\n@desc This method returns 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, plus the guidelines for creating domestic and international return policies in the different eBay categories.  By default, this method returns the entire category tree for the specified marketplace. You can limit the size of the result set by using the filter query parameter to specify only the category IDs you want to review.Tip: This method can potentially return a very large response payload. eBay recommends that the response payload be compressed by passing in the Accept-Encoding request header and setting the value to gzip.\n@required {marketplace_id: str # This path parameter specifies the eBay marketplace for which policy information is retrieved.See HTTP Request Headers for a list of supported eBay marketplace ID values.}\n@optional {filter: str # This query parameter limits the response by returning policy information for only the selected sections of the category tree. Supply categoryId values for the sections of the tree you want returned.  When you specify a categoryId value, the returned category tree includes the policies for that parent node, plus the policies for any leaf nodes below that parent node.  The parameter takes a list of categoryId values and you can specify up to 50 separate category IDs. Separate multiple values with a pipe character ('|'). If you specify more than 50 categoryId values, eBay returns the policies for the first 50 IDs and a warning that not all categories were returned.  Example: filter=categoryIds:{100|101|102}  Note that you must URL-encode the parameter list, which results in the following filter for the above example:    filter=categoryIds%3A%7B100%7C101%7C102%7D, Accept-Encoding: str # This header indicates the compression-encoding algorithms the client accepts for the response. This value should be set to gzip.  For more information, refer to HTTP request headers., Accept-Language: str # This header is required to retrieve metadata for the French Canada, French Belgium, and Dutch Belgium marketplaces.Follow the instructions below to retrieve metadata for these three marketplaces:French Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of fr-BE.Dutch Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of nl-BE.French Canada: Set the marketplace_id path parameter value to EBAY_CA, and include the Accept-Language header with a value of fr-CA.Note: If EBAY_CA is set as the marketplace_id path parameter and the Accept-Language header is not used, the marketplace will default to the English Canada marketplace.}\n@returns(200) {returnPolicies: [map], warnings: [map]} # Success\n@returns(204) No content\n@errors {400: Bad Request, 404: Not found, 500: Internal Server Error}\n\n@endpoint GET /marketplace/{marketplace_id}/get_shipping_policies\n@desc This method returns eBay shipping policy metadata for all leaf categories on the specified marketplace.By default, this method returns metadata on all leaf categories. You can limit the size of the result set by using the filter query parameter to specify only the leaf category IDs you want to review.If you specify a valid marketplace ID but that marketplace does not contain policy information, or if you filter out all results, a successful call returns a 204 No content status code with an empty response body.\n@required {marketplace_id: str # This path parameter specifies the eBay marketplace for which policy information is retrieved.See HTTP Request Headers for a list of supported eBay marketplace ID values.}\n@optional {filter: str # This query parameter limits the response by only returning metadata for the specified leaf categories. Supply the categoryId for one or more leaf categories. You can verify if a category is a leaf category by using the Taxonomy API and looking for a \"leafCategory\": true tag. The parameter takes a list of categoryId values and you can specify up to 50 separate category IDs. Separate multiple values with a pipe character ('|'). If you specify more than 50 categoryId values, eBay returns the policies for the first 50 IDs and a warning that not all categories were returned.Example: filter=categoryIds:{3767|171784}, Accept-Language: str # This header is required to retrieve metadata for the French Canada, French Belgium, and Dutch Belgium marketplaces.Follow the instructions below to retrieve metadata for these three marketplaces:French Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of fr-BE.Dutch Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of nl-BE.French Canada: Set the marketplace_id path parameter value to EBAY_CA, and include the Accept-Language header with a value of fr-CA.Note: If EBAY_CA is set as the marketplace_id path parameter and the Accept-Language header is not used, the marketplace will default to the English Canada marketplace.}\n@returns(200) {shippingPolicies: [map], warnings: [map]} # Success\n@returns(204) No content\n@errors {400: Bad Request, 404: Not found, 500: Internal Server Error}\n\n@endpoint GET /marketplace/{marketplace_id}/get_site_visibility_policies\n@desc This method returns eBay international site visibility policy metadata for all leaf categories on the specified marketplace.By default, this method returns metadata on all leaf categories. You can limit the size of the result set by using the filter query parameter to specify only the leaf category IDs you want to review.If you specify a valid marketplace ID but that marketplace does not contain policy information, or if you filter out all results, a successful call returns a 204 No content status code with an empty response body.\n@required {marketplace_id: str # This path parameter specifies the eBay marketplace for which policy information is retrieved.See HTTP Request Headers for a list of supported eBay marketplace ID values.}\n@optional {filter: str # This query parameter limits the response by only returning metadata for the specified leaf categories. Supply the categoryId for one or more leaf categories. You can verify if a category is a leaf category by using the Taxonomy API and looking for a \"leafCategory\": true tag. The parameter takes a list of categoryId values and you can specify up to 50 separate category IDs. Separate multiple values with a pipe character ('|'). If you specify more than 50 categoryId values, eBay returns the policies for the first 50 IDs and a warning that not all categories were returned.Example:filter=categoryIds:{3767|171784}, Accept-Language: str # This header is required to retrieve metadata for the French Canada, French Belgium, and Dutch Belgium marketplaces.Follow the instructions below to retrieve metadata for these three marketplaces:French Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of fr-BE.Dutch Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of nl-BE.French Canada: Set the marketplace_id path parameter value to EBAY_CA, and include the Accept-Language header with a value of fr-CA.Note: If EBAY_CA is set as the marketplace_id path parameter and the Accept-Language header is not used, the marketplace will default to the English Canada marketplace.}\n@returns(200) {siteVisibilityPolicies: [map], warnings: [map]} # Success\n@returns(204) No content\n@errors {400: Bad Request, 404: Not found, 500: Internal Server Error}\n\n@endgroup\n\n@group compatibilities\n@endpoint POST /compatibilities/get_compatibilities_by_specification\n@desc This method is used to retrieve all compatible application name-value pairs for a part based on the provided specification(s).The part's relevant dimensions and/or characteristics can be provided through the specifications container. For example, when retrieving compatible application name-value pairs for a tire, the tire's dimensions (such as the section width or rim diameter) should be provided.By default, all compatible application name-value pairs for the specifications are returned. You can limit the size of the result set by using the compatibilityPropertyFilters array to specify the properties (such as make, model, year, or trim) you wish to be included in the response.Note: The getCompatibilityPropertyNames and getCompatibilityPropertyValues methods can be used to retrieve valid property names and values that can be used as the name-value pairs to define specifications.\n@required {X-EBAY-C-MARKETPLACE-ID: str # This header identifies the seller's eBay marketplace.See Metadata API requirements and restrictions for supported values., Content-Type: str # This header indicates the format of the request body provided by the client.Its value should be set to application/json.For more information, refer to HTTP request headers in the Using eBay RESTful APIs guide.}\n@optional {categoryId: str # The unique identifier of the eBay leaf category for which compatibility details are being retrieved. This category must be a valid eBay category on the specified eBay marketplace, and the category must support parts compatibility for cars, trucks, or motorcycles.Use the getAutomotivePartsCompatibilityPolicies method to retrieve a list of categories that support parts compatibility by specification. For the categories in the response that support compatibility by specification, you’ll see SPECIFICATIONS as the value for the compatibilityBasedOn field, compatibilityPropertyFilters: [map{propertyName: str, propertyValue: str, unitOfMeasurement: str, url: str}] # This comma-delimited array can be used to restrict the number of compatible application name-value pairs returned in the response by specifying the properties that the seller wishes to be included in the response.Only compatible applications with the specified properties will be returned. Properties that can be specified here include make, model, year, and trim., dataset: str # This field can be used to define the type of properties that will be returned in the response. For example, if you specify Searchable, the compatibility details will contain properties that can be used to search for products, such as make or model.Note: This field cannot be used alongside dataPropertyName. If both are used, an error will occur.Valid values:DisplayableProductDetails: Properties for use in a user interface to describe products.DisplayableSearchResults: Properties for use in results for product searches.Searchable: Properties for use in searches.Sortable: Properties that are suitable for sorting.Default value: DisplayableSearchResults, datasetPropertyName: [str] # This comma-delimited array can be used to define the specific property name(s) that will be returned in the response.For example, if you specify Engine, the result set will only contain engines that are compatible with the input criteria.Note: This array cannot be used alongside dataset. If both are used, an error will occur., exactMatch: bool # This boolean can be used to specify that the compatibilities returned in the response are to be defined by an exact match on the input value of specification properties.By default, an expanded compatibility match is done when it applies, such as for Load Index, where a compatible vehicle is one that has a load index requirement that is less than or equal to the input. By specifying this field as true, only exact matches are returned., paginationInput: map{limit: int(int32), offset: int(int32)} # This type defines the fields used to control the pagination of the result set., sortOrders: [map{sortOrder: map{order: str, propertyName: str}, sortPriority: str}] # This array specifies the sorting order of the compatibility properties. Any of the searchable properties can be used to specify search order. Up to 5 levels of sort order may be specified.Note: If no sort order is specified through this field, the default sort order of popularity descending is applied., specifications: [map{propertyName: str, propertyValue: str, unitOfMeasurement: str, url: str}] # This array defines the specifications of the part, in the form of name-value pairs, for which compatible applications will be retrieved.}\n@returns(200) {compatibilityDetails: [map], pagination: map{count: int(int32), limit: int(int32), offset: int(int32), total: int(int32)}} # Success\n@returns(204) No Content\n@errors {400: Bad Request, 401: Unauthorized, 500: Internal Server Error}\n\n@endpoint POST /compatibilities/get_compatibility_property_names\n@desc This method is used to retrieve product compatibility property names for the specified compatibility-enabled category.Compatibility property names can be used alongside the corresponding compatibility property value (retrieved using the getCompatibilityPropertyValues method) to describe the assembly for which an item is compatible.The categoryId of the compatibility-enabled category for which to retrieve compatibility property names is required in the request body.By default, all property names within the compatibility category of the specified compatibility-enable category are returned. You can limit the size of the result set by using the dataset array to specify the types of properties you want returned.\n@required {X-EBAY-C-MARKETPLACE-ID: str # This header identifies the seller's eBay marketplace.See Metadata API requirements and restrictions for supported values., Content-Type: str # This header indicates the format of the request body provided by the client.Its value should be set to application/json.For more information, refer to HTTP request headers in the Using eBay RESTful APIs guide.}\n@optional {categoryId: str # The unique identifier of the eBay leaf category for which to retrieve compatibility property names. This category must be a valid eBay category on the specified eBay marketplace, and the category must support parts compatibility.Use the getAutomotivePartsCompatibilityPolicies method to retrieve a list of categories that support parts compatibility., dataset: [str] # This array defines the properties that will be returned for the compatibility-enabled category. For example, if you specify Searchable, the compatibility details will contain properties that can be used to search for products, such as make or model.Valid values:DisplayableProductDetails: Properties for use in a user interface to describe products.DisplayableSearchResults: Properties for use in results for product searches.Searchable: Properties for use in searches.Sortable: Properties that are suitable for sorting.Default: DisplayableSearchResults}\n@returns(200) {categoryId: str, properties: [map]} # Success\n@returns(204) No Content\n@errors {400: Bad Request, 401: Unauthorized, 500: Internal Server Error}\n\n@endpoint POST /compatibilities/get_compatibility_property_values\n@desc This method is used to retrieve product compatibility property values associated with a single property name, in the specified category.Compatibility property values can be used alongside the corresponding compatibility property name (retrieved using the getCompatibilityPropertyNames method) to describe the assembly for which an item is compatible.The categoryId of the compatibility-enabled category for which to retrieve compatibility property values is required in the request body, as well as the propertyName for which you wish to retrieve associated values.By default, all property values associated with the specified propertyName are returned. You can limit the size of the result set by using the propertyFilter array. Only property values associated with the specified name-value pairs will be returned.\n@required {X-EBAY-C-MARKETPLACE-ID: str # This header identifies the seller's eBay marketplace.See Metadata API requirements and restrictions for supported values., Content-Type: str # This header indicates the format of the request body provided by the client.Its value should be set to application/json.For more information, refer to HTTP request headers in the Using eBay RESTful APIs guide.}\n@optional {categoryId: str # The unique identifier of the eBay leaf category for which to retrieve compatibility property values. This category must be a valid eBay category on the specified eBay marketplace, and the category must support parts compatibility.Use the getAutomotivePartsCompatibilityPolicies method to retrieve a list of categories that support parts compatibility., propertyFilters: [map{propertyName: str, propertyValue: str, unitOfMeasurement: str, url: str}] # This array can be used to specify the compatibility properties used limit the result set. Only values associated with the specified name-value pairs will be returned in the response.For example, if the propertyName is set to Make and the propertyValue is set to Honda, only compatible Honda vehicles will be returned., propertyName: str # This field specifies the name of the property for which to retrieve associated property values.For example, typical vehicle property names are 'Make', 'Model', 'Year', 'Engine', and 'Trim', but will vary based on the eBay marketplace and the eBay category. Use the getCompatibilityPropertyNames method to retrieve valid property names for a specified category., sortOrder: str # This field specifies the sort order for the property values in the result set.Valid values:AscendingDescendingNote: If no search order is specified, values are sorted in ascending order.}\n@returns(200) {metadataVersion: str, propertyName: str, propertyValues: [str]} # Success\n@returns(204) No Content\n@errors {400: Bad Request, 401: Unauthorized, 500: Internal Server Error}\n\n@endpoint POST /compatibilities/get_multi_compatibility_property_values\n@desc This method is used to retrieve product compatibility property values associated with multiple property names, in the specified category.Compatibility property values can be used alongside the corresponding compatibility property name (retrieved using the getCompatibilityPropertyNames method) to describe the assembly for which an item is compatible.The categoryId of the compatibility-enabled category for which to retrieve compatibility property values is required in the request body, as well as the propertyNames for which you wish to retrieve associated property values. The propertyFilter array is also required to constrain the output. Only property values associated with the specified name-value pairs will be returned.\n@required {X-EBAY-C-MARKETPLACE-ID: str # This header identifies the seller's eBay marketplace.See Metadata API requirements and restrictions for supported values., Content-Type: str # This header indicates the format of the request body provided by the client.Its value should be set to application/json.For more information, refer to HTTP request headers in the Using eBay RESTful APIs guide.}\n@optional {categoryId: str # The unique identifier of the eBay leaf category for which to retrieve property values.Use the getAutomotivePartsCompatibilityPolicies method to retrieve a list of categories that support parts compatibility., propertyFilters: [map{propertyName: str, propertyValue: str, unitOfMeasurement: str, url: str}] # This array can be used to specify the compatibility properties used to limit the result set. Only values associated with the specified name-value pairs will be returned in the response.For example, if the propertyName is set to Year and the propertyValue is set to 2022, only compatible vehicles from 2022 will be returned.At least one property name-value pair must be used., propertyNames: [str] # This comma-delimited array specifies the names of the properties for which to retrieve associated property values.For example, typical vehicle property names are 'Make', 'Model', 'Year', 'Engine', and 'Trim', but will vary based on the eBay marketplace and the eBay category.}\n@returns(200) {compatibilities: [map], metadataVersion: str} # Success\n@returns(204) No Content\n@errors {400: Bad Request, 401: Unauthorized, 500: Internal Server Error}\n\n@endpoint POST /compatibilities/get_product_compatibilities\n@desc This method is used to retrieve all available item compatibility details for the specified product.Item compatibility details can be used to see the properties for which an item is compatible. For example, if you are searching for a part for a specific vehicle, you can use this method to see the years, engine, and/or trim for which the part is compatible. Item compatibility details are returned as name-value pairs.The product for which to retrieve item compatibility details must be provided through the productIdentifier field. This value can be either an eBay specific identifier (such as an ePID) or an external identifier (such as a UPC).By default, all available item compatibility details for the specified product are returned. You can limit the size of the result set using the dataset or datasetPropertyName fields to specify the types of properties you want returned in the response. The applicationPropertyFilter array can also be used so that only parts compatible with the specified name-value pairs are returned.\n@required {X-EBAY-C-MARKETPLACE-ID: str # This header identifies the seller's eBay marketplace.See Metadata API requirements and restrictions for supported values., Content-Type: str # This header indicates the format of the request body provided by the client.Its value should be set to application/json.For more information, refer to HTTP request headers in the Using eBay RESTful APIs guide.}\n@optional {applicationPropertyFilters: [map{propertyName: str, propertyValue: str, unitOfMeasurement: str, url: str}] # This array is used to filter the properties of an application, such as a vehicle's make or model, that will be returned in the response.Application property filters are specified as name-value pairs. Only products compatible with these name-value pairs will be returned., dataset: [str] # This array defines the type of properties that are returned for the catalog-enabled category.For example, if you specify Searchable, the compatibility details will contain properties that can be used to search for products, such as make or model.Note: This field cannot be used alongside dataPropertyName. If both are used, an error will occur.Valid values:DisplayableProductDetails: Properties for use in a user interface to describe products.DisplayableSearchResults: Properties for use in results for product searches.Searchable: Properties for use in searches.Sortable: Properties that are suitable for sorting.Default: DisplayableSearchResults, datasetPropertyName: [str] # This comma-delimted array can be used to define the specific property name(s) that will be returned in the response.For example, if you specify Engine, the result set will only contain engines that are compatible with the input criteria.Note: This array cannot be used alongside dataset. If both are used, an error will occur., disabledProductFilter: map{excludeForEbayReviews: bool, excludeForEbaySelling: bool} # This type defines the booleans used to determine if a product is excluded from eBay selling and/or review., paginationInput: map{limit: int(int32), offset: int(int32)} # This type defines the fields used to control the pagination of the result set., productIdentifier: map{ean: str, epid: str, isbn: str, productId: str, upc: str} # This type defines the supported product identifiers., sortOrders: [map{sortOrder: map{order: str, propertyName: str}, sortPriority: str}] # This array controls the sort order of compatibility properties.}\n@returns(200) {compatibilityDetails: [map], pagination: map{count: int(int32), limit: int(int32), offset: int(int32), total: int(int32)}} # Success\n@returns(204) No Content\n@errors {400: Bad Request, 401: Unauthorized, 500: Internal Server Error}\n\n@endgroup\n\n@group shipping\n@endpoint GET /shipping/marketplace/{marketplace_id}/get_exclude_shipping_locations\n@desc This method retrieves a list of locations that the seller can use as excluded shipping locations within their listings or in their fulfillment business policies for the specified marketplace. These are locations that a seller designates as areas where they will not ship items. Excluded shipping locations and ship-to locations are used in tandem at the listing level and in fulfillment business policies. Excluded shipping locations and ship-to locations share a lot of the same values and they should not contradict each other.Manage excluded shipping locations using business policies through the fulfillment_policy resource of the Account v1 API.\n@required {marketplace_id: str # This path parameter specifies the eBay marketplace for which excluded shipping locations information is retrieved.See MarketplaceIdEnum for supported eBay marketplace ID values. Note:  When listing the items on the French Canada, French Belgium, and Dutch Belgium marketplaces, also set the Accept-Language header as needed.}\n@optional {Accept-Language: str # This header is required to retrieve metadata for the French Canada, French Belgium, and Dutch Belgium marketplaces.Follow the instructions below to retrieve metadata for these three marketplaces:French Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of fr-BE.Dutch Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of nl-BE.French Canada: Set the marketplace_id path parameter value to EBAY_CA, and include the Accept-Language header with a value of fr-CA.Note: If EBAY_CA is set as the marketplace_id path parameter and the Accept-Language header is not used, the marketplace will default to the English Canada marketplace.}\n@returns(200) {excludeShippingLocations: [map]} # Success\n@errors {400: Bad Request, 500: Internal Server Error}\n\n@endpoint GET /shipping/marketplace/{marketplace_id}/get_handling_times\n@desc This method retrieves a list of supported handling times for the specified marketplace. The handling time returned specifies the maximum number of business days the eBay site allows for shipping an item to domestic buyers after receiving a cleared payment. Handling times apply to both domestic and international orders. If the handling time is 1 day, the seller commits to dropping the item off for shipment one business day after payment clears. Manage handing times using business policies through the fulfillment_policy resource of the Account v1 API.\n@required {marketplace_id: str # This path parameter specifies the eBay marketplace for which handling times information is retrieved.See MarketplaceIdEnum for supported eBay marketplace ID values. Note:  When listing the items on the French Canada, French Belgium, and Dutch Belgium marketplaces, also set the Accept-Language header as needed.}\n@optional {Accept-Language: str # This header is required to retrieve metadata for the French Canada, French Belgium, and Dutch Belgium marketplaces.Follow the instructions below to retrieve metadata for these three marketplaces:French Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of fr-BE.Dutch Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of nl-BE.French Canada: Set the marketplace_id path parameter value to EBAY_CA, and include the Accept-Language header with a value of fr-CA.Note: If EBAY_CA is set as the marketplace_id path parameter and the Accept-Language header is not used, the marketplace will default to the English Canada marketplace.}\n@returns(200) {handlingTimes: [map]} # Success\n@errors {400: Bad Request, 500: Internal Server Error}\n\n@endpoint GET /shipping/marketplace/{marketplace_id}/get_shipping_carriers\n@desc This method retrieves a list of supported shipping carriers for the specified marketplace. It provides essential information for sellers to understand which shipping carriers are available for use when listing items on that eBay marketplace. Knowing the supported carriers can help sellers optimize their shipping options and ensure efficient delivery to buyers.The value returned in the shippingCarrier field is the enumerated value required when providing shipment tracking information for that carrier.Tip:  Use the getShippingServices method to explore available shipping services for each carrier.Manage shipping carriers using business policies through the fulfillment_policy resource of the Account v1 API.\n@required {marketplace_id: str # This path parameter specifies the eBay marketplace for which shipping carriers information is retrieved.See MarketplaceIdEnum for supported eBay marketplace ID values. Note:  When listing the items on the French Canada, French Belgium, and Dutch Belgium marketplaces, also set the Accept-Language header as needed.}\n@optional {Accept-Language: str # This header is required to retrieve metadata for the French Canada, French Belgium, and Dutch Belgium marketplaces.Follow the instructions below to retrieve metadata for these three marketplaces:French Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of fr-BE.Dutch Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of nl-BE.French Canada: Set the marketplace_id path parameter value to EBAY_CA, and include the Accept-Language header with a value of fr-CA.Note: If EBAY_CA is set as the marketplace_id path parameter and the Accept-Language header is not used, the marketplace will default to the English Canada marketplace.}\n@returns(200) {shippingCarriers: [map]} # Success\n@errors {400: Bad Request, 500: Internal Server Error}\n\n@endpoint GET /shipping/marketplace/{marketplace_id}/get_shipping_locations\n@desc This method retrieves a list of supported shipping locations for the specified marketplace. It provides sellers with information on where they can ship their items. Sellers can use this information to configure their shipping settings. Tip:  Use the getExcludeShippingLocations method to return locations where the seller does not ship.Manage shipping locations using business policies through the fulfillment_policy resource of the Account v1 API.\n@required {marketplace_id: str # This path parameter specifies the eBay marketplace for which shipping locations information is retrieved.See MarketplaceIdEnum for supported eBay marketplace ID values. Note:  When listing the items on the French Canada, French Belgium, and Dutch Belgium marketplaces, also set the Accept-Language header as needed.}\n@optional {Accept-Language: str # This header is required to retrieve metadata for the French Canada, French Belgium, and Dutch Belgium marketplaces.Follow the instructions below to retrieve metadata for these three marketplaces:French Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of fr-BE.Dutch Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of nl-BE.French Canada: Set the marketplace_id path parameter value to EBAY_CA, and include the Accept-Language header with a value of fr-CA.Note: If EBAY_CA is set as the marketplace_id path parameter and the Accept-Language header is not used, the marketplace will default to the English Canada marketplace.}\n@returns(200) {shippingLocations: [map]} # Success\n@errors {400: Bad Request, 500: Internal Server Error}\n\n@endpoint GET /shipping/marketplace/{marketplace_id}/get_shipping_services\n@desc This method retrieves a list of shipping services supported for the specified marketplace, including valid shipping services, shipping times, and package constraints such as size and weight.Manage shipping services using business policies through the fulfillment_policy resource of the Account v1 API.\n@required {marketplace_id: str # This path parameter specifies the eBay marketplace for which shipping services information is retrieved.See MarketplaceIdEnum for supported eBay marketplace ID values. Note:  When listing the items on the French Canada, French Belgium, and Dutch Belgium marketplaces, also set the Accept-Language header as needed.}\n@optional {Accept-Language: str # This header is required to retrieve metadata for the French Canada, French Belgium, and Dutch Belgium marketplaces.Follow the instructions below to retrieve metadata for these three marketplaces:French Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of fr-BE.Dutch Belgium: Set the marketplace_id path parameter value to EBAY_BE, and include the Accept-Language header with a value of nl-BE.French Canada: Set the marketplace_id path parameter value to EBAY_CA, and include the Accept-Language header with a value of fr-CA.Note: If EBAY_CA is set as the marketplace_id path parameter and the Accept-Language header is not used, the marketplace will default to the English Canada marketplace.}\n@returns(200) {shippingServices: [map]} # Success\n@errors {400: Bad Request, 500: Internal Server Error}\n\n@endgroup\n\n@group country\n@endpoint GET /country/{countryCode}/sales_tax_jurisdiction\n@desc This method retrieves all sales-tax jurisdictions for the country specified in the countryCode path parameter. Countries with valid sales-tax jurisdictions are Canada and the US.The response from this call tells you the jurisdictions for which a seller can configure tax tables. Although setting up tax tables is optional, you can use the createOrReplaceSalesTax method in the Account API call to configure the tax tables for the jurisdictions into which you sell.Note: Sales-tax tables are only available for the US (EBAY_US) and Canada (EBAY_CA) marketplaces.Important! \">Important! In the US, eBay now calculates, collects, and remits sales tax to the proper taxing authorities in all 50 states and Washington, DC. Sellers can no longer specify sales-tax rates for these jurisdictions using a tax table.However, sellers may continue to use a sales-tax table to set rates for the following US territories:American Samoa (AS)Guam (GU)Northern Mariana Islands (MP)Palau (PW)US Virgin Islands (VI)For additional information, refer to Taxes and import charges.\n@required {countryCode: str # This path parameter specifies the two-letter ISO 3166 country code for the country whose jurisdictions you want to retrieve.Note: Sales-tax tables are available only for the US and Canada marketplaces. Therefore, the only supported values are:USCA}\n@returns(200) {salesTaxJurisdictions: [map]} # Success\n@errors {400: Bad Request, 404: Not Found, 500: Internal Server Error}\n\n@endgroup\n\n@end\n"}}