Skip to main content

  • API License Agreement Update: We have made significant enhancements to our API License Agreement, including detailed data protection measures and compliance with international regulations. Important restrictions have been applied to the use of Restricted APIs and AI content. Developers must review the updated agreement to ensure compliance.
  • Important Update: eBay's API integrations will be modified to address data handling requirements for select developers. Usernames will be replaced with immutable user IDs, and financial data will be protected for certain users. Learn more here.

This API allows sellers to retrieve and manage their custom shipping rate tables. In addition, this API also provides sellers in mainland China methods to configure split-payouts between two separate payment instruments.

rate_table

Method NameHTTP MethodPathSummarySamples
getRateTableGET/rate_table/{rate_table_id}Retrieves details of a specific shipping rate table.View getRateTable - /rate_table/{rate_table_id}
updateShippingCostPOST/rate_table/{rate_table_id}/update_shipping_costUpdates one or more shipping rates for a specific shipping rate table.View updateShippingCost - /rate_table/{rate_table_id}/update_shipping_cost

payout_settings

Method NameHTTP MethodPathSummarySamples
getPayoutSettingsGET/payout_settingsRetrieves payout percentages and unique IDs for accounts configured to receive seller payouts.View getPayoutSettings - /payout_settings
updatePayoutPercentagePOST/payout_settings/update_percentageUpdates the split-payout percentage for two payout instruments for sellers in mainland China.View updatePayoutPercentage - /payout_settings/update_percentage

combined_shipping_rules

Method NameHTTP MethodPathSummarySamples
createCalculatedShippingRulesPOST/combined_shipping_rules/create_calculated_shipping_rulesCreates calculated shipping rules that determine combined shipping costs based on item attributes (such as weight, dimensions), for the seller's account.View createCalculatedShippingRules - /combined_shipping_rules/create_calculated_shipping_rules
createFlatShippingRulesPOST/combined_shipping_rules/create_flat_shipping_rulesCreates flat-rate rules that apply standard that apply standard combined shipping costs for a seller's listings.View createFlatShippingRules - /combined_shipping_rules/create_flat_shipping_rules
createPromotionalShippingRulePOST/combined_shipping_rules/create_promotional_shipping_ruleDefines promotional shipping rules, such as discounts or free-shipping thresholds.View createPromotionalShippingRule - /combined_shipping_rules/create_promotional_shipping_rule
getCombinedShippingRulesGET/combined_shipping_rulesRetrieves all combined shipping rule configurations defined for the seller.View getCombinedShippingRules - /combined_shipping_rules
updateCalculatedShippingRulesPOST/combined_shipping_rules/update_calculated_shipping_rulesUpdates a previously defined calculated shipping rules.View updateCalculatedShippingRules - /combined_shipping_rules/update_calculated_shipping_rules
updateCombinedPaymentsPOST/combined_shipping_rules/update_combined_paymentsConfigures or modifies combined payment settings that determine how unpaid orders can be merged.View updateCombinedPayments - /combined_shipping_rules/update_combined_payments
updateFlatShippingRulesPOST/combined_shipping_rules/update_flat_shipping_rulesUpdates existing flat-rate shipping rules.View updateFlatShippingRules - /combined_shipping_rules/update_flat_shipping_rules
updatePromotionalShippingRulePOST/combined_shipping_rules/update_promotional_shipping_ruleUpdates a promotional shipping rule to adjust discount thresholds, eligibility criteria, or duration for the seller.View updatePromotionalShippingRule - /combined_shipping_rules/update_promotional_shipping_rule

user_preferences

Method NameHTTP MethodPathSummarySamples
getUserPreferencesGET/user_preferencesRetrieves the seller's preferences for a specific eBay marketplace.View getUserPreferences - /user_preferences
setUserPreferencesPATCH/user_preferencesModifies one or more preferences for a seller on a specific marketplace.View setUserPreferences - /user_preferences