Just getting started with the Account API v1? See the following documents for details on using this API:
- Using eBay RESTful APIs
- Selling Integration Guide
- Account API v1 overview
Requirements and restrictions - Account API v1 Reference
The API release history
The following table lists recent Account API v1 releases. For older releases, see the Account API v1 release notes archive.
Version | Release Date | Summary of Release |
---|---|---|
2024-03-18 |
Removed cashOnDeliveryFee container from Fulfillment policies. |
|
Version 1.9.1 |
2022-10-11 |
Added a new AdvertisingProgramEnum value to support Offsite Ads. |
Version 1.9.0 |
2022-12-10 |
Added fields to support domestic or international promotional shipping discount profile ID |
Version 1.8.0 |
2022-07-11 |
Added the new advertising_eligibility resource, which includes the getAdvertisingEligibility method |
Version 1.7.0 |
2021-12-15 |
Added the new custom_policy resource with four new methods to create and manage Custom Policies |
Version 1.6.3 |
2021-06-21 |
Added support for multi-rate tables in the Spain (EBAY_ES ) and France (EBAY_FR ) marketplaces for the getRateTables method
|
Version 1.6.2 |
2021-04-20 |
Added support for multi-rate tables in the Germany (EBAY_DE ) and United Kingdom (EBAY_GB ) marketplaces for the getRateTables method
|
Version 1.6.1 |
2021-03-10 |
Added a new programTypeEnum value to support Partner Motors Program sellers |
Version 1.6.0 |
2020-06-10 |
Added the kyc resource and the getKYC method to support eBay managed payments sellers |
Version 1.5.0 |
2020-05-07 |
Added the onboarding resource that includes the getPaymentsProgramOnboarding method to the payments_program resource. |
Version 1.4.0 |
2018-10-23 |
The getRateTables method has been expanded to include the Canada (EBAY_CA ) and Italy (EBAY_IT ) marketplaces.
|
Version 1.9.2
This release removes the cashOnDeliveryFee container from the Account API v1 Fulfillment policies affecting the following methods:
-
getFulfillmentPolicies
-
createFulfillmentPolicy
-
getFulfillmentPolicy
-
updateFulfillmentPolicy
-
getFulfillmentPolicyByName
Version 1.9.1
This release adds a new enumeration value, as described below in Schema changes.
Schema Changes
This release adds a new OFFSITE_ADS
enumeration value to the AdvertisingProgramEnum type. This new enumeration value allows Off-site Ads to be an eBay advertising program for which a seller may be eligible.
Version 1.9.0
This release adds the following fields to the ShippingOption container. These fields support domestic or international promotional shipping discount profile ID.
-
shippingDiscountProfileId - The unique identifier of a seller's domestic or international shipping discount profile. If a buyer satisfies the requirements of the discount rule, this buyer will receive a shipping discount for the order.
-
shippingPromotionOffered - A boolean that indicates whether or not the seller has set up a promotional shipping discount that will be available to buyers who satisfy the requirements of the shipping discount rule.
The seller can create and manage shipping promotional discounts using (Get/Set) ShippingDiscountProfiles calls in the Trading API or through the Shipping Preferences in My eBay.
Note: Initially, shipping discount profiles in the Account API will not be available to all sellers. It will be rolled out over a 6 week time period.
Version 1.8.0
This release adds a new resource, as described below in Schema changes.
Schema Changes
This release adds a new advertising_eligibility resource. This new resource includes the getAdvertisingEligibility method, which allows developers to check the seller eligibility status for eBay advertising programs.
Version 1.7.0
This release adds one new resource with four new methods as described in Schema Changes.
Schema Changes
This release adds the custom_policy resource. This resource includes four new methods used to create and manage custom Product Compliance and Takeback policies:
createCustomPolicy
- This method creates a new policy of a specified type for the selected marketplace.getCustomPolicies
- This method returns all policies of the specified type(s) for the selected marketplace.getCustomPolicy
- This method returns the policy specified by policy ID for the selected marketplace.updateCustomPolicy
- This method updates a specified policy for the selected marketplace.
Note: Custom Policies are currently supported only in the following eBay marketplaces: EBAY_DE
, EBAY_CA
, EBAY_AU
, EBAY_US
, and EBAY_FR
.
Version 1.6.3
This release expands the marketplaces supported by the getRateTables method, as described below in Functionality changes.
Functionality changes
This release adds Spain (EBAY_ES
) and France (EBAY_FR
) to the list of marketplaces supported by the getRateTables method. The method now supports retrieving multi-rate tables created for the following marketplaces:
EBAY_AU
EBAY_CA
EBAY_DE
EBAY_ES
EBAY_FR
EBAY_GB
EBAY_IT
EBAY_US
Version 1.6.2
This release expands the marketplaces supported by the getRateTables method, as described below in Functionality changes.
Functionality changes
This release adds Germany (EBAY_DE
) and United Kingdom (EBAY_GB
) to the list of marketplaces supported by the getRateTables method. The method now supports retrieving multi-rate tables created for the following marketplaces:
EBAY_AU
EBAY_CA
EBAY_DE
EBAY_GB
EBAY_IT
EBAY_US
Version 1.6.1
This release adds a new enumeration value, as described below in Schema changes.
Schema Changes
This release adds a new PARTNER_MOTORS_DEALER enumeration value to the ProgramTypeEnum type. This new enumeration value allows sellers to opt-in to the Partner Motors Program, which enables registered business users to create motor vehicle listings.
Note: The Partner Motors Program is currently only supported in the UK marketplace, and sellers must complete the eBay Motors Pro registration flow in order to create motor vehicle listings.
Version 1.6.0
This release adds a new resource and method, as described below in Schema changes.
Schema Changes
This release adds a new kyc resource. This resource includes the getKYC method that allows eBay managed payments sellers to discover any 'Know Your Customer' KYC check action items.
Version 1.5.0
This release adds a new resource and method, as described below in Schema changes.
Schema Changes
This release adds a new onboarding resource to the payments_program resource. This resource includes the getPaymentsProgramOnboarding method that provides the ability to retrieves the seller's onboarding status of eBay managed payments for a specified marketplace.
Note: Managed payments availability: eBay managed payments is presently available in the US and Germany, and will roll out to Canada, UK, and Australia in July 2020.
Version 1.4.0
This release expands the marketplaces supported by getRateTables, as described below in Functionality changes.
Functionality changes
This release adds Canada (EBAY_CA
) and Italy (EBAY_IT
) to the list of marketplaces supported by getRateTables. The method now supports getting rate tables created for the following marketplaces:
EBAY_AU
EBAY_CA
EBAY_IT
EBAY_US
Note that both locales of the Canadian marketplace (en-CA
and fr-CA
) are supported by the getRateTables functionality.