Just getting started with the Account API v1? See the following documents for details on using this API:

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

Version 1.9.2

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.