AddLiveAuctionItem

Lists a lot item on the eBay Live Auctions site. The lot item will also be visible to users who search and browse the US eBay.com site. Only authorized eBay Live Auctions sellers can list lot items.

See:
    Introduction to Pictures in Item Listings
    AddLiveAuctionItem
    eBay Live Auctions



Back to top

Input Output Detail Controls Samples Change History Top Errors for AddLiveAuctionItem User Notes
AddLiveAuctionItem Input

The box below lists all fields that could be included in the call request. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also Samples.

See also the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are (or soon will be) non-operational.

The XML prototype may be missing some XML fields and attributes. This is a documentation limitation only (see Limitations of This Document). 

<?xml version="1.0" encoding="utf-8"?>
<AddLiveAuctionItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Standard Input Fields -->
  <ErrorHandling> ErrorHandlingCodeType </ErrorHandling>
  <ErrorLanguage> string </ErrorLanguage>
  <MessageID> string </MessageID>
  <Version> string </Version>
  <WarningLevel> WarningLevelCodeType </WarningLevel>
  <!-- Call-specific Input Fields -->
  <Item> ItemType 
    <AttributeSetArray> AttributeSetArrayType 
      <AttributeSet attributeSetID="int" attributeSetVersion="string"> AttributeSetType 
        <Attribute attributeID="int"> AttributeType 
          <Value> ValType 
            <ValueID> int </ValueID>
            <ValueLiteral> string </ValueLiteral>
          </Value>
          <!-- ... more Value nodes here ... -->
        </Attribute>
        <!-- ... more Attribute nodes here ... -->
      </AttributeSet>
      <!-- ... more AttributeSet nodes here ... -->
    </AttributeSetArray>
    <CategoryMappingAllowed> boolean </CategoryMappingAllowed>
    <Description> string </Description>
    <ItemSpecifics> NameValueListArrayType 
      <NameValueList> NameValueListType 
        <Name> string </Name>
        <Value> string </Value>
        <!-- ... more Value nodes here ... -->
      </NameValueList>
      <!-- ... more NameValueList nodes here ... -->
    </ItemSpecifics>
    <ListingEnhancement> ListingEnhancementsCodeType </ListingEnhancement>
    <!-- ... more ListingEnhancement nodes here ... -->
    <LiveAuctionDetails> LiveAuctionDetailsType 
      <HighEstimate currencyID="CurrencyCodeType"> AmountType (double) </HighEstimate>
      <LotNumber> string </LotNumber>
      <LowEstimate currencyID="CurrencyCodeType"> AmountType (double) </LowEstimate>
      <ScheduleID> int </ScheduleID>
      <UserCatalogID> int </UserCatalogID>
    </LiveAuctionDetails>
    <PictureDetails> PictureDetailsType 
      <GalleryType> GalleryTypeCodeType </GalleryType>
      <GalleryURL> anyURI </GalleryURL>
      <PictureURL> anyURI </PictureURL>
      <!-- ... more PictureURL nodes here ... -->
    </PictureDetails>
    <PrimaryCategory> CategoryType 
      <CategoryID> string </CategoryID>
    </PrimaryCategory>
    <PrivateListing> boolean </PrivateListing>
    <RelistLink> boolean </RelistLink>
    <ReservePrice currencyID="CurrencyCodeType"> AmountType (double) </ReservePrice>
    <ReturnPolicy> ReturnPolicyType 
      <Description> string </Description>
      <EAN> string </EAN>
      <RefundOption> token </RefundOption>
      <ReturnsAcceptedOption> token </ReturnsAcceptedOption>
      <ReturnsWithinOption> token </ReturnsWithinOption>
      <ShippingCostPaidByOption> token </ShippingCostPaidByOption>
      <WarrantyDurationOption> token </WarrantyDurationOption>
      <WarrantyOfferedOption> token </WarrantyOfferedOption>
      <WarrantyTypeOption> token </WarrantyTypeOption>
    </ReturnPolicy>
    <SecondaryCategory> CategoryType 
      <CategoryID> string </CategoryID>
    </SecondaryCategory>
    <Site> SiteCodeType </Site>
    <SKU> SKUType (string) </SKU>
    <StartPrice currencyID="CurrencyCodeType"> AmountType (double) </StartPrice>
    <SubTitle> string </SubTitle>
    <Title> string </Title>
    <UUID> UUIDType (string) </UUID>
  </Item>
</AddLiveAuctionItemRequest>
Argument Type Reqd? Meaning
Standard Input Fields   [Jump to call-specific fields]
ErrorHandling ErrorHandlingCodeType Optional Error tolerance level for the call. This is a preference that specifies how eBay should handle requests that contain invalid data or that could partially fail. This gives you some control over whether eBay returns warnings or blocking errors and how eBay processes the invalid data.

For AddItem and related calls, this field is only applicable when the listing includes Item Specifics and Pre-filled Item Information (such as AttributeSetArray and ProductListingDetails).
Default: BestEffort.

Applicable values:

•   AllOrNothing

(in) If any attribute data is invalid, drop the entire attribute set and proceed with listing the item. If the category has required attributes and the attribute set is dropped, reject the listing.

•   BestEffort

(in) Drop the invalid data, continue processing the request with the valid data. If dropping the invalid data leaves the request in a state where required data is missing, reject the request.

If BestEffort is specified for CompleteSale, the Ack field in the response could return PartialFailure if one change fails but another succeeds. For example, if the seller attempts to leave feedback twice for the same transaction, the feedback changes would fail but any paid or shipped status changes would succeed.

•   FailOnError

(in) If any data is invalid, reject the request.

•   Legacy

(in) Apply validation rules that were in effect prior to the time the call started supporting ErrorHandling.




See Attribute Error Handling.
ErrorLanguage string Optional Use ErrorLanguage to return error strings for the call in a different language from the language commonly associated with the site that the requesting user is registered with. Specify the standard RFC 3066 language identification tag (e.g., en_US).
ID--- country
----- -----
de_AT Austria
de_CH Switzerland
de_DE Germany
en_AU Australia
en_CA Canada
en_GB United Kingdom
en_SG Singapore
en_US United States
es_ES Spain
fr_BE Belgium (French)
fr_CA Canada (French)
fr_FR France
it_IT Italy
nl_BE Belgium (Dutch)
nl_NL Netherlands
zh_CN China
en_IN India
en_IE Ireland
zh_HK Hong Kong

See Tags for the Identification of Languages.
MessageID string Optional In most cases, all calls support a MessageID element in the request and a CorrelationID element in the response. If you pass a message ID in a request, we will return the same value in CorrelationID in the response. You can use this for tracking that a response is returned for every request and to match particular responses to particular requests. If you do not pass MessageID in the request, CorrelationID is not returned.

Note: GetCategories, GetAttributesCS, GetCategory2CS, GetAttributesXSL, GetProductFinder, GetProductFinderXSL, and GetProductSearchPage are designed to retrieve very large sets of metadata that change once a day or less often. To improve performance, these calls return cached responses when you request all available data (with no filters). When this occurs, the MessageID and CorrelationID fields aren't applicable. However, if you specify an input filter to reduce the amount of data returned, the calls retrieve the latest data (not cached). When this occurs, MessageID and CorrelationID are applicable.
Version string Conditional The version number of the API code that you are programming against (e.g., 549). The version you specify for a call has these basic effects:
- It indicates the version of the code lists and other data that eBay should use to process your request.
- It indicates the schema version you are using.
You need to use a version that is greater than or equal to the lowest supported version.

For the SOAP API: If you are using the SOAP API, this field is required. Specify the version of the WSDL your application is using.

For the XML API: If you are using the XML API, this field has no effect. Instead, specify the version in the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header. (If you specify Version in the body of an XML API request and it is different from the value in the HTTP header, eBay returns an informational warning that the value in the HTTP header was used instead.)

See:
    HTTP Headers (XML API Only)
    eBay Schema Versioning Strategy
    Lowest Supported Version
WarningLevel WarningLevelCodeType Optional Controls whether or not to return warnings when the application passes unrecognized or deprecated elements in a request.

An unrecognized element is one that is not defined in any supported version of the schema. Schema element names are case-sensitive, so using WarningLevel can also help you remove any potential hidden bugs within your application due to incorrect case or spelling in field names before you put your application into the Production environment.

WarningLevel only validates elements; it doesn't validate XML attributes. It also doesn't control warnings related to user-entered strings or numbers, or warnings for logical errors.

We recommend that you only use this during development and debugging. Do not use this in requests in your production code.

Applicable values:

•   High

(in) Return warnings when the application passes unrecognized or deprecated elements in a request.

•   Low

(in) Do not return warnings when the application passes unrecognized or deprecated elements in a request. This is the default value if WarningLevel is not specified.




See Warning Level.
Call-specific Input Fields
Item ItemType Required Specifies the values that define the new lot item. Item is a required input.
Item.AttributeSetArray AttributeSetArrayType Conditional Item Specifics (such as new or used condition) in a listing. Item Specifics (attributes) describe category-specific aspects or features of an item in a standardized way. Carries one or more instances of AttributeSet in a list. For ID-based attributes in general, an item will be associated with no more than two full attribute sets (one for the primary category and one for the secondary category). For some international sites, an item can specify an additional site-wide attribute set for the item condition.

Older applications can still use AttributeSetArray to specify a return policy (which is defined in a site-wide attribute set for most sites). However, as eBay may deprecate return policy attributes in 2009, we strongly recommend that you begin using the new Item.ReturnPolicy node instead to specify the seller's return policy.

Please note that AttributeSetArray does not support the new "custom Item Specifics" model. See the ItemSpecifics node instead.

For the AddItem family of calls: Some categories (such as Event Tickets and US Real Estate) require Item Specifics. See the eBay Web Services Guide links below for information on working with Item Specifics. Use GetCategory2CS and GetAttributesCS to determine when attributes are required for a category. Also use attributes to specify the item condition.

For a listing to be eligible for eBay Express, the item condition is required in most cases. Use GetCategoryFeatures to determine which categories are exempt from this requirement. See the eBay Web Services Guide links below for details.

For ReviseItem only: When you revise a listing, if the listing has bids and ends within 12 hours, you cannot change or add attributes. If the listing has bids but ends in more than 12 hours, you cannot change existing attribute data, but you can add attributes that were not previously specified. The most reliable way to do this is to pass in the entire AttributeSetArray with all the attributes you want in the listing (not just the ones you want to change, because that usually causes the others to be removed). To delete all attributes when you revise or relist, specify Item.AttributeSetArray in DeletedField and don't pass AttributeSetArray in the request. If the original listing's attributes are no longer valid and you get errors when you try to revise the listing, you can try to pass in the entire AttributeSetArray again with corrections. If that doesn't work, you can end the item and relist it with a set of valid attributes.

For AddLiveAuctionItem and ReviseLiveAuctionItem only: For AddLiveAuctionItem and ReviseLiveAuctionItem, specify a maximum of one AttributeSet for Item Specifics that are associated with SecondaryCategory (a US eBay site category), plus any number of additional AttributeSet properties for site-wide attributes that are applicable to the US eBay site.

For GetCategoryListings only: For GetCategoryListings, AttributeSetArray can return the item condition (not other Item Specifics), if specified.

For GetSearchResults only: GetSearchResults can return the item condition when the request either specifies IncludeCondition as true; or specifies a product finder search (and a detail level of ItemReturnAttributes or ReturnAll). If IncludeCondition was true, see the ItemSpecific node for a simpler view of the condition value.
Note: AttributeSetArray only returns the condition attribute's ValueID. You would need to use GetAttributesCS to figure out the meaning of this ID. It's easier to just look at the ItemSpecific node.
If SearchRequest or TicketFinder was used to perform a product finder search, the list of attributes is limited to Item Specifics that would be included in the summary search results on the Web site, if any. At this time, GetSearchResults only returns event ticket venue name, section, and row (if specified) for eBay US (site 0); and the mileage and year for eBay Motors vehicles (site 100 and international eBay Motors sites that support this feature). In other categories, no summary attributes are returned in search results (even when the item is listed with Item Specifics.)

For GetItemRecommendations only: In GetItemRecommendations, if you use the Suggested Attributes engine, the engine interprets attributes you pass in as attributes that do NOT need recommendations (i.e., attributes that the seller has already filled in as desired). The engine only returns recommendations for attributes that you do not specify, and only for attributes associated with the primary category.

For Half.com, this is only returned in GetItem. It is not applicable in AddItem and other requests.

See:
    Working with Attribute-Based Features
    Specifying an Item's Condition
    Offering a Clear Return Policy
    (AddItem) Item.ReturnPolicy
    Specify the Item Condition for Express and eBay
    eBay Live Auctions
    Revising Items that Include Item Specifics (Attributes)
    Relisting Items that Include Item Specifics (Attributes)
Item.AttributeSetArray
  .AttributeSet 		AttributeSetType
(repeatable)		 Conditional Contains a list of attributes that describe category-specific aspects or features of an item in a standardized way.

For the AddItem family of calls and GetItem, an AttributeSetArray can contain a maximum of 2 full attribute sets (one for each category in which the item is listed) if the primary and secondary categories are mapped to different characteristic sets. If they are mapped to the same characteristic set, the AttributeSetArray can contain one full attribute set.

An AttributeSetArray can also contain any number of additional site-wide attribute sets. In item-listing requests, AttributeSet is required if the category is mapped to a characteristic set with required attributes. On the US site, attributes are usually required for Tickets, eBay Motors vehicles, and Real Estate listings. See GetCategory2CS and GetAttributesCS. See the Developer's Guide for information about attribute meta-data and validation rules that are applicable when listing items.

In GetItem, the Half.com item condition may be returned once in an AttributeSet node with Half.com IDs and values, and once in a separate AttributeSet node with a site-wide eBay item condition. The Half.com IDs are not necessarily returned in GetAttributesCS, so you can use the eBay.com data instead. Half.com listings may also return an AttributeSet node with other eBay attributes.
Item.AttributeSetArray
  .AttributeSet
  [ attribute attributeSetID ]		 int Conditional Constant value that identifies the attribute set in a language-independent way. Unique across all eBay sites. Corresponds to a characteristics set ID. Call GetCategory2CS to determine valid characteristics set IDs. For GetCategoryListings, you can ignore this value. Not applicable to Half.com.
Item.AttributeSetArray
  .AttributeSet
  [ attribute attributeSetVersion ]		 string Conditional Version of the attribute set being specified (in requests) or that is currently on the site. This value changes each time changes are made to the category-to-characteristic set mappings or characteristic set data. The current version value is not necessarily greater than the previous value. Therefore, when comparing versions, only compare whether the value has changed.

In listing requests, if you do not specify this value, eBay assumes you are using the current attribute set version. If you specify the version number of the attribute meta-data that you have stored locally, eBay will compare it to the current version on the site and return a warning if the versions do not match. If an error occurs due to invalid attribute data, this warning can be useful to help you determine if you might be sending outdated data. Not applicable to Half.com.
Item.AttributeSetArray
  .AttributeSet.Attribute 		AttributeType
(repeatable)		 Conditional A salient aspect or feature of an item in a given category. Attributes are known as "Item Specifics" in the eBay Web site. Use attributes to describe an item in a standard way so that buyers can find it more easily. For example, "Publication Year" is a standard attribute for books. In item-listing requests, multiple attributes can be specified. Some categories (e.g., Tickets) always require certain attributes to be specified. Therefore, in item-listing requests you need to at least specify "editable" attributes (EditType 0 and EditType 2 attributes) if they are identified as required in the attribute meta-data. See the eBay Web Services guide for information about attrribute meta-data, how to determine the valid attributes for a category, and how to determine whether attributes are required.

If you are revising or relisting an item, you don't need to pass in attributes that were already specified in the original listing. To remove an optional attribute, set all its value IDs to "-100". If the item has bids (or items have been sold) but there are more than 12 hours remaining until the listing ends, you can add Attribute nodes but you cannot remove or modify data in previously specified Attribute nodes. If the item has bids and the listing ends within 12 hours, you cannot add or remove Attribute nodes or modify the contents of previously specified Attribute nodes.

For GetCategoryListings, this returns the item condition only (and it is only returned if IncludeCondition = true in the request). Not applicable to Half.com.
Item.AttributeSetArray
  .AttributeSet.Attribute
  [ attribute attributeID ]		 int Conditional Constant value that identifies the attribute in a language-independent way. Unique within the attribute set. See the Developer's Guide topics on Item Specifics and Pre-filled Item Information for information about determining valid attribute IDs. Not applicable to Half.com.
Item.AttributeSetArray
  .AttributeSet.Attribute.Value 		ValType
(repeatable)		 Conditional A value the seller selected or entered for the attribute. At least one value is required for each Attribute that you specify. Some attributes can have multiple values. See the eBay Web Services guide sections on Item Specifics (Attributes) and Pre-filled Item Information (Catalogs) for information about using GetAttributesCS to determine valid attribute values.

For eBay.com listings, use AttributeSetArray.AttributeSet.Attribute.Value. For Half.com, use AttributeArray.Attribute.Value. That is, the parent elements and usage for Half.com differs from eBay's standard Item Specifics format (and there is no relationship to GetAttributesCS). For Half.com, this does not use the same Attributes logic as eBay's Item Specifics. For Half.com, AttributeArray.Attribute.Value is required when you use AddItem. see the eBay Web Services Guide for valid values. You can revise AttributeArray.Attribute.Value for Half.com listings.
Item.AttributeSetArray
  .AttributeSet.Attribute.Value
  .ValueID 		int Conditional Constant value that identifies the attribute or characteristic in a language-independent way. Unique within the characteristic set.

In item-listing requests, if the ID is defined as -3 or -6 (Other) in GetAttributesCS or GetProductSellingPages, use ValueLiteral to specify the string value that the user entered. Otherwise, use ValueID to specify the ID that is pre-defined in GetAttributesCS or GetProductSellingPages. In item-listing requests and product searches, the possible ID values are:
-3 = User entered an arbitrary value (not an "Other" field)
-6 = User entered a value in an "Other" field
-100 = Value not specified (null)
#### (integer) = Identifier for a pre-defined value that the user selected (e.g., -14 or 1001)
For eBay.com, required if ValueList is specified. Not applicable to Half.com.

See Attribute Elements.
Item.AttributeSetArray
  .AttributeSet.Attribute.Value
  .ValueLiteral 		string Conditional The descriptive name of an attribute or characteristic value (e.g., "New" might be a literal value for a Condition attribute). In item-listing requests, if you send ValueID with an id of -3 or -6, you must use ValueLiteral to enter the value the user specified. Otherwise, eBay treats the request as if no value was sent at all. For eBay.com listings, use AttributeSetArray.AttributeSet.Attribute.Value.ValueLiteral. The max length allowed varies per attribute.

For GetSearchResults requests (in SearchRequest), only use ValueLiteral for attributes that support free-text values. That is, if eBay defines a value name and a unique value ID for an attribute in GetProductFinder, do not pass the name in ValueLiteral (because it won't work). Instead, specify the unique value ID in ValueID.

For Half.com, use AttributeArray.Attribute.Value.ValueLiteral in listing requests. That is, the parent elements and usage for Half.com differs from eBay's standard Item Specifics format (and there is no relationship to GetAttributesCS). For Half.com, AttributeArray.Attribute.Value.ValueLiteral is required when you use AddItem. See the eBay Web Services Guide for valid values. For the Half.com Notes attribute, the max length is 500 characters. You can revise AttributeArray.Attribute.Value.ValueLiteral for Half.com listings.
Max length: see description.
Item.CategoryMappingAllowed boolean Optional Controls how eBay handles cases in which an ID specified in PrimaryCategory and/or SecondaryCategory no longer exists in the current category structure: If you pass a value of true in CategoryMappingAllowed, eBay will look up the current ID that is mapped to the same category and use the new ID for the listing (if any). The new ID will be returned in the response as CategoryID (for the primary category) or Category2ID (for the secondary category). If CategoryMappingAllowed is not set or contains a value of "false" (the default), an error will be returned if a selected category ID no longer exists. Not applicable to Half.com.

See Mapping Old Category IDs to Current IDs.
Item.Description string Conditional Description of the item. In listing requests, you can submit your description using CDATA if you want to use HTML or XML-reserved characters in the description. An error is returned if this contains malicious JavaScript content. (For related eBay policy, see http://pages.ebay.com/help/policies/listing-javascript.html.)

The Description field is required for all listings, except certain listings that include Pre-filled Item Information. (See "About the Pre- filled Item Information API." in the eBay Web Services Guide.) Even if your application does not support listings items with Pre-filled Item Information, you should be aware that this also means GetItem, GetSellerList, and GetBidderList may return some items with empty Description fields.

If you embed pictures in the description (by using IMG tags) instead of using PictureURL, but you want a camera icon to appear in search and listing pages, specify the following null-image URL in PictureURL: http://pics.ebay.com/aw/pics/dot_clear.gif. See "Including Pictures in an Item Listing" in the eBay Web Services Guide.

For eBay Live Auctions listings, JavaScript is not allowed.

Not applicable to Half.com. (For Half.com, use AttributeArray.Attribute with attributeLabel="Notes" to specify a brief description or note to the buyer.)
Max length: 500000 (some sites may allow more, but the exact number may vary).
Item.ItemSpecifics NameValueListArrayType Optional A list of attribute or Item Specific name and value pairs that the seller specified for the item.

In the AddItem family of calls, use this for specifying custom Item Specifics. (If you are including an Item Condition, use AttributeSetArray instead. You can use AttributeSetArray for the condition and ItemSpecifics for the custom Item Specifics.)

To determine which categories support custom Item Specifics, use GetCategoryFeatures.

Note: If you are trying to list with ID-based attributes from GetAttributesCS or GetProductSellingPages, use AttributeSetArray instead.

To retrieve recommended Item Specifics, use GetCategorySpecifics or GetItemRecommendations.

In GetItemRecommendations, pass in the PrimaryCategory and (optionally) Title to retrieve recommended names and values.

With GetItem, this is only returned when you specify IncludeItemSpecifics in the request (and the seller included custom Item Specifics in their listing).

For ReviseItem only: When you revise a listing, if the listing has bids and ends within 12 hours, you cannot change or add Item Specifics. If the listing has bids but ends in more than 12 hours, you cannot change existing Item Specifics, but you can add Item Specifics that were not previously specified.

To delete all Item Specifics when you revise or relist, specify Item.ItemSpecifics in DeletedField and don't pass ItemSpecifics in the request.

With GetProducts, only the item condition is returned at the item level. Additional attributes that were pre-filled from the catalog are returned in Product.ItemSpecifics.

See:
    Working with Custom Item Specifics
    (GetProducts) Product.ItemSpecifics
Item.ItemSpecifics
  .NameValueList 		NameValueListType
(repeatable)		 Conditional Contains the name of an Item Specific, and one or more corresponding values, if any.

In the AddItem family of calls, this is only required when the ItemSpecifics container is specified.

In GetSearchResults, GetSearchResultsExpress, GetProducts, GetCategorySpecifics, (and soon in GetItem), this is only returned when the ItemSpecifics (or ItemSpecific) node is returned.
Item.ItemSpecifics
  .NameValueList.Name 		string Optional A name in a name/value pair.

In the AddItem family of calls, this can be any name that the seller wants to use. However, to help buyers find items more easily, it is a good idea to try to use a recommended name when possible (see GetCategorySpecifics or GetItemRecommendations). You cannot specify the same name twice within the same listing.

In the GetCategorySpecifics and GetItemRecommendations response, this is a recommended (popular) name to use for items in the specified category (e.g., "Brand" might be recommended, not "Manufacturer").

In the GetSearchResults response, this is an attribute name that was used in a listing. Specifically: If SearchRequest was used to perform a "Product Finder" search, this contains the name of one attribute (i.e, the name of one Item Specifics field). If IncludeCondition was true in the request, this returns the condition attribute name (e.g., "Item Condition").

In the GetSearchResultsExpress response, this is an attribute name that is defined for a catalog product. Only returned when ProductDetails is set to Fine.

In the GetProducts response, this is an attribute name that is defined for a catalog product.
Item.ItemSpecifics
  .NameValueList.Value 		string
(repeatable)		 Optional A value associated with the name.

In the GetCategorySpecifics and GetItemRecommendations response, the most highly recommended values are returned first. For these calls, Value is only returned when recommended values are available.

In the AddItem family of calls, you can only specify one value per Item Specific. (If you specify multiple values, eBay only stores the first one.)

In the GetSearchResults response, if SearchRequest was used to perform a "Product Finder" search, this contains the value of one attribute. If IncludeCondition was true in the request, this returns the condition attribute value (e.g., "New").

In the GetSearchResultsExpress response, this is only returned when ProductDetails is set to Fine.
Max length: 50 (see GeteBayDetails).
Item.ListingEnhancement ListingEnhancementsCodeType
(repeatable)		 Optional Describes listing upgrades that sellers can select for a fee, such as the BoldTitle upgrade. Also includes feature packs for saving on listing upgrades. See Listing Upgrades in the eBay Web site online help.

You cannot remove listing upgrades when you revise a listing. When you relist an item, use DeletedField to remove a listing upgrades.

For AddLiveAuctionItem and ReviseLiveAuctionItem, you can specify a maximum of 10 featured lot items per live auction catalog. Not applicable to Half.com. This field is ignored when Item.ListingType=Express.

Applicable values:

•   BoldTitle

(in/out) If specified, the seller wants the title for the item's listing to be in boldface type. Applicable listing fees apply. Does not affect the item subtitle (Item.SubTitle), if any. Not applicable to eBay Motors.

•   Border

(in/out) If specified, the seller wants the item to be displayed with a border that goes around the item in search result pages that return multiple items. The border differentiates the item from other items in the list. Applicable listing fees apply.

•   Featured

(in/out) Listing is a "Featured Plus" item. The item will display prominently in the Featured Items section of its category list, and it will stand out on search results pages. It will also display in the regular, non-featured item list. Only available to users with a Feedback rating of 10 or greater.

•   Highlight

(in/out) Listing is highlighted in a different color in lists.

•   HomePageFeatured

(in/out) Listing will have a chance to rotate into a special display on eBay's Home page. Your item is very likely to show up on the Home page, although eBay does not guarantee that your item will be highlighted in this way. This is the highest level of visibility on eBay.

Not applicable for eBay Motors (SiteId 100). In order to feature the listing on eBay Motors home page, use PictureDetails.GalleryType.Featured instead. See GalleryTypeCodeType for more information.


(Not all values in ListingEnhancementsCodeType apply to this field.)
Item.LiveAuctionDetails LiveAuctionDetailsType Required Describes the live auction-specific details of a lot item. Applicable to eBay Live Auctions only.
Item.LiveAuctionDetails
  .HighEstimate 		AmountType (double) Required Highest appraised value for the item. Must be greater than zero and greater than the value in LowEstimate. (Pass an integer value only, not a double.)
Item.LiveAuctionDetails
  .HighEstimate
  [ attribute currencyID ]		 CurrencyCodeType Optional Currency in which the monetary amount is specified.

In the AddItem family of calls, the currency can be specified in the Item.Currency field instead. If you do specify this attribute in the AddItem family of calls, the value must match the site currency (i.e., it must be the same as the value in Item.Currency) unless otherwise stated.

For a list of possible enumeration values, see CurrencyCodeType.
Item.LiveAuctionDetails
  .LotNumber 		string Required Lot number defined by the seller. Each lot number must be unique within the schedule. A lot number can consist of 1-10 alphanumeric characters beginning with a number from 0-9. If all values are numbers, the highest allowed value is 2147483647.
Item.LiveAuctionDetails
  .LowEstimate 		AmountType (double) Required Lowest appraised value for the item. Must be greater than zero and less than the value in HighEstimate. (Pass an integer value only, not a double.)
Item.LiveAuctionDetails
  .LowEstimate
  [ attribute currencyID ]		 CurrencyCodeType Optional Currency in which the monetary amount is specified.

In the AddItem family of calls, the currency can be specified in the Item.Currency field instead. If you do specify this attribute in the AddItem family of calls, the value must match the site currency (i.e., it must be the same as the value in Item.Currency) unless otherwise stated.

For a list of possible enumeration values, see CurrencyCodeType.
Item.LiveAuctionDetails
  .ScheduleID 		int Required Number that identifies the sale schedule for the lot. The schedule ID must be for a pending sale associated with the catalog identified in UserCatalogID. Call GetLiveAuctionCatalogDetails to determine the valid schedule IDs for the catalog.
Item.LiveAuctionDetails
  .UserCatalogID 		int Required Number that identifies the seller's eBay Live Auctions catalog within which the lot item will be listed. Use GetLiveAuctionCatalogDetails to determine the seller's available catalog IDs.
Item.PictureDetails PictureDetailsType Optional Contains the data for a picture associated with an item.

For a listing to be eligible for eBay Express, it must include a picture, gallery, or stock photo URL. Some categories are exempt from this requirement. See the eBay Web Services Guide links below for details.

Not applicable to Half.com.

Note: PictureDetails replaces the deprecated SiteHostedPicture and VendorHostedPicture in the response with request version 439 or greater. As SiteHostedPicture and VendorHostedPicture are also no longer recommended on input, applications should use PictureDetails in the input as well. If SiteHostedPicture or VendorHostedPicture are passed in with PictureDetails, PictureDetails takes precedence.

See:
    Introduction to Pictures in Item Listings
    Specify a Picture for Express and eBay
Item.PictureDetails
  .GalleryType 		GalleryTypeCodeType Conditional Indicates whether listing images are included in the search results (in both Picture Gallery and List Views) and, if so, which image listing enhancements apply to them. Items that have pictures but do not have image listing enhancements display a generic photo image in search results.

If the value is Gallery, Plus, or Featured, eBay checks the available image URLs in the following order to determine which URL to use (if more than one of these URLs is available):

a) Use the URL in GalleryURL, if it is specified.
b) Otherwise, if ProductListingDetails.UseStockPhotoURLAsGallery is true, use the eBay stock photo.
c) Otherwise, use the value of the first PictureURL in the array of PictureURL fields, if any.
d) Otherwise, if ProductListingDetails.ProductID is specified, use the eBay stock photo for that ProductID (eBay resets UseStockPhotoURLAsGallery to true in this case).
e) If eBay is unable to find an image URL for the listing, an error is returned.

Note that you can use the Gallery Plus feature whether or not the image is hosted with eBay Picture Services (EPS). Selecting Gallery Plus does not incur a separate Gallery fee.

See "Describing Items in a Listing" in the eBay Web Services Guide for additional information about working with pictures and related validation rules.

You cannot remove Gallery, Plus, or Featured when revising or relisting, however you can upgrade to a higher feature. On upgrade, the original feature fee is credited, and the new feature fee is charged.

There are a number of categories on some eBay sites that always offer the Gallery feature for free. (The API doesn't flag these categories in any meta-data calls.) In these categories, if you specify a picture and you don't specify GalleryType, eBay may add GalleryType=Gallery to the listing (for free) and return a warning (error code 219243). The Knowledge Base explains an edge case that could result in an unexpected gallery fee if the seller moves the item to a category that doesn't offer the free gallery feature. This fee can also appear when if the seller moves the item from a site that offers free Gallery (across all its categories) to one where free Gallery is not yet available. Whenever you change the primary category, it is a good idea to clearly specify whether the seller is intentionally requesting the gallery option.

Note: As of 02-20-2008, the following sites offer free Gallery: US (site ID 0), Parts & Accessories Category on US Motors (site ID 100), CA (site ID 2), CAFR (site ID 210), FR (site ID 71) and NL (site ID 146). Additionally, ES (site ID 186) and IT (site ID 101) offer free Gallery as of 03-03-2008.

On these sites, eBay will automatically create a Gallery thumbnail for the listing in search results by selecting a picture from one of the image URLs specified in the request (either Item.PictureDetails.PictureURL or Item.PictureDetails.GalleryURL) or from an available stock photo. Thus, a Gallery thumbnail will be created whenever Item.PictureDetails.GalleryType is None or is not specified in the request. A Gallery fee will apply whenever GalleryType specifies the Plus or Featured image enhancements (there will be no Gallery fee whenever GalleryType is Gallery, None or is not specified in the request).

eBay will select the image for the thumbnail depending on which of the image URLs above was specified in the request (there are selection rules for four cases). Note that the selected image will not necessarily be the image you have specified in Item.PictureDetails.GalleryURL. Note that a Gallery thumbnail will not be automatically created if PictureURL and GalleryURL are not supplied and UseStockPhotoURLAsGallery and IncludeStockURL are set to false.

The most common case occurs when both GalleryURL and PictureURL are specified in the request. eBay will use the image referenced by PictureURL as the Gallery thumbnail. As three other cases exist, please refer to "Using Gallery Features on Sites with Free Gallery" in the eBay Web Services Guide for complete information on how eBay selects an image for the gallery thumbnail on these sites.

You cannot remove Gallery or Featured when revising or relisting, however you can upgrade to a higher feature. On upgrade, the original feature fee is credited, and the new feature fee is charged. (This does not apply to Gallery Plus on sites with free Gallery; see Plus below for more information.)

Applicable values:

•   CustomCode

(in/out) Reserved for internal or future use.

•   Featured

(in/out) Listing is highlighted and included at the top of search results.

When "Featured" is included in an item listing, the listing also automatically gets the Gallery and Gallery Plus functionality. "Gallery" and "Plus" do not need to be specified separately in the listing. Passing "Featured", "Plus", and "Gallery" in the same request will return an error.

For eBay Motors (SiteId 100), this may also feature certain items on the eBay Motors home page.

Not applicable to eBay Stores Inventory listings.

Note: Gallery Featured is known as Featured First on the Italy site.

•   Gallery

(in/out) Listing image is included in the search results (in both Picture Gallery and List Views). Items that have pictures but do not have the Gallery feature will have a generic photo image shown in search results.

Some listing enhancements (for example, "Featured" and "Plus") automatically include the Gallery functionality, so "Gallery" does not need to be specified separately in the listing. Passing "Featured", "Plus", and "Gallery" in the same request will return an error.

•   None

(in/out) Listing image is not included in the search results (in either Picture Gallery or List Views), and no other image listing enhancements apply. Items that have pictures but do not have image listing enhancements display a generic photo image in search results.

Mainly useful for RelistItem use cases when you want to remove an existing gallery setting. However, not all image listing enhancements can be removed on revise or relist.

Note that specifying None is not necessarily the same as omitting GalleryType from a request. For example, specifying other item properties may cause the listing to be included in the search results Gallery by default if GalleryType is not specified.

•   Plus

(in/out) Listing image has Gallery Plus funtionality. That is, listing includes a Gallery Plus icon that, when moused over or clicked, displays a large (400 px x 400 px) preview image of the item. Clicking the image displays the View Item page for that listing.

Listing images that are originally smaller than 400 px x 400 px are centered in the preview frame. Images that are originally larger than 400 px x 400 px are scaled down to 400 px on their longest side (maintaining their original aspect ratio).

Note that you can use the Gallery Plus feature whether or not the image is hosted with eBay Picture Services (EPS). One EPS image is included at no cost with the Gallery Plus feature.

When "Plus" is included in an item listing, the listing also automatically gets the Gallery functionality at no extra cost. "Gallery" does not need to be specified separately in the listing. Passing "Featured", "Plus", and "Gallery" in the same request will return an error.

Note: As of 02-20-2008, the following sites offer free Gallery: US (site ID 0), Parts & Accessories Category on US Motors (site ID 100), CA (site ID 2), CAFR (site ID 210), FR (site ID 71) and NL (site ID 146). Additionally, ES (site ID 186) and IT (site ID 101) offer free Gallery as of 03-03-2008.

On these sites (starting on the same production date), whenever Plus is selected in a request that specifies at least two eBay Picture Services (EPS) hosted images (using ItemType.PictureDetailsType.PictureURL), the Gallery Plus feature now automatically includes a Gallery Showcase of all the listing's images at no extra cost. If Plus is selected and the request includes only one EPS image or any self-hosted images, regular Gallery Plus applies.

The Gallery Showcase displays when mousing over or clicking on the listing's Gallery Plus icon in the search results. The Showcase window displays a large (400 px x 400 px) preview image which is usually the first specified PictureURL, as well as up to four (64 px x 64 px) selectable thumbnails for the remaining EPS images (the Showcase window contains pagination controls for observing all EPS images in the request). Clicking on the preview image displays the item's listing page.

When using RelistItem or ReviseItem (item has no bids and more than 12 hours before the listing's end), Plus can be unselected in the request. However, the Plus fee will still apply if a previous request selected Plus. There is at most one Plus fee per listing.

Not applicable to eBay Stores Inventory listings.




See:
    Introduction to Pictures in Item Listings
    Using Gallery Features on Sites with Free Gallery for complete details on how eBay selects a gallery thumbnail.
    KB article: Why am I getting charged a GalleryFee in my RelistItem call...?
Item.PictureDetails.GalleryURL anyURI Conditional URL for a picture to be used as the Gallery thumbnail. Ignored if GalleryType is None or unspecified. If the value of GalleryType is Gallery or Featured, you can either specify GalleryURL or allow eBay to use another picture that you have included in the listing.

Note: As of 02-20-2008, the following sites offer free Gallery: US (site ID 0), Parts & Accessories Category on US Motors (site ID 100), CA (site ID 2), CAFR (site ID 210), FR (site ID 71) and NL (site ID 146). Additionally, ES (site ID 186) and IT (site ID 101) offer free Gallery as of 03-03-2008.

On these sites, eBay selects a Gallery thumbnail from image URLs included in the request (i.e. either GalleryURL or the first PictureURL), using selection rules that consider which of these URLs has been specified and whether an eBay stock photo exists for the item. Note that the selected gallery thumbnail may not necessarily be the one you specify using GalleryURL. Also, eBay selects an image regardless of whether you have specified either GalleryType or GalleryURL. A stock photo will not be generated for an item unless UseStockPhotoURLAsGallery and IncludeStockPhotoURL are set to true. Therefore, in this case, an item that does not have a PictureURL will not have a Gallery picture. A Gallery fee will only apply if you have set GalleryType to Plus or Featured (as basic Gallery is free). For more information on eBay's selection rules for the gallery thumbnail on sites with free Gallery, see "Using Gallery Features on Sites with Free Gallery" in the eBay Web Services Guide.

(See GalleryType for the rules that determine which URL is used if you do not specify GalleryURL on sites where free Gallery is currently not available.) The image used for the Gallery thumbnail must be in one of the graphics formats JPEG, BMP, TIF, or GIF. See "Describing Items in a Listing" in the eBay Web Services Guide for additional validation rules. For eBay Live Auctions, lots are listed in the gallery for free. To remove GalleryURL when revising or relisting an item, use DeletedField. When you revise an item, you can only remove GalleryURL if the item has at least one PictureURL or a stock photo to use instead. If the item has bids (or items have been sold) or the listing ends within 12 hours, you can add GalleryURL or change its value, but you cannot remove the gallery URL value if it was previously specified. Not applicable to eBay Motors listings.
Max length: 1024.

See:
    Introduction to Pictures in Item Listings
    Using Gallery Features on Sites with Free Gallery for complete details on how eBay selects a gallery thumbnail.
    (ReviseItem) DeletedField
Item.PictureDetails.PictureURL anyURI
(repeatable)		 Conditional Note: As of 02-20-2008, the following sites offer free Gallery: US (site ID 0), Parts & Accessories Category on US Motors (site ID 100), CA (site ID 2), CAFR (site ID 210), FR (site ID 71) and NL (site ID 146). Additionally, ES (site ID 186) and IT (site ID 101) offer free Gallery as of 03-03-2008.

On these sites, eBay selects a Gallery thumbnail from image URLs included in the request (i.e. either GalleryURL or the first PictureURL), using selection rules that consider which of these URLs has been specified and whether an eBay stock photo exists for the item. Also, eBay selects an image regardless of whether you have specified either GalleryType or GalleryURL. A stock photo will not be generated for an item unless UseStockPhotoURLAsGallery and IncludeStockPhotoURL are set to true. Therefore, in this case, an item that does not have a PictureURL will not have a Gallery picture. A Gallery fee will only apply if you have set GalleryType to Plus or Featured (as basic Gallery is free). As a result of these changes, the top of an item's listing page may not necessarily be the image you have specified in PictureURL for certain scenarios. For more information on eBay's selection rules for the gallery thumbnail on sites with free Gallery, see "Using Gallery Features on Sites with Free Gallery" in the eBay Web Services Guide.

Contains the URL for an image associated with the item. Images can be hosted by eBay Picture Services (EPS) (or by eBay Picture Manager) or they can be self-hosted. Some options are only available if images are hosted through eBay Picture Services (EPS). eBay determines this by parsing the associated PictureURL value. If specified, this cannot have an empty/null value.

To specify multiple pictures, send each URL in a separate, adjacent PictureURL element. In most cases, the image at the first URL is also used for the picture at the top of the View Item page on the Web site.

On the main eBay site, a listing can have a maximum of 12 picture URLs hosted by eBay Picture Services or a maximum of 6 picture URLs hosted by a third-party vendor. If you specify multiple vendor-hosted pictures in listing calls, PhotoDisplay must be set to VendorHostedPictureShow. You cannot mix vendor-hosted and site-hosted pictures within the same listing.

On the US eBay Motors site (for all vehicle listings), and on the eBay Canada site for motors, the picture pack of a listing can contain up to 24 photos.

On the eBay Live Auctions site, a listing can have a maximum of 5 picture URLs hosted by eBay Picture Services or a third party.

If you embed pictures in the description (by using IMG tags) instead of using PictureURL, but you want a camera icon to appear in search and listing pages, specify the following "clear image" URL in PictureURL: http://pics.ebay.com/aw/pics/dot_clear.gif. This clear image is not supported for eBay Express.

Note: On sites that offer free Gallery, the camera icon will not be available to appear as a gallery thumbnail or in a listing page whenever the first PictureURL field in the request is set to the "clear image" URL. In this case, eBay will attempt to use the image referenced by GalleryURL as the gallery thumbnail. If GalleryURL has not been specified, a blank (camera-less) gallery thumbnail displays in the search results and at the top of the listing page. If you have set the first PictureURL to the "clear image" URL, you can either Item.ProductListingDetails.UseStockPhotoURLAsGallery or Item.ProductListingDetails.UseStockPhotoURL to true and eBay will use a stock photo, if available, for the gallery thumbnail as well as the picture that displays at the top of the listing page.

Note that a gallery picture will not be generated if UseStockPhotoURLAsGallery and IncludeStockPhotoURL are set to false (or not set) and no alternative picture in PictureURL. A Gallery fee applies only if you have specified GalleryType as either Plus or Featured (see Item.PictureDetails.GalleryType above for information). See "Using Gallery Features on Sites with Free Gallery" in the eBay Web Services Guide for information on eBay's selection rules for Gallery pictures on sites with free Gallery.

For VerifyAddItem only: For VerifyAddItem, you can use the following fake eBay Picture Services URL (http://i2.ebayimg.com/abc/M28/dummy.jpg) to verify that your application is obtaining the correct fees for the quantity of images you pass in.

For ReviseItem and RelistItem only: To remove a picture when revising or relisting an item, specify PictureDetails with all the pictures that you want the listing to include. That is, you need to completely replace the original set of URLs with the revised set. To remove all PictureURL fields from a listing, specify item.PictureDetails.PictureURL in DeletedField. However, please note that if the listing also includes a gallery image that is based on the first picture in the listing, you may need to supply an alternate image to use as the gallery image if you delete all PictureURL fields.

There are a number of categories on some eBay sites that always add the Gallery feature (for free) when you include a picture in the listing and you don't specify the Gallery feature yourself. See GalleryType for details about fees that could be charged if you change the category in these cases (or when revising a listing from a site with free gallery to one where free gallery is not yet available.)
Max length: 150.

See:
    Using Gallery Features on Sites with Free Gallery for complete details on how eBay selects a gallery thumbnail.
    Introduction to Pictures in Item Listings
    eBay Live Auctions
    (ReviseItem) DeletedField
    (RelistItem) GalleryType
Item.PrimaryCategory CategoryType Required Category ID for the first (or only) category in which the item is listed (or will be listed, if the item is new). A number of listing features have dependencies on the primary category. We have pointed out a few of the notable dependencies below. See the descriptions of the fields you are using to determine whether the feature you're supporting depends on the listing's primary category.

For the AddItem family of calls: Use calls like GetCategories and GetCategoryFeatures to determine valid values for the site on which you are listing (see the eBay Web Services Guide for information on working with categories). Also see Item.CategoryMappingAllowed and Item.CategoryBasedAttributesPrefill.

Most eBay.com categories are also eligible for eBay Express. Categories not covered by PayPal Buyer Protection are excluded. Also, certain categories that do not support item condition may be excluded (use GetCategoryFeatures to determine eligible categories). See "eBay Express" in the eBay Web Services Guide.

There are a number of categories on some eBay sites that always add the Gallery feature (for free) when you include a picture in the listing and you don't specify the Gallery feature yourself. See GalleryType for information about fees that could be charged if you change the category in these cases.

Not applicable to Half.com.

For ReviseItem only: When revising a listing, you can change the primary category only if an item has no bids (or no items have sold) and the listing does not end within 12 hours.

If you change the listing category, any Item Specifics (attributes) that were previously specified may be dropped from the listing if they aren't valid for the new category. See Item.AttributeSetArray. For the eBay US site, we suggest that you avoid including a category ID when you use ExternalProductID. See the KB article listed below for details.

You cannot change the meta-categories for vehicles (i.e., you cannot change a truck to a motorcycle), but you can change the leaf category (e.g., change one motorcycle subcategory to another motorcycle subcategory). See the eBay Web Services Guide for additional rules. International sites (such as the eBay Germany site) have similar rules for revising vehicle categories.

For AddLiveAuctionItem only: For eBay Live Auctions (e.g., in AddLiveAuctionItem), this is the eBay Live Auctions site category in which to list the item. This can be different from the category that is associated with the seller's catalog. See Specifying eBay Live Auctions Categories in the eBay Web Services guide.

For GetItemRecommendations only: For GetItemRecommendations, use this to control the category that will be searched for recommendations. Specify the category in which the item will be listed. See the eBay Web Services guide for differences in validation rules depending on whether you are using the Listing Analyzer engine, Product Pricing engine, or Suggested Attributes engine.

For GetProducts: Use GetCategories if you need to determine the name of the category.

See:
    Categories
    Listing Criteria for eBay Express
    Specifying eBay Live Auctions Categories
    Listing US and CA eBay Motors Items
    (RelistItem) GalleryType
    KB Article: Listing with ExternalProductID and CategoryID
Item.PrimaryCategory
  .CategoryID 		string Required Distinct numeric ID for a category on eBay. In GetItem and related calls, see CategoryName for the text name of the category. Use GetCategories to look up the category parent ID.

For GetPopularKeywords, -1 represents the root category.

For GetItem, Half.com items return the Half.com category ID in PrimaryCategory. This ID is not necessarily returned in GetCategories. If a Half.com listing is eligible for Express, you can use SecondaryCategory to determine the eBay category ID.
Max length: 10.
Item.PrivateListing boolean Optional If true, designates the listing as private. When you create a private listing, a buyer's User ID will not appear in the listing or in the listing's bid history. Sellers may want to use this option when they believe that potential bidders for a listing would not want their User IDs disclosed to others. Not applicable to Half.com.
Item.RelistLink boolean Optional Applicable only to re-listing an item. If true, creates a link in the item's old listing for the item that points to the new relist page, which accommodates users who might still look for the item under its old item ID. Not applicable to Half.com.
Item.ReservePrice AmountType (double) Optional The lowest price at which the seller is willing to sell the item. (StartPrice must be lower than ReservePrice.) Not all categories support reserve prices. See GetCategories and "Determining Whether a Category Supports Reserve Prices" in the eBay Web Services guide. In calls that retrieve item data, ReservePrice only has a non-zero value for listings with a reserve price and where the user requesting the item data is also the item's seller. Not applicable to fixed- price items or ad format listings.

You can remove the reserve price of a US eBay Motors listing if the category allows it, the current reserve price has not been met, and the reserve price is at least $2.00 more than the current high bid. In this case, if the item has bids, the reserve price is set to $1.00 over the current high bid. The next bid meets the reserve and wins. See the Fees Overview on the eBay Web site for information about fee credits that may be available when the reserve price is removed for a Motors listing. See the eBay Web Services guide for validation rules when revising US Motors listings.

For AddLiveAuctionItem and ReviseLiveAuctionItem, the seller needs to make sure they specify the amount in the currency selected for the live auction event. When you revise a Live Auction item, you can lower an existing reserve price, but you cannot add a reserve price or remove an existing reserve price if the item has absentee bids or ends in less than 12 hours.

Not applicable to Half.com. This field is ignored when Item.ListingType=Express.

See:
    Revising US eBay Motors Listings
    Reserve Price (eBay Web site help)
    Fees Overview (eBay Web site help)
Item.ReservePrice
  [ attribute currencyID ]		 CurrencyCodeType Optional Currency in which the monetary amount is specified.

In the AddItem family of calls, the currency can be specified in the Item.Currency field instead. If you do specify this attribute in the AddItem family of calls, the value must match the site currency (i.e., it must be the same as the value in Item.Currency) unless otherwise stated.

For a list of possible enumeration values, see CurrencyCodeType.
Item.ReturnPolicy ReturnPolicyType Required Describes the seller's return policy. Most eBay categories require the seller to clearly specify whether or not returns are accepted (see ReturnsAcceptedOption).

Note: Items that were listed prior to October 2008 might not specify a return policy.

For the AddItem family of calls: See ReturnPolicyEnabled in GetCategoryFeatures to determine which categories require this field. See ReturnPolicyDetails in GeteBayDetails to determine which ReturnPolicy fields can be used.


For ReviseItem only: If the listing has bids or sales and it ends within 12 hours, you can't change the return policy details. If the listing is a GTC listing that has sales or ends within 12 hours (one or the other, but not both), you can add a return policy to the GTC listing (but you can't change return policy details if already present). If the listing has no bids or sales and more than 12 hours remain before the listing ends, you can add or change the return policy. When you revise your return policy, you only need to specify the fields you want to add or change. You don't need to specify all the other ReturnPolicy fields again. The other fields will retain their existing settings.

For the GetItem family of calls: Only returned if the site you sent the request to supports the seller's return policy. Typically, the return policy details are only returned when the request is sent to the listing site.

See:
    (GetCategoryFeatures) Category.ReturnPolicyEnabled for categories that require a return policy
    (GeteBayDetails) ReturnPolicyDetails for return policy fields that each site reports
Item.ReturnPolicy.Description string Optional A detailed explanation of the seller's return policy.

For AddItem, VerifyAddItem, and RelistItem: If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted) but does not specify this field when listing the item, GetItem returns this as an empty node

For ReviseItem only: If the listing has bids or sales and/or ends within 12 hours, you can't change this value. See the parent ReturnPolicy node description for more details.
Max length: 5000.

See (GeteBayDetails) ReturnPolicyDetails.Description for sites that support this field.
Item.ReturnPolicy.EAN string Optional The European Article Number (EAN) associated with the item, if any. Refer to the ReturnPolicyDetails node in GeteBayDetails to determine which sites support this field. Only returned if the seller has specified this value in their return policy.

For ReviseItem only: If the listing has bids or sales and/or ends within 12 hours, you can't change this value. See the parent ReturnPolicy node description for more details.


See (GeteBayDetails) ReturnPolicyDetails.EAN for sites that support this field.
Item.ReturnPolicy.RefundOption token Optional Indicates how the seller will compensate the buyer for a returned item. Use the ReturnPolicy.Description field to explain the policy details (such as how quickly the seller will process the refund, whether the seller must receive the item before processing the refund, and other useful details.).

Applicable values: Use GeteBayDetails to determine which sites support this field, and the applicable values for each site. (RefundOptionsCodeType defines all the possible values.)

For AddItem, VerifyAddItem, and RelistItem: If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted) but you do not pass in this RefundOption field when listing the item, some eBay sites may set a default value (like MoneyBack), and the seller is obligated to honor this setting. Therefore, to avoid unexpected obligations, the seller should set a specific value for this field.

For ReviseItem only: If the listing has bids or sales and/or ends within 12 hours, you can't change this value. See the parent ReturnPolicy node description for more details.

See (GeteBayDetails) RefundOption for sites that support this field, and applicable values.
Item.ReturnPolicy
  .ReturnsAcceptedOption 		token Conditional Indicates whether the seller allows the buyer to return the item. This field is required when ReturnPolicy is specified. (If you specify ReturnsNotAccepted, the View Item page may initially show the return policy as unspecified. In a future release, the View Item page will be updated to indicate that returns are not accepted instead.)

On the eBay UK and Ireland sites, business sellers must accept returns for fixed price items (including auction items with Buy It Now, and any other fixed price formats) when the category requires a return policy.

Applicable values: Use GeteBayDetails to determine which sites support this field, and the applicable values for each site. (ReturnsAcceptedOptionsCodeType defines all the possible values.)

For ReviseItem only: If the listing has bids or sales and/or ends within 12 hours, you can't change this value. See the parent ReturnPolicy node description for more details.

See (GeteBayDetails) ReturnsAcceptedOption for sites that support this field, and applicable values.
Item.ReturnPolicy
  .ReturnsWithinOption 		token Conditional The buyer can return the item within this period of time from the day they receive the item. Use the ReturnPolicy.Description field to explain the policy details.

Applicable values: Use GeteBayDetails to determine which sites support this field, and the applicable values for each site. (ReturnsWithinOptionsCodeType defines all the possible values.)

For AddItem, VerifyAddItem, and RelistItem: If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted) but you do not pass in this ReturnsWithinOption field when listing the item, some eBay sites may set a default value (like Days_7), and the seller is obligated to honor this setting. Therefore, to avoid unexpected obligations, the seller should set a specific value for this field.

For ReviseItem only: If the listing has bids or sales and/or ends within 12 hours, you can't change this value. See the parent ReturnPolicy node description for more details.

See (GeteBayDetails) ReturnsWithinOption for sites that support this field, and applicable values.
Item.ReturnPolicy
  .ShippingCostPaidByOption 		token Optional The party who pays the shipping cost for a returned item. Use the ReturnPolicy.Description field to explain any additional details.

Applicable values: Use GeteBayDetails to determine which sites support this field, and the applicable values for each site. (ShippingCostPaidByOptionsCodeType defines all the possible values.)

For AddItem, VerifyAddItem, and RelistItem: If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted) but you do not pass in this ShippingCostPaidByOption field when listing the item, some eBay sites may set a default value (like Buyer), and the seller is obligated to honor this setting. Therefore, to avoid unexpected obligations, the seller should set a specific value for this field.

For ReviseItem only: If the listing has bids or sales and/or ends within 12 hours, you can't change this value. See the parent ReturnPolicy node description for more details.

See (GeteBayDetails) ShippingCostPaidByOption for sites that support this field, and applicable values.
Item.ReturnPolicy
  .WarrantyDurationOption 		token Optional The warranty period.

Applicable values: Use GeteBayDetails to determine which sites support this field, and the applicable values for each site. (Initially, only the eBay India site supports this field.) (WarrantyDurationOptionsCodeType defines all the possible values.)

For AddItem, VerifyAddItem, and RelistItem: If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted) but you do not pass in this WarrantyDurationOption field when listing the item, the eBay India site may set a default value, and the seller is obligated to honor this setting. Therefore, to avoid unexpected obligations, the seller should set a specific value for this field.

For ReviseItem only: If the listing has bids or sales and/or ends within 12 hours, you can't change this value. See the parent ReturnPolicy node description for more details.

See (GeteBayDetails) WarrantyDurationOption for sites that support this field, and applicable values.
Item.ReturnPolicy
  .WarrantyOfferedOption 		token Optional Indicates whether a warranty is offered for the item.

Applicable values: Use GeteBayDetails to determine which sites support this field, and the applicable values for each site. (Initially, only the eBay India site supports this field.) (WarrantyOfferedCodeType defines all the possible values.)

For AddItem, VerifyAddItem, and RelistItem: If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted) but you do not pass in this WarrantyOfferedOption field when listing the item, the eBay India site may set a default value, and the seller is obligated to honor this setting. Therefore, to avoid unexpected obligations, the seller should set a specific value for this field.

Note: For the US eBay Motors limited warranty (Short-Term Service Agreement) option, use Item.LimitedWarrantyEligible instead.

For the US eBay Motors "Is There an Existing Warranty?" option, use Item.AttributeSetArray instead.

For ReviseItem only: If the listing has bids or sales and/or ends within 12 hours, you can't change this value. See the parent ReturnPolicy node description for more details.

See:
    Warranties (eBay India)
    Guidelines for Creating Legally Compliant Listings (eBay India)
    (GeteBayDetails) WarrantyOfferedOption for sites that support this field, and applicable values
    Short-Term Service Agreement (Limited Warranty)
    (AddItem) Item.LimitedWarrantyEligible for US eBay Motors Short-Term Service Agreement
    Valid Item Specifics for Listing eBay Motors US Cars & Trucks for US eBay Motors existing warranty option
    (AddItem) Item.AttributeSetArray for US eBay Motors existing warranty option
Item.ReturnPolicy
  .WarrantyTypeOption 		token Optional Indicates the source or type of the warranty, if any.

Applicable values: Use GeteBayDetails to determine which sites support this field, and the applicable values for each site. (Initially, only the eBay India site supports this field.) (WarrantyTypeOptionsCodeType defines all the possible values.)

For AddItem, VerifyAddItem, and RelistItem: If the seller accepts returns (ReturnsAcceptedOption=ReturnsAccepted) but you do not pass in this WarrantyTypeOption field when listing the item, the eBay India site may set a default value, and the seller is obligated to honor this setting. Therefore, to avoid unexpected obligations, the seller should set a specific value for this field.

For ReviseItem only: If the listing has bids or sales and/or ends within 12 hours, you can't change this value. See the parent ReturnPolicy node description for more details.

See (GeteBayDetails) WarrantyTypeOption for sites that support this field, and applicable values.
Item.SecondaryCategory CategoryType Optional ID for second category in which the item is listed (also see Item.PrimaryCategory).

For the AddItem family of calls: Listing an item in a second category is optional. Also see Item.CategoryMappingAllowed and Item.CategoryBasedAttributesPrefill.

Most eBay.com categories are also eligible for eBay Express. Categories not covered by PayPal Buyer Protection are excluded. Also, certain categories that do not support item condition may be excluded.

Not applicable to Half.com.

You cannot list US eBay Motors vehicles in two categories. However, you can list Parts & Accessories in two categories. The Final Value Fee is based on the primary category in which the item is listed. Furthermore, you can list the same item in an eBay Motors Parts & Accessories category and in an eligible eBay category, as long as the primary category is associated with the site on which you are listing. That is, the two categories can be a mix of Motors Parts & Accessories and eBay site categories. (Real Estate, Mature Audience (adult), and Business & Industrial categories are not eligible for listing in two categories in this manner.) For example, if you list on Motors, the primary category could be 6750 (eBay Motors > Parts & Accessories > Apparel & Merchandise > Motorcycle > Jackets & Leathers), and the secondary category could be 57988 (eBay > Clothing, Shoes > Accessories > Men's Clothing > Outerwear). If you list on the main eBay site, the primary category could be 57988 and the secondary category could be 6750.

To remove this value when relisting an item, use DeletedField.

For ReviseItem only: When revising a listing, you can add, remove, or change the secondary category only if the listing has no bids (or no items have sold) and it does not end within 12 hours. If you change the secondary category, any corresponding Item Specifics (attributes) that were previously specified may be dropped from the listing if they aren't valid for the category. See Item.AttributeSetArray.

When you revise an item, you can change the secondary category from a Motors Parts & Accessories category to an eBay category or vice versa if the listing has no bids (or no items have sold) and it does not end within 12 hours.

For AddLiveAuctionItem only: For eBay Live Auctions (e.g., AddLiveAuctionItem), this is the eBay US site category in which to list the item. (This can be any eBay US category except Motors or Real Estate categories.) Note that eBay Live Auctions does not charge a fee to specify an eBay category (i.e., no List in Two Category fees). See Specifying eBay Live Auctions Categories in the eBay Web Services guide. In AddLiveAuctionItem, you need to specify SecondaryCategory if you are including Item Specifics (AttributeSetArray).

For ReviseLiveAuctionItem only: For eBay Live Auctions, you can add SecondaryCategory when you revise the lot item, but you cannot change or remove an existing secondary category if the item has absentee bids or it ends in less than 12 hours.

For GetItemRecommendations only: For GetItemRecommendations, use this to control the category that will be searched for recommendations. Specify the category in which the item will be listed. See the eBay Web Services guide for differences in validation rules depending on whether you are using the Listing Analyzer engine, Product Pricing engine, or Suggested Attributes engine.

See:
    Categories
    Listing Criteria for eBay Express
    Specifying eBay Live Auctions Categories
Item.SecondaryCategory
  .CategoryID 		string Required Distinct numeric ID for a category on eBay. In GetItem and related calls, see CategoryName for the text name of the category. Use GetCategories to look up the category parent ID.

For GetPopularKeywords, -1 represents the root category.

For GetItem, Half.com items return the Half.com category ID in PrimaryCategory. This ID is not necessarily returned in GetCategories. If a Half.com listing is eligible for Express, you can use SecondaryCategory to determine the eBay category ID.
Max length: 10.
Item.Site SiteCodeType Required The name of the site on which the item is listed. The listing site affects the business logic and validation rules that are applied to the request, which in turn affect the values that are returned in the response, as well as values that appear on the eBay Web site. For example, the listing site can affect the validation of Category in listing requests, international business seller requirements, the values of converted (localized) prices in responses, the item-related time stamps that are displayed on the eBay Web site, the visibility of the item in some types of searches (e.g., GetCategoryListings), and other information. In some cases (such as with listings on eBay Express), the rules are determined by a combination of the site, the user's registration address, and other information. You cannot change the site when you revise a listing.

When you specify Item.Site in AddItem, it must be consistent with the numeric site ID that you specify in the request URL (for the SOAP API) or the X-EBAY- API-SITEID header (for the XML API). Not applicable to Half.com. For eBay Live Auctions, pass a value of US.

Applicable values: See Site.

See:
    The US and International eBay Sites
    Specifying the Target Site
    Field Differences for eBay Sites
    Seller Criteria for eBay Express
Item.SKU SKUType (string) Optional This element is a SKU (stock-keeping unit) defined by a seller. The seller can use a SKU to identify one item or use the same SKU for multiple items. Preferable to ApplicationData for SKUs and inventory tracking. Different sellers can use the same SKUs. This element can be used by sellers to track complex flows of products and information. This element preserves a SKU, enabling a seller to obtain it before and after a transaction is created. To remove a SKU when you revise or relist an item, use DeletedField. Not applicable to Half.com. For GetMyeBaySelling, this is only returned if set.
Max length: 50.
Item.StartPrice AmountType (double) Required The original price of the item at listing or re-listing time. If this value changes when the item is revised, the new value becomes the original price.

For auction-type listings, competitive bidding starts at this value. Once at least one bid has been placed, StartPrice remains the same but CurrentPrice is incremented to the amount of each succeeding bid. If ReservePrice is also specified, the value of StartPrice must be lower than the value of ReservePrice.

For fixed-price listings (FixedPriceItem), Store Inventory (StoresFixedPrice) listings, and Express format listings, this is the constant price at which a buyer may purchase the item.

For a listing to be eligible for Express, the max start price is USD 10,000.00 for the US, EUR 5000 for Germany, and GBP 5500 for the UK. (Additional price limits may be imposed by the seller's PayPal account or the payment method used. Such limits cannot be determined via the eBay API and are not covered in eBay's API documentation, as they may vary for each user.)

Also applicable to Half.com (valid range 0.75 to 9999.99). You can revise this field for Half.com listings.
For AddLiveAuctionItem and ReviseLiveAuctionItem, this is the amount at which absentee Internet bidding for the item begins. Max length was 16 at the time this call was initially developed. Must be greater than zero. The seller needs to make sure they specify the amount in the currency selected for the live auction event. When you revise a Live Auction item, you can change the start price.

See Specify a Fixed Price for Express and eBay.
Item.StartPrice
  [ attribute currencyID ]		 CurrencyCodeType Optional Currency in which the monetary amount is specified.

In the AddItem family of calls, the currency can be specified in the Item.Currency field instead. If you do specify this attribute in the AddItem family of calls, the value must match the site currency (i.e., it must be the same as the value in Item.Currency) unless otherwise stated.

For a list of possible enumeration values, see CurrencyCodeType.
Item.SubTitle string Optional Subtitle to use in addition to the title. Provides more keywords when buyers search in titles and descriptions. You cannot use HTML in the Subtitle. (HTML characters will be interpreted literally as plain text.) If you pass any value, this feature is applied (with applicable fees).

Not applicable to listings in US eBay Motors passenger vehicle, motorcycle, and "other vehicle" categories or to listings in CA eBay Motors passenger vehicle and motorcycle categories. For eBay Motors categories that do not support this field, use Item Specifics (AttributeSetArray) to specify the vehicle subtitle.

Not applicable to Half.com.

When you revise a item, you can add, change, or remove the subtitle.
In GetSearchResultsExpress, only returned when ItemDetails is set to Fine and a subtitle was specified for the item.
Max length: 55.

See:
    Removing a Field When Relisting an Item
    (RelistItem) DeletedField
    Valid Item Specifics for Listing eBay Motors US Cars & Trucks
    Specifying a Subtitle for a Motors Vehicle Listing
Item.Title string