listing APIv1_beta.2.0.0

Listing API release notes

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

Announcements

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

The API release history

The following table lists the releases for the Listing API:

Version Release Date Summary of Release
v1_beta.2.0.0 2019-01-21 Added a type, fields, and error message to support charitable listings.
v1_beta.1.0.0 2020-01-15 Added types, fields, and error messages to support auctions.
v1_beta.0.0.0 2019-10-30 Initial release.

 

v1_beta.2.0.0

The following changes have been made to the Listing API.

New types and fields

The following types and fields have been added.

Entity

Field/Type Name

Description

Type Charity This type is used to select a charitable organization that will receive a percentage of sale proceeds from each sale.
Request Field (Optional) charity This container is used to select a charitable organization that will receive a percentage of sale proceeds from each sale.
Request Field (Conditional) charity.charityId This field identifies the charitable organization that will receive a percentage of sale proceeds from each sale.
Request Field (Conditional) charity.donationPercentage This field sets the percentage of the sales proceeds that the charitable organization will receive from each sale.

 

New error message

The following error message has been added.

Error ID

Error Message

155017 To enable a charity donation, you must submit both 'charityId' and 'donationPercentage'.

 

v1_beta.1.0.0

The following changes have been made to the Listing API.

New types and fields

The following types and fields have been added.

Entity

Field/Type Name

Description

Type Amount The type that defines the fields for the currency and a monetary amount.
Type pricingSummary The container that for the information about the cost of an item, such as the price or auction start price.
Type ListingFormatEnum An enumerated type for the values that represent listing format.
Request Field (Optional) categoryId The ID of the leaf category associated with this item. A leaf category is the lowest level in that category and has no children.
Request Field (Optional) format The format of the listing. Valid Values: FIXED_PRICE and AUCTION
Request Field (Optional) PricingSummary.auctionReservePrice The minimum amount the seller is willing to sell the item for, so if the reserve price isn't met, the item won't be sold.
Request Field (Optional) PricingSummary.auctionStartPrice The minimum amount the seller is willing to sell the item for. If the reserve price isn't met, the item won't be sold.
Request Field (Optional) PricingSummary.price The Buy It Now Price for the item.

 

New error messages

The following error messages have been added.

Error ID

Error Message

155007 Invalid field: {fieldName}. The indicated field contains an invalid value. Correct the value and resubmit the call.
155008 The currency {currency} is not supported. The supported currency for the {marketplaceId} marketplace is {supportedCurrencyCode}.
155009 The 'auctionStartPrice' value must be less than 'auctionReservePrice' value.
155010 The 'price' value must be greater than 'auctionReservePrice' value.
155011 The 'AuctionReservePrice' value is not supported for FIXED_PRICE format.
155012 The 'price' value must be greater than 'auctionStartPrice' value.
155013 The 'AuctionStartPrice' value is not supported for FIXED_PRICE format.
155014 The 'Price' value format is a maximum of two decimal points.
155015 The 'AuctionStartPrice' value format is a maximum of two decimal points.
155016 The 'AuctionReservePrice' value format is a maximum of two decimal points.

 

v1_beta.0.0.0

This is the initial release of the Listing API. It contains the createItemDraft method that enables Partners to create an eBay listing draft for their seller using information from their site.