Managing Multi-Variation Listings

Retrieving a Listing's Variations

Use GetItem to retrieve variations (if any) that the seller included in the listing. (If the listing has no variations, the Variations node is not returned.)

eBay returns variations in the order that the seller specified them. We suggest you display them in that order, in case the seller grouped or ordered them in a logical way.

In addition, GetItem returns the full set of all possible variation specifics in VariationSpecificsSet. If you have a buying application, you can use this information to configure drop-down lists or other widgets to help buyers choose the variation they prefer. See Configuring Variation-Selection Widgets for Buyers (View Item) for more information.

Optionally, you can retrieve a subset of the available variations by specifying one or more variation specifics in the GetItem request. See the GetItem Call Reference for more information.

Buying Items in Multi-Variation Listings

In order to purchase items from a multi-variation listing, you need to specify which variation you are purchasing.

If you are using PlaceOffer, you need to specify the ItemID and the variation name (through the VariationSpecifics container) for the variation being purchased (otherwise, eBay can't uniquely identify the variation).

You can purchase multiple quantity from the same variation at the same time, just as you would for single-variation, multi-quantity, fixed-price listing. However, you can't purchase two different variations of the item at the same time (with the same purchase action).

Retrieving Order Line Items with Variations

A single order line item can include multiple quantity of the same item variation in a listing. A single order line item cannot include multiple item variations, even if they are in the same fixed-price listing.

To retrieve order line items from a multi-variation, fixed-price listing, you can pass in one or more SKU nodes in the SKUArray container of the GetSellerTransactions request, or you can you can pass in one or more SKUs in the ItemTransactionIDArray.ItemTransactionID container(s) of the GetOrderTransactions request. Each TransactionArray.Transaction.Variation container in either one of these call responses will include information about the variation that was purchased, the quantity purchased, and other details about the variation. If you're a seller, this information helps you determine which variation to ship.

If your order management application does not handle variations, you can still use TransactionPrice and other order line item-level information. However, you (or the user) may need to contact the buyer or seller to understand which variation was purchased (and which one to ship).

Monitoring Listings and Orders with Variations

GetMyeBayBuying, GetMyeBaySelling, GetSellerEvents and related calls return variations for applicable listings. Only the item variations that have activity are returned.

Platform notifications include details about variations, when applicable.

Identifying Variations in Member Messages

Member-to-member communications (such as Ask Seller a Question) occur at the Item level, not at the variation level. The member messaging API calls don't provide structured variation details in the request or response.

Buyers may optionally choose to provide information about a variation of interest in their message text.