Unpaid Item Disputes

Authentication information for the user on whose behalf the application is making the request. Only registered eBay users are allowed to make API calls. To verify that a user is registered, your application needs to pass a user-specific value called an "authentication token" in the request. This is equivalent to signing in on the eBay Web site. As API calls do not pass session information, you need to pass the user's authentication token every time you invoke a call on their behalf. All calls require an authentication token, except the calls you use to retrieve a token in the first place. (For such calls, you use the eBay member's username and password instead.) Yes This call enables a seller to create an Unpaid Item case against a buyer, or to cancel a single line item order. Note: This call is only used by sellers to create an Unpaid Item case or to mutually cancel a single line item order. Buyers must use the eBay Resolution Center or PayPal Resolution Center (for orders that satisfy requirements) to create an Item Not Received or an Item Significantly Not as Described case.

Creates an Unpaid Item dispute against a buyer or cancels a single line item order.

Unpaid Item Disputes http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=UnpaidItemDisputes This enumerated value gives the explanation of why the buyer or seller opened a case (or why seller canceled an order line item). Not all values contained in DisputeExplanationCodeType are allowed in the AddDispute call, and the values that are allowed must match the DisputeReason value. AddDispute Yes PaymentMethodNotSupported, ShipCountryNotSupported, Unspecified, UPIAssistance, UPIAssistanceDisabled Creating and Managing Disputes With Trading API http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=UsingAddDispute The type of dispute being created. BuyerHasNotPaid and TransactionMutuallyCanceled are the only values that may be used with the AddDispute call. AddDispute Yes BuyerHasNotPaid, TransactionMutuallyCanceled Unique identifier for an eBay item listing. A listing can have multiple orders, but only one ItemID. To identify a specific order line item, either an ItemID/TransactionID pair or an OrderLineItemID value must be passed in the request. So, unless OrderLineItemID is used, this field is required. 19 (ItemIDs usually consist of 9 to 12 digits) AddDispute Conditionally The unique identifier of an order line item. An order line item is created once a buyer purchases the item through a fixed-priced listing or by using the Buy It Now feature in an auction listing, or when an auction listing ends with a winning bidder. To identify a specific order line item, either an ItemID/TransactionID pair or an OrderLineItemID value must be passed in the request. So, unless OrderLineItemID is used, this field is required. 19 (TransactionIDs usually consist of 9 to 12 digits.) AddDispute Conditionally OrderLineItemID is a unique identifier of an order line item, and is based upon the concatenation of ItemID and TransactionID, with a hyphen in between these two IDs. To identify a specific order line item, either an ItemID/TransactionID pair or an OrderLineItemID value must be passed in the request. So, unless ItemID/TransactionID pair is used, this field is required. 50 AddDispute Conditionally Type defining the response of the AddDispute call. Upon a successful call, the response contains a newly created DisputeID value, which confirms that the the Unpaid Item or Mutually Canceled Transaction case was successfully created. The unique identifier of the Unpaid Item or Mutually Canceled Transaction case that was successfully created with the AddDispute call. AddDispute Always Allows a seller to respond to or close an Item Not Received dispute. This can be used to add a comment to an Unpaid Item Dispute only if the request version was lower than 637 when the dispute was created.

Adds a response or comment to a dispute, or closes a dispute.

Unpaid Item Disputes http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=UnpaidItemDisputes Buyer Disputes http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=BuyerDisputes The unique identifier of the dispute, returned when the dispute was created. AddDisputeResponse Yes The text of a comment or response being posted to the dispute. Required when DisputeActivity is SellerAddInformation, SellerComment, or SellerPaymentNotReceived; otherwise, optional. AddDisputeResponse Conditionally The type of activity the seller is taking on the dispute. The allowed value is determined by the current value of DisputeState, returned by GetDispute or GetUserDisputes. Some values relate to Unpaid Item disputes and other values relate to buyer-created disputes known as Item Not Received or Significantly Not As Described disputes. AddDisputeResponse Yes Unpaid Item Disputes http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=UnpaidItemDisputes Buyer Disputes http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=BuyerDisputes The shipping carrier used to ship the item in dispute. Non-alphanumeric characters are not allowed. This field (along with ShipmentTrackNumber) is required if DisputeActivity is SellerShippedItem. AddDisputeResponse Conditionally The tracking number associated with one package of a shipment. The seller is responsible for the accuracy of the shipment tracking number, as eBay only verifies that the tracking number is consistent with the numbering scheme used by the specified shipping carrier, but cannot verify the accuracy of the tracking number. This field (along with ShippingCarrierUsed) is required if DisputeActivity is SellerShippedItem. AddDisputeResponse Conditionally This timestamp indicates the date and time when the item under dispute was shipped. This field is required if DisputeActivity is SellerShippedItem. AddDisputeResponse Conditionally Response to a call of AddDisputeResponse. Defines and lists a new fixed-price listing (not auction-style listings). The main difference between AddFixedPriceItem and AddItem is that AddFixedPriceItem supports the creation of fixed-price listings only, whereas AddItem supports all listing formats. Also, only AddFixedPriceItem supports multi-variation listings and tracking inventory by SKU. AddItem does not support Variations or InventoryTrackingMethod. See the AddFixedPriceItem documentation for additional information.

Defines and lists a new fixed-price item. A fixed-price listing can include multiple identical items.

AddItem, AddItems, AddToItemDescription, EndFixedPriceItem, GetItem, GetCategories, RelistFixedPriceItem, ReviseFixedPriceItem, VerifyAddFixedPriceItem Listing an Item http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ListingAnItem Listing Items http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ListingItemsIntro Introduction to Pictures in Item Listings http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=Pictures Multi-Variation Listings http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=Variations Listing an Item http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ConsideringBestMatch Root container holding all values that define a new fixed-price listing. AddFixedPriceItem Yes Returns the item ID, SKU (if any), listing recommendations (if applicable), the estimated fees for the new listing (except the Final Value Fee, which isn't calculated until the item has sold), the start and end times of the listing, and other details. Unique identifier for the new fixed-price listing. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) AddFixedPriceItem Always Item-level SKU for the new listing, if the seller specified Item.SKU in the request. Variation-level SKUs are not returned (see GetItem instead). AddFixedPriceItem Conditionally Starting date and time for the new listing. This value is based on the time the listing was received and processed, or the time the item will be listed if the seller specified Item.ScheduleTime in the request. AddFixedPriceItem Always Date and time when the new listing ends. This is the starting time plus the listing duration. AddFixedPriceItem Always Child elements contain the estimated listing fees for the new item listing. The fees do not include the Final Value Fee (FVF), which cannot be determined until an item is sold. eBay.com Fees http://pages.ebay.com/help/sell/fees.html AddFixedPriceItem Always Final Value Fees and Credits http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=FinalValueFeesAndCredits Final Value Fees http://pages.ebay.com/help/sell/fvf.html Fees per Site http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=FeesPerSite Using Feature Packs to Save on Upgrade Fees http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=UsingFeaturePacks ID of the primary category in which the item was listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID you passed in PrimaryCategory was mapped to a new ID by eBay. If the primary category has not changed or if it has expired with no replacement, CategoryID does not return a value. 10 AddFixedPriceItem Conditionally ID of the secondary category in which the item was listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID you passed in SecondaryCategory was mapped to a new ID by eBay. If the secondary category has not changed or it has expired with no replacement, Category2ID does not return a value. 10 AddFixedPriceItem Conditionally The nature of the discount, if a discount is applied. AddFixedPriceItem Conditionally Provides a list of products recommended by eBay which match the item information provided by the seller. Not applicable to Half.com. AddFixedPriceItem Conditionally Container consisting of one or more Recommendation containers. Each Recommendation container provides a message to the seller on how a listing can be improved or brought up to standard in reqards to Top-Rated Plus listing requirements, Item Specifics, picture requirements, and/or a recommendation to use a product code to list the item, such as a UPC, an EAN, or an ISBN. This container is only returned if the IncludeRecommendations flag was included and set to 'true' in the AddFixedPriceItem request, and if at least one listing recommendation exists for the newly created listing. If one or more listing recommendations are returned, it will be at the seller's discretion about whether to revise the item based on eBay's listing recommendation(s). AddFixedPriceItem Conditionally Defines a single new item and lists it on a specified eBay site. Also for Half.com. Returns the item ID for the new listing, and returns fees the seller will incur for the listing (not including the Final Value Fee, which cannot be calculated until the item is sold). AddFixedPriceItem, AddItems, AddToItemDescription, GetItem, GetSellerList, RelistItem, ReviseItem, VerifyAddItem Listing an Item http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ListingAnItem Listing Items http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ListingItemsIntro Specifying Shipping Costs when Creating or Revising a Listing http://developer.ebay.com/DevZone/XML/docs/WebHelp/ManagingShipping-Specifying_Shipping_Costs_when_Creating_or_Revising_a_Listing.html Seller Checklist http://pages.ebay.com/sell/April2009Update/Checklist/ Introduction to Pictures in Item Listings http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=Pictures Listing an Item http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ConsideringBestMatch half Root container holding all values that define a new listing. Applicable to Half.com. AddItem Yes Returns the Item ID, SKU (if any), listing recommendations (if applicable), the estimated fees for the new listing (except the Final Value Fee, which isn't calculated until the item has sold), the start and end times of the listing, and other details. Unique identifier for the new listing. Applicable to Half.com. Note: Although eBay represents Item IDs as strings in the schema, we recommend you store them as 64-bit signed integers. If you choose to store Item IDs as strings, allocate at least 19 characters (assuming decimal digits are used) to hold them. eBay will increase the size of IDs over time, and your code should be prepared to handle IDs of up to 19 digits. For more information about Item IDs, see <a href=" http://ebay.custhelp.com/cgi-bin/ebay.cfg/php/enduser/std_adp.php?p_faqid=468"> Common FAQs on eBay Item IDs and other eBay IDs</a> in the Knowledge Base. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) AddItem Always Starting date and time for the new listing. Applicable to Half.com (for Half.com, the start time is always the time the item was listed). AddItem Always Date and time when the new listing ends. This is the starting time plus the listing duration. Applicable to Half.com (for Half.com the actual end time is GTC, not the end time returned in the response). AddItem Always Child elements contain the estimated listing fees for the new item listing. The fees do not include the Final Value Fee (FVF), which cannot be determined until an item is sold. Applicable to Half.com, but the values are not applicable to Half.com listings. AddItem Always eBay.com Fees http://pages.ebay.com/help/sell/fees.html Final Value Fees and Credits http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=FinalValueFeesAndCredits Final Value Fees http://pages.ebay.com/help/sell/fvf.html Fees per Site http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=FeesPerSite Using Feature Packs to Save on Upgrade Fees http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=UsingFeaturePacks ID of the primary category in which the item was listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID you passed in PrimaryCategory was mapped to a new ID by eBay. If the primary category has not changed or it has expired with no replacement, CategoryID does not return a value. Not applicable to Half.com. 10 AddItem Conditionally ID of the secondary category in which the item was listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID you passed in SecondaryCategory was mapped to a new ID by eBay. If the secondary category has not changed or it has expired with no replacement, Category2ID does not return a value. Not applicable to Half.com. 10 AddItem Conditionally The nature of the discount, if a discount applied. AddItem Conditionally Provides a list of products recommended by eBay which match the item information provided by the seller. Not applicable to Half.com. AddItem Conditionally Container consisting of one or more Recommendation containers. Each Recommendation container provides a message to the seller on how a listing can be improved or brought up to standard in reqards to Top-Rated Plus listing requirements, Item Specifics, picture requirements, and/or a recommendation to use a product code to list the item, such as a UPC, an EAN, or an ISBN. This container is only returned if the IncludeRecommendations flag was included and set to 'true' in the AddItem request, and if at least one listing recommendation exists for the newly created listing. If one or more listing recommendations are returned, it will be at the seller's discretion about whether to revise the item based on eBay's listing recommendation(s). AddItem Conditionally Creates listings from Selling Manager templates. This call is subject to change without notice; the deprecation process is inapplicable to this call. AddSellingManagerTemplate,GetSellingManagerTemplates Using Selling Manager Calls in the Trading API http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SellingManagerApps Selling Manager page on the eBay Site http://pages.ebay.com/selling_manager/ Selling Manager Pro page on the eBay Site http://pages.ebay.com/selling_manager_pro The ID of the template you are using to list an item. You can obtain a SaleTemplateID by calling GetSellingManagerInventory. AddItemFromSellingManagerTemplate No Start time for the listing. AddItemFromSellingManagerTemplate No Currently, only the following can be specified as children of this container: payment methods, the PayPal email address, and CategoryMappingAllowed. This container is intended for specifying item values that differ from values in the template specified in the SaleTemplateID field. However, currently, the only children that are allowed for this container are payment methods and a PayPal email address. AddItemFromSellingManagerTemplate No Returns values indicating information for a new listing. The unique identifier for the listing that was created by the AddItemFromSellingManagerTemplate request. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) AddItemFromSellingManagerTemplate Always Start time for the listing that was created by the AddItemFromSellingManagerTemplate request. AddItemFromSellingManagerTemplate Always End time for the listing that was created by the AddItemFromSellingManagerTemplate request. This value is equal to the start time plus the listing duration. AddItemFromSellingManagerTemplate Always Child elements contain the estimated listing fees for the new item listing. The fees do not include the Final Value Fee (FVF), which cannot be determined until an item is sold. AddItemFromSellingManagerTemplate Always ID of the primary category in which the item was listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID you passed in PrimaryCategory was mapped to a new ID by eBay. If the primary category has not changed or it has expired with no replacement, CategoryID does not return a value. Not applicable to Half.com. 10 AddItemFromSellingManagerTemplate Conditionally ID of the secondary category in which the item was listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID you passed in SecondaryCategory was mapped to a new ID by eBay. If the secondary category has not changed or it has expired with no replacement, Category2ID does not return a value. Not applicable to Half.com. 10 AddItemFromSellingManagerTemplate Conditionally Defines from one to five items and lists them on a specified eBay site. AddItem, AddToItemDescription, EndItems, GetItem, GetSellerList, RelistItem, ReviseItem, VerifyAddItem Listing an Item http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ListingAnItem Listing Items http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ListingItemsIntro Seller Checklist http://pages.ebay.com/sell/April2009Update/Checklist Introduction to Pictures in Item Listings http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=Pictures Listing an Item http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ConsideringBestMatch Defines a single item to be listed on eBay. This container is similar to an AddItem request. Up to five containers can be included in one AddItems request. 1 5 AddItems Yes The response of the AddItems call. The response includes the Item IDs of the newly created listings, the eBay category each item is listed under, the seller-defined SKUs of the items (if any), the listing recommendations for each item (if applicable), the start and end time of each listing, and the estimated fees that each listing will incur. One AddItemResponseContainer container is returned for each listing that is being created with the AddItems call. Each container includes the ItemID of each newly created listings, the eBay category each item is listed under, the seller-defined SKUs of the items (if any), the listing recommendations for each item (if applicable), the start and end time of each listing, and the estimated fees that each listing will incur. AddItems Always Enables a buyer and seller in an order relationship to send messages to each other's My Messages Inboxes. AddMemberMessagesAAQToBidder, AddMemberMessageRTQ, DeleteMyMessages, GetMemberMessages, ReviseMyMessages, ReviseMyMessagesFolders The unique ID of the item about which the question was asked. AddMemberMessageAAQToPartner Yes Container for the message. Includes the message body, plus other values related to the message. AddMemberMessageAAQToPartner Yes Response to AddMemberMessageAAQToPartner request. Enables a seller to reply to a question about an active item listing. AddMemberMessagesAAQToBidder, AddMemberMessageAAQToPartner, DeleteMyMessages, GetMemberMessages, GetMyMessages, ReviseMyMessages, ReviseMyMessagesFolders Communication Between Members http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=CommunicationBetweenMembers The unique ID of the item about which the question was asked. This field is not required in the request, if the request includes a RecipientID in the MemberMessage container. AddMemberMessageRTQ No Container for the message. Includes the message body (which should answer the question that an eBay user asks you (the seller) about an active listing), plus other values related to the message. AddMemberMessageRTQ Yes Response to AddMemberMessageRTQ request. Enables a seller to send up to 10 messages to bidders, or to users who have made offers via Best Offer, regarding an active item listing. AddMemberMessageAAQToPartner, AddMemberMessageRTQ, DeleteMyMessages, GetMemberMessages, GetMyMessages, GetUserContactDetails, ReviseMyMessages, ReviseMyMessagesFolders Communication Between Members http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=CommunicationBetweenMembers Allows a seller to send up to 10 messages to bidders and users who have made offers (via Best Offer) during an active listing. 10 AddMemberMessagesAAQToBidder Yes Type defining the AddMemberMessagesAAQToBidderResponseContainer container, which consists of the Ack field (indicating the result of the send message operation) and the CorrelationID field (used to track multiple send message operations performed in one call). Container consisting of the Ack field (indicating the result of the send message operation) and the CorrelationID field (used to track multiple send message operations performed in one call). 10 AddMemberMessagesAAQToBidder Always Combines two or more order line items into a single order, enabling a buyer to pay for all of those order line items with a single payment (and, if so arranged, ship all of the items together).

Combines two or more order line items into a single order, enabling a buyer to pay for all of those order line items with a single payment.

GetItemTransactions, GetOrders Reviewing and Modifying an Order Line Item http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=CreatingaCombinedPaymentOrder additional insight into prerequisites Listing an Item http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=WorkingWithCombinedPayment The root container of the AddOrder request. In this call, the seller identifies two or more order line items from the same buyer through the TransactionArray container, specifies one or more accepted payment methods through the PaymentMethods field(s), and specifies available shipping services and other shipping details through the ShippingDetails container. AddOrder Yes Returns a unique identifier for the order. A buyer may make a single payment to purchase all of the order line items included in the order. The unique identifier for the Combined Payment order. This OrderID can be used as an input filter in GetOrders. AddOrder Always The date and time the Combined Payment order was created. AddOrder Always Creates a new Second Chance Offer (that is, an offer for an unsold item) for one of that item's non-winning bidders. GetAllBidders, VerifyAddSecondChanceItem Making Second Chance Offers for Items http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=MakingSecondChanceOffersForItems Specifies the bidder from the original, ended listing to whom the seller is extending the second chance offer. Specify only one RecipientBidderUserID per call. If multiple users are specified (each in a RecipientBidderUserID node), only the last one specified receives the offer. AddSecondChanceItem Yes The amount the offer recipient must pay to purchase the item from the second chance offer listing. Use only when the original item was listed in an eBay Motors vehicle category (or in some categories on U.S. and international sites for high-priced items, such as items in many U.S. and Canada Business and Industrial categories) and it ended unsold because the reserve price was not met. Otherwise, eBay establishes the price and no price should be submitted. AddSecondChanceItem No Specifies the length of time the second chance offer listing will be active. The recipient bidder has that much time to purchase the item or the listing expires. AddSecondChanceItem Yes Specifies the item ID for the original, ended listing from which the second chance offer item comes. A new ItemID is returned for the second chance offer item. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) AddSecondChanceItem Yes Message content. Cannot contain HTML, asterisks, or quotes. This content is included in the second chance offer email sent to the recipient, which can be retrieved with GetMyMessages. 1000 AddSecondChanceItem No AddSecondChanceItem response for a new Second Chance Offer listing. Contains the item ID for the new second chance offer listing. Different from the original ItemID passed in the request. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) AddSecondChanceItem Always Indicates the date and time when the the new second chance offer listing became active and the recipient user could purchase the item. AddSecondChanceItem Always Indicates the date and time when the second chance offer listing expires, at which time the listing ends (if the recipient user does not purchase the item first). AddSecondChanceItem Always Adds a new product folder to a user's Selling Manager account. This call is subject to change without notice; the deprecation process is inapplicable to this call. AddSellingManagerTemplate,GetSellingManagerTemplates Using Selling Manager Calls in the Trading API http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SellingManagerApps Selling Manager page on the eBay Site http://pages.ebay.com/selling_manager/ Selling Manager Pro page on the eBay Site http://pages.ebay.com/selling_manager_pro Name of the new Selling Manager inventory folder. AddSellingManagerInventoryFolder No Unique Folder ID of parent folder. If no ParentFolderID is submitted, Folder is added to root level. AddSellingManagerInventoryFolder No Contains comments that will be associated with this folder. AddSellingManagerInventoryFolder No Returns the status of an add folder operation. New ID of the folder newly created in the user's Selling Manager account. AddSellingManagerInventoryFolder Always Creates a Selling Manager product. Sellers use Selling Manager products to store SYI forms for use as listing templates. This call is subject to change without notice; the deprecation process is inapplicable to this call.

Creates a Selling Manager product, which contains templates for repeat listings.

AddSellingManagerTemplate,GetSellingManagerTemplates,AddSellingManagerInventoryFolder Using Selling Manager Calls in the Trading API http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SellingManagerApps Selling Manager page on the eBay Site http://pages.ebay.com/selling_manager/ Selling Manager Pro page on the eBay Site http://pages.ebay.com/selling_manager_pro Contains product information that the seller has recorded, such as a product description and inventory and restocking details. AddSellingManagerProduct Yes Unique identifier of the folder. This ID is created when the folder is added and is returned by the AddSellingManagerInventoryFolder call. AddSellingManagerProduct No Specifies an eBay category associated with the product, defines Item Specifics that are relevant to the product, and defines variations available for the product (which may be used to create mult-variation listings). AddSellingManagerProduct Yes Response for adding a Selling Manager product. The details of the product. AddSellingManagerProduct Always Adds a Selling Manager template. One product can have up to 20 templates associated with it. This call is subject to change without notice; the deprecation process is inapplicable to this call. GetSellingManagerTemplates Using Selling Manager Calls in the Trading API http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SellingManagerApps Selling Manager page on the eBay Site http://pages.ebay.com/selling_manager/ Selling Manager Pro page on the eBay Site http://pages.ebay.com/selling_manager_pro Contains the data in your template, i.e. the data needed to list an item. The item data you specify will be used when you list items from the template you are adding. AddSellingManagerTemplate Yes The name you provide for the template. If you don't specify a name, then Item.Title is used as the name. AddSellingManagerTemplate No The ID of the product with which the template will be associated. Before calling AddSellingManagerTemplate, you can obtain a product ID from the response of an AddSellingManagerProduct call. That is, after you add a product using AddSellingManagerProduct, a product ID is returned in the SellingManagerProductDetails.ProductID field. The GetSellingManagerTemplates call also returns product IDs. Alternatively, you can obtain information about a user's existing products, including the product IDs, by calling GetSellingManagerInventory. AddSellingManagerTemplate Yes Contains values indicating template information for a newly-exported item. ID of the primary category in which the item would be listed. AddSellingManagerTemplate Always ID of the secondary category (if any) in which the item would be listed. AddSellingManagerTemplate Always The ID of the Selling Manager template. Store this value, for use in other Selling Manager calls. AddSellingManagerTemplate Always Ignore this value. For the output value that indicates the ID of the product associated with the template, use SellingManagerProductDetails.ProductID. AddSellingManagerTemplate Always The name of the template, as it will appear in Selling Manager Pro. This name is the input value you provided in the SaleTemplateName field. If you didn't specify a value for SaleTemplateName, then Item.Title is used as the name. AddSellingManagerTemplate Always The details of the product with which the template is associated. AddSellingManagerTemplate Always Child elements contain the estimated listing fees for the new listing template. Note that the fee will only be charged when an item is created from the template. The fees do not include the Final Value Fee (FVF), which cannot be determined until an item is sold. AddSellingManagerTemplate Always Final Value Fees and Credits http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=FinalValueFeesAndCredits Fees per Site http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=FeesPerSite Using Feature Packs to Save on Upgrade Fees http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=UsingFeaturePacks Appends a horizontal rule, then a message about what time the addition was made by the seller, and then the seller-specified text. Changing Item Descriptions http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ChangingItemDescriptions AddItem, ReviseItem Unique item ID that identifies the target item listing, the description of which is appended with the text specified in Description. 19 (Note: The eBay database specifies 38. Item IDs are usually 9 to 12 digits) AddToItemDescription Yes Specifies the text to append to the end of the listing's description. Text appended to a listing's description must abide by the rules applicable to this data (such as no JavaScript) as is the case when first listing the item. AddToItemDescription Yes Indicates the success or failure of the attempt to add text to the end of the description section of an item listing. Adds one or more items to the user's My eBay watch list. GetMyeBayBuying, GetMyeBaySelling, RemoveFromWatchList The ItemID of the item that is to be added to the watch list. The item must be a currently active item, and the total number of items in the watchlist (after the items in the request have been added) cannot exceed the maximum allowed number of watch list items. One or more ItemID fields can be specified. A separate error node will be returned for each item that fails. Either ItemID or VariationKey is required (but do not pass in both). 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) AddToWatchList No A variation (or set of variations) that you want to watch. Use this to watch a particular variation (not the entire item). Either the top-level ItemID or VariationKey is required (but do not pass in both). AddToWatchList Conditionally Indicates the number of items currently in the user's Watch List and the maximum number of items allowed in the Watch List. The number of items in the user's watch list (after those specified in the call request have been added) AddToWatchList Always The maximum number of items allowed in watch lists. Currently this value is the same for all sites and all users. AddToWatchList Always Ends the eBay Motors listing specified by ItemID and creates a new Transaction Confirmation Request (TCR) for the item, thus enabling the TCR recipient to purchase the item. You can also use this call to see if a new TCR can be created for the specified item.

Ends the eBay Motors listing specified by ItemID and creates a new Transaction Confirmation Request (TCR) for the item, thus enabling the TCR recipient to purchase the item. You can also use this call to see if a new TCR can be created for the specified item.

GetBestOffers, GetBidderList, GetItem, GetSellerList Learning About Bidders http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=LearningAboutBidders Enabling Best Offer http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=EnablingBestOffer Communication Between Members http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=CommunicationBetweenMembers Specifies the user to whom the seller is offering the Transaction Confirmation Request. AddTransactionConfirmationItem Yes If true, specifies that the seller is verifying whether a new Transaction Confirmation Request (TCR) can be created. Thus, if this value is passed as true, then no Transaction Confirmation Request is actually made. If VerifyEligibilityOnly is not passed, or is false, a Transaction Confirmation Request is actually made. AddTransactionConfirmationItem No Specifies the postal code of the user to whom the seller is offering the Transaction Confirmation Request. Required only if the user does not meet the other options listed in RecipientRelationCodeType. An error is returned if RecipientUserID and RecipientPostalCode do not match for more than 3 times for a seller per day. AddTransactionConfirmationItem No Specifies the current relationship between the seller and the potential buyer. A seller can make a Transaction Confirmation Request (TCR) for an item to a potential buyer if the buyer meets one of several criteria. A TCR is sent by a seller to one of the following: a bidder, a best offer buyer, a member with an ASQ question, or any member with a postal code. See the values and annotations in RecipientRelationCodeType. AddTransactionConfirmationItem Yes The amount the offer recipient must pay to buy the item specified in the Transaction Confirmation Request (TCR). A negotiated amount between the buyer and the seller. AddTransactionConfirmationItem Yes Specifies the length of time the item in the Transaction Confirmation Request (TCR) will be available for purchase. AddTransactionConfirmationItem Yes The ItemID of the item that the seller wants to end in order to create a Transaction Confirmation Request (TCR). AddTransactionConfirmationItem Yes Comments the seller wants to send to the recipient (bidder, best offer buyer, member with an ASQ question, or member with a postal code). AddTransactionConfirmationItem No Returns an item ID for a new Transaction Confirmation Request (TCR). The new item ID for the item in the new Transaction Confirmation Request (TCR). This field is not returned if the request was only used to verify that a new TCR could be created. AddTransactionConfirmationItem Conditionally The date and time when the item in the new Transaction Confirmation Request (TCR) becomes available for purchase. AddTransactionConfirmationItem Always The date and time when the item in the new Transaction Confirmation Request (TCR) is no longer available for purchase. AddTransactionConfirmationItem Always Enables a seller to do various tasks after the creation of a single line item or multiple line item order. Typically, this call is used after the buyer has paid for the order, but it can be called by the seller beforehand. Typical post-payment tasks available to this call include marking the order as paid, marking the order as shipped, providing shipment tracking details, and leaving feedback for the buyer. Unique identifier for an eBay item listing. An ItemID can be paired up with a corresponding TransactionID and used in the CompleteSale request to identify a single line item order. Unless an OrderLineItemID is used to identify a single line item order, or the OrderID is used to identify a single or multiple line item order, the ItemID/TransactionID pair must be specified. For a multiple line item order, OrderID must be used. If OrderID or OrderLineItemID are specified, the ItemID/TransactionID pair is ignored if present in the same request. 19 (Note: The eBay database specifies 38. ItemIDs are usually 9 to 12 digits) CompleteSale Conditionally Unique identifier for an eBay order line item (transaction). The TransactionID can be paired up with the corresponding ItemID and used in the CompleteSale request to identify a single line item order. Unless an OrderLineItemID is used to identify a single line item order, or the OrderID is used to identify a single or multiple line item order, the ItemID/TransactionID pair must be specified. For a multiple line item order, OrderID must be used. If OrderID or OrderLineItemID are specified, the ItemID/TransactionID pair is ignored if present in the same request. 19 (Note: The eBay database specifies 38. TransactionIDs are usually 9 to 12 digits.) CompleteSale Conditionally This container is used by the seller to leave feedback for the buyer for the order line item identified in the call request. The seller must include and specify all fields of this type, including the buyer's eBay User ID, the Feedback rating (a seller can only leave a buyer a "Positive" rating), and a comment, which helps justify the Feedback rating. The eBay User ID must match the buyer who bought the order line item, or an error will occur. An error will also occur if Feedback has already been left for the buyer (either through API or the Web flow). To determine if Feedback has already been left for an order line item, you can call GetFeedback, passing in the OrderLineItemID value in the call request. CompleteSale No The seller includes and sets this field to true if the order has been shipped. If the call is successful, the order line item(s) are marked as Shipped in My eBay. If the seller includes and sets this field to false, the order line item(s) are marked (or remain) as Not Shipped in My eBay. If this field is not included, the shipped status of the order line item(s) remain unchanged in My eBay. If shipment tracking information is provided for an order line item through the Shipment container in the same request, the order line item is marked as shipped automatically and the Shipped field is not required. CompleteSale No The seller includes and sets this field to true if the buyer has paid for the order. If the call is successful, the order line item(s) are marked as Paid in My eBay. If the seller includes and sets this field to false, the order line item(s) are marked (or remain) as Not Paid in My eBay. If this field is not included, the paid status of the order line item(s) remain unchanged in My eBay. CompleteSale No This field is required if CompleteSale is being used for a Half.com order. The value should be set to Half, which is the only applicable ListingType value for this call. CompleteSale Half Conditionally Container consisting of shipment tracking information, shipped time, and an optional text field to provide additional details to the buyer. Setting the tracking number and shipping carrier automatically marks the item as shipped and the Shipped field is not required. (If you supply ShipmentTrackingNumber you must also supply ShippingCarrierUsed, otherwise you will get an error. To modify the shipping tracking number and/or carrier, supply the new number in ShipmentTrackingNumber or supply the value for ShippingCarrierUsed or both. The old number and carrier are deleted and the new ones are added. To simply delete the current tracking details altogether, supply empty Shipment tags. Note: Top-Rated sellers must have a record of uploading shipment tracking information (through site or through API) for at least 90 percent of their order line items (purchased by U.S. buyers) to keep their status as Top-Rated sellers. For more information on the requirements to becoming a Top-Rated Seller, see the <a href="http://pages.ebay.com/help/sell/top-rated.html">Becoming a Top-Rated Seller and qualifying for Top-Rated Plus</a> customer support page. CompleteSale No A unique identifier that identifies a single line item or multiple line item order. For a single line item order, the OrderID value is identical to the OrderLineItemID value that is generated upon creation of the order line item. For multiple line item orders, the OrderID value is created by eBay when the buyer is purchasing multiple order line items from the same seller at the same time. For multiple line item orders not going through the eBay Cart flow, a Combined Payment order can be created by the seller through the AddOrder call. The OrderID can be used in the CompleteSale request to identify a single or multiple line item order. OrderID overrides an OrderLineItemID or ItemID/TransactionID pair if these fields are also specified in the same request. CompleteSale No OrderLineItemID is a unique identifier for an eBay order line item and is based upon the concatenation of ItemID and TransactionID, with a hyphen in between these two IDs. For a single line item order, the OrderLineItemID value can be passed into the OrderID field in the CompleteSale request. Unless an ItemID/TransactionID pair is used to identify a single line item order, or the OrderID is used to identify a single or multiple line item order, the OrderLineItemID must be specified. For a multiple line item order, OrderID must be used. If OrderLineItemID is specified, the ItemID/TransactionID pair are ignored if present in the same request. 50 (Note: ItemIDs and TransactionIDs usually consist of 9 to 12 digits.) CompleteSale No Indicates the success or failure of the attempt to leave feedback for the buyer, change the paid status in My eBay, and/or change the shipped status in My eBay. Applies to half.com. When CompleteSale is applied to a specified order (by specifying OrderID), it also applies to the child transactions associated with the order. An OrderID cannot be used with half.com items. Returns the ID of a user who has gone through an application's consent flow process for obtaining an authorization token. FetchToken, GetSessionID, GetTokenStatus, RevokeToken Getting Tokens http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=GettingAToken A string obtained by making a GetSessionID call, passed in redirect URL to the eBay signin page. ConfirmIdentity Yes Confirms the identity of the user by returning the UserID and the EIASToken belonging to the user. Unique eBay user ID for the user. ConfirmIdentity Always Removes selected messages for a given user. AddMemberMessagesAAQToBidder, AddMemberMessageRTQ, GetMemberMessages, GetMyMessages, ReviseMyMessages, ReviseMyMessagesFolders This field will be deprecated in an upcoming release. This field formerly contained a list of up to 10 AlertID values. Contains a list of up to 10 MessageID values. DeleteMyMessages No The response to DeleteMyMessagesRequestType. If the request was successful, DeleteMyMessages returns nothing. Removes an inventory folder when a user deletes it in My eBay. This call is subject to change without notice; the deprecation process is inapplicable to this call.

Removes a Selling Manager inventory folder.

AddSellingManagerTemplate,GetSellingManagerTemplates Using Selling Manager Calls in the Trading API http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SellingManagerApps Selling Manager page on the eBay Site http://pages.ebay.com/selling_manager/ Selling Manager Pro page on the eBay Site http://pages.ebay.com/selling_manager_pro Unique ID of the folder to be deleted. DeleteSellingManagerInventoryFolder No Returns the status of delete folder operation. Removes the association of Selling Manager automation rules to an item. Returns the remaining rules in the response. This call is subject to change without notice; the deprecation process is inapplicable to this call. AddSellingManagerTemplate,GetSellingManagerTemplates Using Selling Manager Calls in the Trading API http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SellingManagerApps Selling Manager page on the eBay Site http://pages.ebay.com/selling_manager/ Selling Manager Pro page on the eBay Site http://pages.ebay.com/selling_manager_pro The ID of the item from which to delete automation rules. DeleteSellingManagerItemAutomationRule Yes If true, the automated relisting rules are removed from the item. DeleteSellingManagerItemAutomationRule No If true, the automated second chance offer rule is removed from the item. DeleteSellingManagerItemAutomationRule No Contains the set of automation rules associated with the specified item. Contains the remaining automated listing rules associated with this item. DeleteSellingManagerItemAutomationRule Conditionally Contains the remaining automated relisting rules associated with this item. DeleteSellingManagerItemAutomationRule Conditionally Contains the remaining automated second chance offer rule associated with this item. DeleteSellingManagerItemAutomationRule Conditionally Contains fees that may be incurred when items are listed using the automation rules (e.g., a scheduled listing fee). Use of an automation rule does not in itself have a fee, but use can result in a fee. DeleteSellingManagerItemAutomationRule Conditionally Deletes a Selling Manager product. This call is subject to change without notice; the deprecation process is inapplicable to this call. AddSellingManagerTemplate,GetSellingManagerTemplates Using Selling Manager Calls in the Trading API http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SellingManagerApps Selling Manager page on the eBay Site http://pages.ebay.com/selling_manager/ Selling Manager Pro page on the eBay Site http://pages.ebay.com/selling_manager_pro ID of the product to be deleted. DeleteSellingManagerProduct Yes Response for deleting a Selling Manager product. The details of the product. DeleteSellingManagerProduct Always Deletes a Selling Manager template. This call is subject to change without notice; the deprecation process is inapplicable to this call. AddSellingManagerTemplate,GetSellingManagerTemplates Using Selling Manager Calls in the Trading API http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SellingManagerApps Selling Manager page on the eBay Site http://pages.ebay.com/selling_manager/ Selling Manager Pro page on the eBay Site http://pages.ebay.com/selling_manager_pro ID of the template to be deleted. You can obtain a SaleTemplateID by calling GetSellingManagerInventory. DeleteSellingManagerTemplate Yes Response for deleting a Selling Manager template. The unique identifier of the template. DeleteSellingManagerTemplate Always The name of the Selling Manager template. DeleteSellingManagerTemplate Always Removes the association of Selling Manager automation rules to a template. Returns the remaining rules in the response. This call is subject to change without notice; the deprecation process is inapplicable to this call. AddSellingManagerTemplate,GetSellingManagerTemplates,SetSellingManagerTemplateAutomationRule Using Selling Manager Calls in the Trading API http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SellingManagerApps Selling Manager page on the eBay Site http://pages.ebay.com/selling_manager/ Selling Manager Pro page on the eBay Site http://pages.ebay.com/selling_manager_pro The ID of the template from which you want to remove automation rules. You can obtain a SaleTemplateID by calling GetSellingManagerInventory. DeleteSellingManagerTemplateAutomationRule Yes If true, the automated listing rules are removed from the template. DeleteSellingManagerTemplateAutomationRule No If true, the automated relisting rules are removed from the template. DeleteSellingManagerTemplateAutomationRule No If true, the automated second chance offer rule is removed from the template. DeleteSellingManagerTemplateAutomationRule No Contains the set of automation rules associated with the specified template. Contains the remaining automated listing rules associated with this template. DeleteSellingManagerTemplateAutomationRule Conditionally Contains the remaining automated relisting rules associated with this template. DeleteSellingManagerTemplateAutomationRule Conditionally Contains the remaining automated second chance offer rule associated with this template. DeleteSellingManagerTemplateAutomationRule Conditionally Contains fees that may be incurred when items are listed using the automation rules (e.g., a scheduled listing fee). Use of an automation rule does not in itself have a fee, but use can result in a fee. DeleteSellingManagerTemplateAutomationRule Conditionally Enables a seller who has opted into the automated Unpaid Item Assistant mechanism to disable the Unpaid Item Assistant at the order line item level. This call can be made whether or not a Unpaid Item dispute exists for the order line item. If a dispute has already been created by the Unpaid Item Assistant, it is converted to a "manual" dispute for the seller to manage like any other manually-created dispute. http://pages.ebay.com/sell/UPI/upiassistant/index.html Unpaid Item Assistant http://pages.ebay.com/sell/UPI/standardprocess/index.html Understanding the New Unpaid Item Process Unique identifier for an eBay item listing. A listing can have multiple order line items (transactions), but only one ItemID. To identify a specific order line item for which to disable the Unpaid Item Assistant mechanism, either an ItemID/TransactionID pair, an OrderLineItemID, or a DisputeID (if a dispute record already exists) is required in the request. 19 (Note: The eBay database specifies 38. ItemIDs are usually 9 to 12 digits) DisableUnpaidItemAssistance Conditionally The unique identifier of an order line item (transaction). An order line item is created once there is a commitment from a buyer to purchase an item. To identify a specific order line item for which to disable the Unpaid Item Assistant mechanism, either an ItemID/TransactionID pair, an OrderLineItemID, or a DisputeID (if a dispute record already exists) is required in the request. 19 (Note: The eBay database specifies 38. TransactionIDs are usually 9 to 12 digits.) DisableUnpaidItemAssistance Conditionally A unique identifier for an Unpaid Item dispute. Any order line item can only have one dispute record, so DisputeID can be used in the request to identify a specific order line item. If an ItemID/TransactionID pair or an OrderLineItemID is used to identify an order line item, DisputeID cannot be used and will be ignored if it is included in the request. DisableUnpaidItemAssistance No OrderLineItemID is a unique identifier for an eBay order line item and is based upon the concatenation of ItemID and TransactionID, with a hyphen in between these two IDs. To identify a specific order line item for which to disable the Unpaid Item Assistant mechanism, either an ItemID/TransactionID pair, an OrderLineItemID, or a DisputeID is required in the request. 100 DisableUnpaidItemAssistance Conditionally Response to DisableUnpaidItemAssistance request. Ends the specified fixed-price listing before the date and time at which it would normally end (per the listing duration). EndItem, RelistFixedPriceItem Ending Items Early http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=EndingItemsEarly Unique item ID that identifies the item listing that you want to end. In the EndFixedPriceItem request, either ItemID or SKU is required. If both are passed in and they don't refer to the same listing, eBay ignores SKU and considers only the ItemID. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) EndFixedPriceItem Conditionally Indicates the seller's reason for ending the listing early. This field is required if the seller is ending the item early and the item did not successfully sell. EndFixedPriceItem Yes The unique SKU of the item being ended. A SKU (stock keeping unit) is an identifier defined by a seller. SKU can only be used to end an item if you listed the item by using AddFixedPriceItem or RelistFixedPriceItem, and you set Item.InventoryTrackingMethod to SKU at the time the item was listed. (These criteria are necessary to uniquely identify the listing by a SKU.) In the EndFixedPriceItem request, either ItemID or SKU is required. If both are passed in and they don't refer to the same listing, eBay ignores SKU and considers only the ItemID. To remove a SKU when you revise or relist an item, use DeletedField in the revision or relist call. 50 EndFixedPriceIteme> Conditionally Acknowledgement that includes SKU, as well as the date and time the auction was ended due to the call to EndFixedPriceItem. Timestamp that indicates the date and time (GMT) that the specified item listing was ended. EndFixedPriceItem Always If a SKU (stock-keeping unit) exists for the item listing, it is returned in the response. 50 EndFixedPriceIteme> Conditionally Ends the specified item listing before the date and time at which it would normally end per the listing duration. Also for Half.com. AddItem, EndFixedPriceItem, EndItems, RelistItem Ending Items Early http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=EndingItemsEarly Unique item ID that identifies the item listing to end. For Half.com listings, you can either specify ItemID or SellerInventoryID. Applicable to Half.com. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) EndItem Yes Indicates the seller's reason for ending the listing early. This field is required if the seller is ending the item early and the item did not successfully sell. Applicable to Half.com. EndItem Yes Unique identifier that the seller specified when they listed the Half.com item. For Half.com items, you can either specify ItemID or SellerInventoryID. If you specify both ItemID and SellerInventoryID, they must be for the same item (otherwise an error will occur). Applicable only to Half.com. EndItem Conditionally Includes the acknowledgement of date and time the auction was ended due to the call to EndItem. Indicates the date and time (returned in GMT) the specified item listing was ended. Also applicable to Half.com. EndItem Always Ends up to 10 specified item listings before the date and time at which it would normally end per the listing duration. Also for Half.com. AddItems, EndItem, RelistItem Ending Items Early http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=EndingItemsEarly A single container for an end item request. Multiple containers should be used to end multiple items. Up to ten (10) containers can be included per a given EndItems request. 10 EndItems Yes Contains a response of the resulting status of ending each item. Returns a response for an individually ended item. Mutiple containers will be listed if multiple items are ended. EndItems Always Gives approved sellers the ability to extend the default and ongoing lifetime of pictures uploaded to eBay. UploadSiteHostedPictures The URL of the image hosted by eBay Picture Services. ExtendSiteHostedPictures No The number of days by which to extend the expiration date for the specified image. ExtendSiteHostedPictures No Returns the URL of an eBay Picture Services image whose expiration date was extended. The URL of the image in eBay Picture Services whose expiration date was extended. ExtendSiteHostedPictures No Retrieves an authentication token for a user. Also for Half.com. ConfirmIdentity, GetSessionID, GetTokenStatus, RevokeToken Getting Tokens http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=GettingAToken Getting Tokens for Applications with Multiple Users http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=GettingATokenViaFetchToken A value associated with the token retrieval request. SecretID is defined by the application, and is passed in the redirect URL to the eBay sign-in page. eBay recommends using a UUID for the secret ID value. You must also set Username (part of the RequesterCredentials) for the particular user of interest. SecretID and Username are not required if SessionID is present. FetchToken No A value associated with the token retrieval request. eBay generates the session ID when the application makes a GetSessionID request. SessionID is passed in the redirect URL to the eBay sign-in page. The advantage of using SessionID is that it does not require UserID as part of the FetchToken request. SessionID is not required if SecretID is present. FetchToken No Includes the authentication token for the user and the date it expires. The authentication token for the user. FetchToken Always Getting Tokens http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=GettingAToken Date and time at which the token returned in eBayAuthToken expires and can no longer be used to authenticate the user for that application. FetchToken Always The REST authentication token for the user. FetchToken Conditionally Returns a seller's invoice data for their eBay account, including the account's summary data. GetSellerDashboard, GetUser Getting Account Information http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=GettingAccountInformation Testing Applications http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=TestingApps Specifies the report format in which to return account entries. GetAccount Conditionally Specifies the month and year of the invoice requested. The report includes only the entries that appear on the seller's invoice in the specified month and year. An entry can occur in one month and appear on the next month's invoice. Used with SpecifiedInvoice reports. GetAccount Conditionally Specifies the beginning of a date range during which a credit or debit occurred. Used when AccountHistorySelection is BetweenSpecifiedDates. Value must be less than or equal to the value specified in EndDate. The allowed date formats are YYYY-MM-DD and YYYY-MM-DD HH:mm:ss. You can retrieve information that is up to 4 months old. GetAccount Conditionally Specifies the end of a date range during which a credit or debit occurred. Used when AccountHistorySelection is BetweenSpecifiedDates. Value must be greater than or equal to the value specified in BeginDate. The allowed date formats are YYYY-MM-DD and YYYY-MM-DD HH:mm:ss. GetAccount Conditionally Controls pagination of the response. For this request, the valid values of Pagination.EntriesPerPage are 0 to 2000, with a default of 500. GetAccount No Specifies whether to calculate balances. Default is false, which calculates balances. The value true means do not calculate balances. If true, AccountEntry.Balance and AccountSummary.CurrentBalance are never returned in the response. GetAccount No Specifies whether to return account summary information in an AccountSummary node. Default is true, to return AccountSummary. GetAccount No Specifies whether to retrieve the rate used for the currency conversion for usage transactions. GetAccount No Specifies how account entries should be sorted in the response, by an element and then in ascending or descending order. GetAccount No Specifies the currency used in the account report. Do not specify Currency in the request unless the following conditions are met. First, the user has or had multiple accounts under the same UserID. Second, the account identified in the request uses the currency you specify in the request. An error is returned if no account is found that uses the currency you specify in the request. GetAccount No Specifies the item ID for which to return account entries. If ItemID is used, all other filters in the request are ignored. If the specified item does not exist or if the requesting user is not the seller of the item, an error is returned. GetAccount No Returns information about an eBay seller's own account. Specifies the seller's unique account number. GetAccount Always Contains summary data for the seller's account, such as the overall balance, bank account and credit card information, and amount and date of any past due balances. Can also contain data for one or more additional accounts, if the user has changed country of residence. GetAccount Conditionally Indicates the currency used for monetary amounts in the report. GetAccount Always Contains individual account entries, according to the report's scope and date range. Each account entry represents one credit, debit, or administrative account action. GetAccount Conditionally Contains the total number of pages (TotalNumberOfPages) and the total number of account entries (TotalNumberOfEntries) that can be returned on repeated calls with the same format and report criteria. GetAccount Always Indicates whether there are more items yet to be retrieved. Additional calls must be made to retrieve those items. GetAccount Conditionally Specifies the number of items that are being returned per virtual page of date. Value is the same as that specified in Pagination.EntriesPerPage. GetAccount Always Indicates which page of data was just returned. Value is the same as the value specified in Pagination.PageNumber. If PageNumber in the request is higher than the total number of pages, the call fails with an error.) GetAccount Always Retrieves sales lead information for a lead generation listing. DetailLevel The unique identifier of an item listed on the eBay site. Returned by eBay when the item is created. This ID must correspond to an ad format item. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) GetAdFormatLeads No Filters the leads based on their status. GetAdFormatLeads No Boolean which indicates whether to return mail messages for this lead in a MemberMessage node. GetAdFormatLeads No Used with EndCreationTime to limit the returned leads for a user to only those with a creation date greater than or equal to the specified date and time. GetAdFormatLeads Conditionally Used with StartCreationTime to limit the returned leads for a user to only those with a creation date less than or equal to the specified date and time. GetAdFormatLeads Conditionally Returns number of leads and contact and other information for each lead. One AdFormatLead node is returned for each lead. Contains contact and other information for one lead. One node is returned for each lead. Only returned at a detail level of ReturnAll. At least one lead must be available for the specified item to return AdFormatLead. GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally The total number of leads returned. Only returned if you do not specify a detail level. GetAdFormatLeads

DetailLevel: none

Always Provides three modes for retrieving a list of the users that bid on a listing. AddSecondChanceItem Making Second Chance Offers for Items http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ExtendingSecondChanceOffer detailed information on working with the result set. Making Second Chance Offers for Items http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=MakingSecondChanceOffersForItems The ID of the item. The bidders who bid on this item are returned. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) GetAllBidders Yes Specifies which bidder information to return. GetAllBidders Yes Specifies whether return BiddingSummary container for each offer. GetAllBidders Conditionally Includes the list of bidders for the requested item as part of the general item listing data. Some bidder information is anonymous, to protect bidders from fraud. If the seller makes this API call, the actual ids of all bidders on the seller's item will be returned. If a bidder makes this API call, the bidder's actual id will be returned. Information for all competing bidders or outside watchers will be returned as anonymized userIDs. See See <a href="http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=AnonymousUserInfo">Working with Anonymous User Information</a>in the eBay Web Services Guide for more information. Contains a list of OfferType objects. Each OfferType object represents the data for one bidder and bid. GetAllBidders Always eBay user ID for the user with the highest bid (or the earliest timestamp, in the event of a tie); a second chance offer candidate. GetAllBidders Always Bid amount offered by the HighBidder. GetAllBidders Always Specifies an active or ended listing's status in eBay's processing workflow. If a listing ends with a sale (or sales), eBay needs to update the sale details (e.g., winning bidder) and other information. This processing can take several minutes. If you retrieve a sold item, use this listing status information to determine whether eBay has finished processing the listing so that you can be sure the winning bidder and other details are correct and complete. GetAllBidders Always Reports how many calls your application has made and is allowed to make per hour or day. Also for Half.com. http://developer.ebay.com/support/certification Compatible Application Check Responds to a call to GetApiAccessRules. Contains the description of an API access rule, including the call name, the application's current daily and hourly usage, and other values. GetApiAccessRules Always This type is deprecated as the call is no longer available. A version of the Item Specifics definitions (attribute meta-data) for the site. Typically, an application passes the version value that was returned the last time the application executed this call. Filter that causes the call to return only the characteristic sets for which the attribute meta-data has changed since the specified version. If not specified, all characteristics sets are returned. The latest version value is not necessarily greater than the previous value that was returned. Therefore, when comparing versions, only compare whether the value has changed. An array of characteristic setIDs (which always correspond to attribute set IDs). Each characteristic setcorresponds to a level in the eBay category hierarchy at which all items share common characteristics. Multiple categories can be mapped to the same characteristic set. AttributeSetIDs is an optional input. When IDs are specified, the call only returns meta-data for the corresponding characteristic sets. When no IDs are specified, the call returns all the current attribute meta-data in the system. If true, includes a list of CategoryMapping nodes in the response. Each CategoryMapping node specifies category information as well as attributes and values that your application can auto-fill for items listed in that category. See the eBay Web Services Guide for more information about options for maintaining category data and auto-filling Item Specifics. This type is deprecated as the call is no longer available. Current version of the Item Specifics meta-data system for the site. This value changes each time changes are made to the meta-data. The current version value is not necessarily greater than the previous value. Therefore, when comparing versions, only compare whether the value has changed. A string containing a list of all the attributes that are applicable to the site (or characteristic sets in the request), along with related meta-data. The meta-data specifies all the possible values of each attribute, the logic for presenting attributes to a user, and rules for validating the user's selections. Individual elements are not described in the eBay schema format. For information about each element in the AttributeData string, see the attribute model documentation in the eBay Web Services guide (see links below). Because this is returned as a string, the XML markup elements are escaped with character entity references (e.g., &lt;eBay&gt;&lt;Attributes&gt; ...). See the appendices in the eBay Web Services guide for general information about string data types. This type is deprecated as the call is no longer available. The name of the XSL file to retrieve. If not specified, the call returns the latest versions of all available XSL files. FileName is an optional input. Valid values syi_attributes.xsl The desired version of the XSL file. Required if FileName is specified. If not specified, the call returns the latest version of the file. (This is not a filter for retrieving changes to the XSL file.) This type is deprecated as the call is no longer available. Child elements contain data related to one XSL file. Multiple XSLFile objects can be returned. However, currently only one is returned. Retrieves Best Offers. DetailLevel RespondToBestOffer, PlaceOffer Enabling Best Offer http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=EnablingBestOffer Email and Address Privacy Policy http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=EmailPrivacyPolicy The ID of the listing for which Best Offer information is to be returned. See the description of GetBestOffers for details related to who makes the request and how ItemID and BestOfferID can be omitted. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) GetBestOffers No The ID of the Best Offer for which information is to be returned. See the description of GetBestOffers for details related to who makes the request and how ItemID and BestOfferID can be omitted. GetBestOffers No This optional filter controls whether only active Best Offers are retrieved or all Best Offers (even Best Offers that were declined or all no longer the "best offer"). The "All" value can only be specified if an ItemID value is also supplied in the request. Active GetBestOffers All, Active No Specifies how to create virtual pages in the returned list (such as total number of entries and total number of pages to return). GetBestOffers No All Best Offers for the item according to the filter or Best Offer ID (or both) used in the input. For the notification client usage, this response includes a single Best Offer. All Best Offers for the item according to the filter or Best Offer id (or both) used in the input. The buyer and seller messages are returned only if the detail level is defined. Includes the buyer and seller message only if the ReturnAll detail level is used. Only returned if Best Offers have been made. GetBestOffers

DetailLevel: none, ReturnAll

Conditionally The item for which Best Offers are being returned. Only returned if Best Offers have been made. GetBestOffers

DetailLevel: none, ReturnAll

Conditionally A collection of details about the Best Offers received for a specific item. Empty if there are no Best Offers. GetBestOffers

DetailLevel: none, ReturnAll

Conditionally Specifies the number of the page of data to return in the response. Default is 1 for most calls. For some calls, the default is 0. Specify a positive value equal to or lower than the number of pages available (which you determine by examining the results of your initial request). See the documentation for other individual calls to determine the correct default value. For GetOrders, PageNumber is only applicable to Half.com (is not applicable to eBay.com). 1 1 GetBestOffers

DetailLevel: none, ReturnAll

Conditionally Provides information about the data returned, including the number of pages and the number of entries. GetBestOffers

DetailLevel: none, ReturnAll

Conditionally Retrieves all items the user is currently bidding on, and the ones they have won or purchased. AddItem, GetItem, GetSellerList, RelistItem, ReviseItem Retrieves all items the user is currently bidding on, and the ones they have won or purchased. Indicates whether or not to limit the result set to active items. If true, only active items are returned and the EndTimeFrom and EndTimeTo filters are ignored. If false (or not sent), both active and ended items are returned. GetBidderList No Used in conjunction with EndTimeTo. Limits returned items to only those for which the item's end date is on or after the date-time specified. Specify an end date within 30 days prior to today. Items that ended more than 30 days ago are omitted from the results. If specified, EndTimeTo must also be specified. Express date-time in the format YYYY-MM-DD HH:MM:SS, and in GMT. (For information on how to convert between your local time zone and GMT, see Time Values Note.) This field is ignored if ActiveItemsOnly is true. GetBidderList Conditionally Used in conjunction with EndTimeFrom. Limits returned items to only those for which the item's end date is on or before the date-time specified. If specified, EndTimeFrom must also be specified. Express date-time in the format YYYY-MM-DD HH:MM:SS, and in GMT. This field is ignored if ActiveItemsOnly is true. Note that for GTC items, whose end times automatically increment by 30 days every 30 days, an EndTimeTo within in the first 30 days of a listing will refer to the listing's initial end time. GetBidderList Conditionally The user for whom information should be returned. If provided, overrides user defined via RequesterCredentials in header. GetBidderList No You can control some of the fields returned in the response by specifying one of two values in the GranularityLevel field: Fine or Medium. Fine returns more fields than the default, while setting this field to Medium returns an abbreviated set of results. Yes GetBidderList No Response to a GetBidderList call, which retrieves all items the user is currently bidding on, or has won or purchased. Response to GetBidderListRequest. Data for one eBay bidder. GetBidderList Always Array of items the bidder has bid on, has won or has lost. GetBidderList Always Retrieves the latest eBay category hierarchy for a given eBay site. Information returned for each category includes the category name and the unique ID for the category (unique within the eBay site for which categories are retrieved). A category ID is a required input when you list most items.

Retrieves the latest eBay category hierarchy for a given eBay site. Information returned for each category includes the category name and the unique ID for the category (unique within the eBay site for which categories are retrieved). A category ID is a required input when you list most items.

DetailLevel Categories http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=CategoryOverview GetCategoryFeatures, GetCategoryMappings, GetCategorySpecifics, GetSuggestedCategories Specifies the eBay site for which to retrieve the category hierarchy. Use the numeric site code (e.g., 77 for eBay Germany). Only necessary if you want to retrieve category data for a site other than the site from which you are submitting the request. NOTE: If you are using the GetCategories call with eBay Motors, you must set the Site ID in the Request Header to 0, and then set the CategorySiteID to 100. These are both required fields when using GetCategories with eBay Motors. GetCategories No The site ID of the request Specifies the ID of the highest-level category to return, along with its subcategories. If no parent category is specified, all categories are returned for the specified site. (Please do not pass a value of 0; zero (0) is an invalid value for CategoryParent.) To determine available category IDs, call GetCategories with no filters and use a DetailLevel value of ReturnAll. If you specify multiple parent categories, the hierarchy for each one is returned. GetCategories No Specifies the maximum depth of the category hierarchy to retrieve, where the top-level categories (meta-categories) are at level 1. Retrieves all category nodes with a category level less than or equal to this value. If not specified, retrieves categories at all applicable levels. As with all calls, the actual data returned will vary depending on how you configure other fields in the request (including DetailLevel). GetCategories No 0 This flag controls whether all eBay categories (that satisfy input filters) are returned, or only leaf categories (you can only list items in leaf categories) are returned. The default value is 'true', so if this field is omitted, all eBay categories will be returned. If you only want to retrieve leaf categories, include this flag and set it to 'false'. The actual data returned will vary depending on how you configure other fields in the request. GetCategories No true Contains the category data for the eBay site specified as input. The category data is contained in a CategoryArrayType object, within which are zero, one, or multiple CategoryType objects. Each CategoryType object contains the detail data for one category. Other fields tell how many categories are returned in a call, when the category hierarchy was last updated, and the version of the category hierarchy (all three of which can differ from one eBay site to the next). List of the returned categories. The category array contains one CategoryType object for each returned category. Returns empty if no detail level is specified. GetCategories

DetailLevel: ReturnAll

Always Indicates the number of categories returned (i.e., the number of CategoryType objects in CategoryArray). GetCategories

DetailLevel: ReturnAll

Always Indicates the last date and time that eBay modified the category hierarchy for the specified eBay site. GetCategories

DetailLevel: ReturnAll, none

Always Indicates the version of the category hierarchy on the specified eBay site. GetCategories

DetailLevel: ReturnAll, none

Always If true, ReservePriceAllowed indicates that all categories on the site allow the seller to specify a reserve price for an item. If false, this field is not returned in the response and all categories on the site do not normally allow sellers to specify reserve prices. The Category.ORPA (override reserve price allowed) field can override (or toggle) the reserve price allowed setting for a given category. For example, if ReservePriceAllowed is false and Category.ORPA is true, the category overrides the site setting and supports reserve prices. If ReservePriceAllowed is true and Category.ORPA is true, the category overrides the site setting and does does not support reserve prices. GetCategories

DetailLevel: ReturnAll, none

Always Indicates the lowest possible reserve price allowed for any item listed in any category on the site. You can use the fields returned by GetCategoryFeatures to determine if a different Minimum Reserve Price is defined for the category you want to use. GetCategories

DetailLevel: ReturnAll, none

Always If true, ReduceReserveAllowed indicates that all categories on the site allow the seller to reduce an item's reserve price. If false, this field is not returned in the response and all categories on the site do not normally allow sellers to reduce an item's reserve price. The Category.ORRA (override reduce reserve price) field can override (or toggle) the reserve price reduction setting for a given category. For example, if ReduceReserveAllowed is false and Category.ORRA is true, the category overrides the site setting and supports reducing reserve prices. If ReduceReserveAllowed is true and Category.ORRA is true, the category overrides the site setting and does does not support reducing reserve prices. GetCategories

DetailLevel: ReturnAll, none

Always No longer recommended in general, although this call may still be used to determine whether a category is catalog-enabled. All other features of this call are no longer functional.

No longer recommended.

ID of a category for which to retrieve mappings. If not specified, the call retrieves a map for all categories. 10 GetCategory2CS No A version of the mappings for the site. Typically, an application passes the version value that was returned the last time the application executed this call. Filter that causes the call to return only the categories for which the mappings have changed since the specified version. If not specified, all category-to-characteristics set mappings are returned. This value changes each time changes are made to the mappings. The current version value is not necessarily greater than the previous value. Therefore, when comparing versions, only compare whether the value has changed. GetCategory2CS No Only applicable for determining whether a category is catalog-enabled. 773 Avoid GetCategoryFeatures, FindProducts 889 Contains data about categories that are mapped to characteristics sets. Use this data to determine: - The names and IDs of the characteristics sets - The availability of the Pre-filled Item Information feature for listings in that category (i.e., whether the category is catalog-enabled) - For catalog-enabled categories, the available product search methods - The current version information for the complete mapping - The version information for each characteristics set GetCategory2CS

DetailLevel: ReturnAll

Conditionally Contains data about categories (if any) whose characteristics set mappings have changed since the version specified in the request. When a characteristics set mapping changes, the data appears in both the UnmappedCategoryArray object (to indicate that the change occurred) and the MappedCategoryArray object. GetCategory2CS

DetailLevel: ReturnAll

Conditionally 773 Avoid 889 Current version of the mappings for the site. This value changes each time changes are made to the mappings. The current version value is not necessarily greater than the previous value. Therefore, when comparing versions, only compare whether the value has changed. GetCategory2CS

DetailLevel: none, ReturnAll

Always A list of one or more characteristics sets mapped to the category, if any. Use this information when working with Item Specifics (Attributes) and Pre-filled Item Information (Catalogs) functionality. GetCategory2CS

DetailLevel: ReturnAll

Conditionally 773 Avoid GetCategoryFeatures 889 Returns information about the features that are applicable to different categories, such as listing durations, shipping term requirements, and Best Offer support. DetailLevel Categories http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=CategoryOverview GetCategories, GetCategorySpecifics, GeteBayDetails Specifies the category for which you want to retrieve the feature settings. Specify a CategoryID, set DetailLevel to ReturnAll, and set ViewAllNodes to true to return the default site settings, the overrides for the specified category, plus all the child categories that have overrides on the features they inherit. If you also set AllFeaturesForCategory to true, eBay returns the site defaults, plus all the settings for the specified category. Child category information is not returned in this case. If CategoryID is not specified, eBay returns the feature settings for the site. To return details on all categories that have overrides on the properties they inherit, set DetailLevel to ReturnAll, and set ViewAllNodes to true. If you also set AllFeaturesForCategory to true, eBay returns only the site defaults with no child category information. 10 GetCategoryFeatures No A level of depth in the category hierarchy. Retrieves all category nodes with a CategoryLevel less than or equal to the LevelLimit value. GetCategoryFeatures No You must set DetailLevel to ReturnAll in order to correctly populate the response when you set ViewAllNodes to true. In this case, eBay returns the site defaults along with all the categories that override the feature settings they inherit. Here, each Category container shows only the features that it has overridden from its parent node. If you also specify a CategoryID, eBay returns the details for that category, along with containers for each of its child categories that have feature overrides. Note that if ViewAllNodes is set to false (the default) and DetailLevel is set to ReturnAll, eBay returns only the leaf categories that have features that override the settings they inherit. In this case, the call will not return leaf categories that do not have overrides. GetCategoryFeatures No false Use this field if you want to know if specific features are enabled at the site or root category level. Multiple FeatureID elements can be used in the request. If no FeatureID elements are used, the call retrieves data for all features, as applicable to the other request parameters. GetCategoryFeatures No Use this switch to view all of the feature settings for a specific category. All feature settings are returned, regardless of the site default settings. This element works in conjunction with CategoryID--refer to the notes for that element for more details. If you also set FeatureID, eBay returns the status of the specified features only, for the specified category. GetCategoryFeatures No false Returns the current version of the set of feature meta-data. Compare this value to the version of the last version you downloaded to determine whether the data may have changed. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Always Gives the time in GMT that the feature flags for the category hierarchy were last updated. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Always A category whose feature settings are different from the settings of its parent category. For example, suppose there is a branch of the category tree with 5 category levels (L1, L2, L3, L4, and L5). Suppose the feature settings for SiteDefaults, L1, L4, and L5 are all "A", and the settings for L2 and L3 are "B". In this case: L1's settings (A) match the site default, so L1 is not returned. L2's settings (B) are different from L1's, so L2 is returned. L3's settings (B) are the same as L2's, so L3 is not returned L4's settings (A) are different from L3's, so L4 is returned L5's settings (A) are the same as L4's, so L5 is not returned. If you specified a particular FeatureID in the request, this field only returns feature settings for that feature. Only returned when the category is different from its parent. If the category has children and they aren't returned, it means the children inherit the category's feature settings. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Returns the feature settings defined for most categories on the site. Most categories share these settings. However, some categories can override some settings, as indicated in the Category nodes (if any). GetCategoryFeatures

DetailLevel: ReturnAll

Always Returns definitions of the various features on the site, or the features you requested in FeatureID (if any). Each feature has a node within FeatureDefinitions. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Always Retrieves a map of old category IDs and corresponding active category IDs defined for the site to which the request is sent. GetCategories, GetCategoryFeatures DetailLevel Maintaining Category Data http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=CategoryMapping Maintaining Category Data http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=CategorySync A version of the category mapping for the site. Filters out data from the call to return only the category mappings for which the data has changed since the specified version. If not specified, all category mappings are returned. Typically, an application passes the version value of the last set of category mappings that the application stored locally. The latest version value is not necessarily greater than the previous value that was returned. Therefore, when comparing versions, only compare whether the value has changed. GetCategoryMappings No Returns a map of old category IDs and corresponding active category IDs defined for the site to which the request was sent. Typically used to update an older item definition with a new category ID prior to listing the item. Mapping between an old category ID and an active category ID. Returned when category mappings exist and the value of CategoryVersion is different from the current version on the site. GetCategoryMappings

DetailLevel: ReturnAll

Conditionally Version value assigned to the current category mapping data for the site. Compare this value to the version value the application stored with the mappings the last time the application executed the call. If the versions are the same, the data has not changed since the last time the data was retrieved and stored. GetCategoryMappings

DetailLevel: none, ReturnAll

Always Returns the most popular custom Item Specific names and values for each leaf category you request. AddItem, GetCategories, GetCategoryFeatures samples Working with Custom Item Specifics http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ItemSpecifics A leaf-level eBay category ID. This call retrieves recommended Item Specifics (if any) for each leaf category you specify. (The call returns no results for a parent category.) To determine which leaf categories support listing with custom Item Specifics, use GetCategoryFeatures. Note: This call may return recommendations for categories that don't support listing with custom Item Specifics. That is, the presence of recommendations for a category does not necessarily mean that AddItem supports custom Item Specifics for that category and site. The request requires either CategoryID, CategorySpecfics.CategoryID, or CategorySpecificsFileInfo (or the call returns an error). CategoryID and CategorySpecific.CategoryID can both be used in the same request. (CategorySpecific offers more options to control the response.) Some input fields, such as IncludeConfidence, only work when CategoryID or CategorySpecfics.CategoryID is specified. You can specify multiple leaf categories, but more categories can result in longer response times. If your request times out, specify fewer IDs. If you specify the same ID twice, we use the first instance. 100 GetCategorySpecifics Conditionally Causes the recommendation engine to check whether the list of popular Item Specifics for each specified category has changed since this date and time. If specified, this call returns no Item Specifics; it only returns whether the data has changed for any of the requested categories. Typically, you pass in the Timestamp that was returned the last time you refreshed the list of names and values for the same categories. If the Updated flag returns true for any categories in the response, call GetCategorySpecifics again for those categories to get the latest names and values. (As downloading all the data may affect your application's performance, it may help to only download Item Specifics for a category if they have changed since you last checked.) GetCategorySpecifics Conditionally Maximum number of Item Specifics to return per category (where each Item Specific is identified by a unique name within the category). Use this to retrieve fewer results per category. For example, if you only want up to 2 per category (the top 2 most popular names), specify 2. 1 30 10 GetCategorySpecifics No Maximum number of values to retrieve per item specific. The best practice for using this field depends on your use case. For example, if you want all possible values (such as all brands and sizes in a clothing category), then specify a very large number. (This is recommended in most cases.) If you only want the most popular value (like the most popular color), then specify a small number. 1 2147483647 25 GetCategorySpecifics No The name of one Item Specific name to find values for. Use this if you want to find out whether a name that the seller provided has recommended values. If you specify multiple leaf categories in the request, the recommendation engine returns all matching names and values it finds for each of those categories. At the time of this writing, this value is case-sensitive. (Wildcards are not supported.) Name and CategorySpecific.ItemSpecific can be used in the request. (If you plan to only use one or the other in your application, you should use ItemSpecific, as it may offer more options in the future.) 30 GetCategorySpecifics No Applicable with request version 609 and higher. (This does not retrieve data at all if your request version is lower than 609.) Contains a leaf category for which you want recommended Item Specifics, and (optionally) names and values to help you refine the recommendations. You can specify multiple categories (but more categories can result in longer response times). If you specify the same category twice, we use the first instance. Depending on how many recommendations are found, your request may time out if you specify too many categories. (Typically, you can download recommendations for about 275 categories at a time.) CategoryID and CategorySpecific.CategoryID can be used in the request. (If you plan to only use one or the other in your application, you should use CategorySpecific, as it may offer more options in the future.) 275 GetCategorySpecifics Conditionally If true, the Relationship node is not returned for any recommendations. Relationship recommendations tell you whether an Item Specific value has a logical dependency another Item Specific. For example, in a clothing category, Size Type could be recommended as a parent of Size, because Size=Small would mean something different to buyers depending on whether Size Type=Petite or Size Type=Plus. In general, it is a good idea to retrieve and use relationship recommendations, as this data can help buyers find the items they want more easily. GetCategorySpecifics false No If true, returns eBay's level of confidence in the popularity of each name and value for the specified category. Some sellers may find this useful when choosing whether to use eBay's recommendation or their own name or value. Requires CategoryID to also be passed in. If you try to use this with CategorySpecificsFileInfo but without CategoryID, the request fails and no TaskReferenceID or FileReferenceID is returned. GetCategorySpecifics false No If true, the response includes FileReferenceID and TaskReferenceID. Use these IDs as inputs to the downloadFile call in the eBay File Transfer API. That API lets you retrieve a single (bulk) GetCategorySpecifics response with all the Item Specifics recommendations available for the requested site ID. (The downloadFile call downloads a .zip file as an attachment.) Either CategorySpecificsFileInfo or a CategoryID is required (or you can specify both). Note: You can use the File Transfer API without using or learning about the Bulk Data Exchange API or other Large Merchant Services APIs. GetCategorySpecifics Conditionally downloadFile in the File Transfer API http://developer.ebay.com/DevZone/file-transfer/CallRef/downloadFile.html Calls made form seller or buyer find out what the most relevant tags and values are for a given category Contains the most popular Item Specifics, if any, for a category specified in the request, or contains information about whether the recommendations have changed for that category since the LastUpdateTime you requested. The most relevant Item Specifics (as determined by eBay) are returned first. In many cases, the values are returned in alphabetical order. This node returns empty (or it's not returned) for a category if there is no applicable data (such as when you request a parent category, a category that has no popular Item Specifics yet, or a duplicate category that was already returned). If you pass in the CategoryID and Name fields together, but no matching values are found for the name, eBay returns the name with no values (even if the name is not recommended). If GetCategoryFeatures indicates that custom Item Specifics are enabled for a leaf category, but GetCategorySpecifics doesn't return any recommendations for that category, the seller can still specify their own custom Item Specifics in that category. 275 GetCategorySpecifics Conditionally Use TaskReferenceID and FileReferenceID as inputs to the downloadFile call in the eBay File Transfer API. That API lets you retrieve a single (bulk) GetCategorySpecifics response with all the Item Specifics recommendations available for the requested site ID. (The downloadFile call downloads a .zip file as an attachment.) Only returned when CategorySpecificsFileInfo is passed in the request. GetCategorySpecifics Conditionally downloadFile in the File Transfer API http://developer.ebay.com/DevZone/file-transfer/CallRef/downloadFile.html Use TaskReferenceID and FileReferenceID as inputs to the downloadFile call in the eBay File Transfer API. That API lets you retrieve a single (bulk) GetCategorySpecifics response with all the Item Specifics recommendations available for the requested site ID. (The downloadFile call downloads a .zip file as an attachment.) Only returned when CategorySpecificsFileInfo is passed in the request. GetCategorySpecifics Conditionally downloadFile in the File Transfer API http://developer.ebay.com/DevZone/file-transfer/CallRef/downloadFile.html Retrieves a botblock token and URLs for an image or audio clip that the user is to match. ValidateChallengeInput, PlaceOffer Response to GetChallengeToken request. Botblock token that is used to validate that the user is a human and not a bot. GetChallengeToken Always The URL of the image your application should display to the user for a botblock challenge. GetChallengeToken Always The URL of the audio clip your application should provide for sight-impaired users. The audio clip corresponds to the image. GetChallengeToken Always Searches for nonprofit charity organizations that meet the criteria specified in the request. It is recommended that you use at least one input filter, because this call no longer returns all charities when made without filters. Identifying Listings that Benefit Nonprofits http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=IdentifyingListingsThatBenefitNonprofits A unique identification number assigned by eBay to registered nonprofit charity organizations. GetCharities No A name assigned to a specified nonprofit organization. Accepts full charity nonprofit name or partial name as input. For example, enter a CharityName of "heart" (case-insensitive) to return all charity nonprofits that start with "heart." Use with a MatchType value of "Contains" to return all charity nonprofits that contain the string "heart." 150 GetCharities No Accepts a case-insensitive string used to find a nonprofit charity organization. Default behavior is to search the CharityName field. Use with an IncludeDescription value of true to include the Mission field in the search. 350 (characters) GetCharities No Region that the nonprofit charity organization is associated with. A specific nonprofit charity organization may be associated with only one region. Meaning of input values differs depending on the site. See GetCharities in the API Developer's Guide for the meaning of each input/output value. CharityRegion input value must be valid for that SiteID. GetCharities No Domain (mission area) that a nonprofit charity organization belongs to. Nonprofit charity organizations may belong to multiple mission areas. Meaning of input values differs depending on the site. GetCharities No Used with Query to search for charity nonprofit organizations. A value of true will search the Mission field as well as the CharityName field for a string specified in Query. GetCharities No Indicates the type of string matching to use when a value is submitted in CharityName. If no value is specified, default behavior is "StartsWith." Does not apply to Query. GetCharities No Used to decide if the search is only for featured charities. A value of true will search for only featured charities. GetCharities No Reserved for future use. Contains information about charity nonprofit organizations that meet the criteria specified in the request. Contains information about charity nonprofit organizations that meet the criteria specified in the request. One Charity node is returned for each applicable nonprofit charity organization. The CharityID value is returned as an id attribute of this node. If no nonprofit charity organization is applicable, this node is not returned. GetCharities Conditionally Retrieves a token required for the GetUserAlerts call in the Client Alerts API. SetNotificationPreferences http://developer.ebay.com/DevZone/client-alerts/docs/CallRef/index.html Client Alerts API Call Reference Returns a Client Alerts token. This token string is required for the Login call in the Client Alerts API. The Client Alerts GetUserAlerts call, which returns alerts about events associated with a specific user, requires Login. GetClientAlertsAuthToken Always A Client Alerts token expires after seven days. GetClientAlertsAuthToken Always Retrieves top-ranked contextual eBay keywords and categories for a specified web page. SG, HK The URL of the web page from which eBay is to extract keywords. GetContextualKeywords Yes Web page encoding by which the URL is to be handled, such as ISO-8859-1. GetContextualKeywords Yes The ID of the category to which keywords are to be limited. Zero or more category IDs can be specified. GetContextualKeywords No Response to a GetContextualKeywords request. An array of either keyword/category pairs or categories, with ranking and score. GetContextualKeywords Always No longer recommended. The eBay Store Cross Promotions are no longer supported in the Trading API. Retrieves a list of upsell or cross-sell items associated with the specified Item ID. GetPromotionRules, SetPromotionalSale Cross-Promotions http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=CrossPromotionsChapter The unique ID of the referring item. The cross-promoted items will supplement this item. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) GetCrossPromotions Yes The cross-promotion method you want to use for the returned list, either UpSell or CrossSell. GetCrossPromotions Yes The role of the person requesting to view the cross-promoted items, either seller or buyer. Default is buyer. GetCrossPromotions No No longer recommended. The eBay Store Cross Promotions are no longer supported in the Trading API, so the CrossPromotion container will either not be returned, or, if it is returned, the data in the container may not be accurate. Returns a list of either upsell or cross-sell items for a given item ID. The list can be filtered by the viewer's role, either buyer or seller. eBay Store Cross Promotions are no longer supported in the Trading API, so the CrossPromotion container will either not be returned, or, if it is returned, the data in the container may not be accurate. A list of cross-promoted items defined for a specific referring item. The list is either upsell or cross-sell items, according to the value of PromotionMethod in GetCrossPromotionsRequest. Not applicable to Half.com. GetCrossPromotions Always Retrieves the DescriptionTemplates for a category. Retrieves Theme and Layout specifications for the display of an item's description. Using Description Templates http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=UsingDescriptionTemplatesChapter The category for which to retrieve templates. Enter any category ID, including Motors vehicle categories. This is ignored if you also send MotorVehicles. 10 GetDescriptionTemplates No If specified, only those templates modified on or after the specified date are returned. If not specified, all templates are returned. GetDescriptionTemplates No Indicates whether to retrieve templates for motor vehicle categories for eBay Motors (site 100). If true, templates are returned for motor vehicle categories. If false, templates are returned for non-motor vehicle categories such as Parts and Accessories. If included as an input field (whether true or false), this overrides any value provided for CategoryID. GetDescriptionTemplates No Returns one or more DescriptionTemplate nodes. Each DescriptionTemplate node contains the information for one Theme or one Layout. DescriptionTemplate.DescriptionTemplateType indicates whether it contains data for a Theme or a Layout. Returned after calling GetDescriptionTemplatesRequest. The information for one Theme or one Layout. There can be multiple DescriptionTemplates. GetDescriptionTemplates Always The number of Layout templates returned (that is, the number of DescriptionTemplates for which Type is "Layout"). GetDescriptionTemplates Always The ID of a returned layout that is obsolete. There can be zero or more IDs. GetDescriptionTemplates Conditionally The ID of a returned theme that is obsolete. There can be zero or more IDs. GetDescriptionTemplates Conditionally Data for one theme group. There can be multiple ThemeGroups in the response. GetDescriptionTemplates Conditionally The number of Theme templates returned (that is, the number of DescriptionTemplates for which Type is "Theme"). GetDescriptionTemplates Always Retrieves the details of a specific eBay dispute corresponding to the supplied dispute ID. AddDispute, AddDisputeResponse, GetItemTransactions, GetSellerTransactions, GetUserDisputes, SellerReverseDispute Unpaid Item Disputes http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=UnpaidItemDisputes Buyer Disputes http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=BuyerDisputes Getting Details About a Dispute http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=GettingDetailsAboutADispute The unique identifier of an eBay dispute. The caller passes in this value to retrieve detailed information on a specific dispute. GetDispute Yes Returned after calling GetDisputeRequest. Returns the record of a dispute, including the dispute state and other information. Both Sellers and Buyers can use the SellerClosedDispute in Platform Notifications to receive a notification when a dispute has been closed. The notification includes the same data that is returned in the GetDispute response. The dispute record, containing information about the buyer, seller, dispute state, dispute status, comments added to the dispute, or resolutions. GetDispute Always Retrieves the accumulated feedback left for a specified user or the summary feedback data for a specific order line item or item listing. Also for Half.com. DetailLevel LeaveFeedback, GetSellerDashboard, GetSellerTransactions Leaving and Retrieving Feedback http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=Feedback Introduction to Feedback http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=FeedbackIntro Getting Feedback Left By Another User http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=FeedbackGet Detailed Seller Ratings http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=DetailedSellerRatings Specifies the user whose feedback data is to be returned. If not specified, then the feedback returned is for the requesting user. GetFeedback No An ID that uniquely identifies a feedback record to be retrieved. Used only by the Feedback notification. GetFeedback No Unique identifier for an eBay item listing. A listing can have multiple order line items (transactions), but only one ItemID. If ItemID is specified in the GetFeedback request, the returned feedback records are restricted to the specified ItemID. The FeedbackType and Pagination fields (if included) are ignored. The maximum number of feedback records returned is 100. 19 (Note: The eBay database specifies 38. ItemIDs are usually 9 to 12 digits) GetFeedback No Unique identifier for an eBay order line item (transaction). A TransactionID can be paired up with its corresponding ItemID and used as an input filter in the GetFeedback request. If an ItemID/TransactionID pair or an OrderLineItemID value is used to retrieve a feedback record on a specific order line item, the FeedbackType and Pagination fields (if included) are ignored. 19 (Note: The eBay database specifies 38. TransactionIDs are usually 9 to 12 digits.) GetFeedback No Returns feedback of a specified type (positive, negative, or neutral) in FeedbackDetailArray. You can include two comment types in your call if you want to exclude the third type from your results. If no CommentType is specified, all of the feedback types are returned. GetFeedback No Returns feedback that you received as a buyer or seller, or feedback you left for others (as either a buyer or a seller). You can include only one FeedbackType in your call. If no FeedbackType is specified, all of the available feedback is returned. GetFeedback No Controls the pagination of the result set. Child elements, EntriesPerPage and PageNumber, specify the maximum number of individual feedback records to return per call and which page of data to return. Only applicable if DetailLevel is set to ReturnAll and the call is returning feedback for a UserID. Feedback summary data is not paginated, but when pagination is used, it is returned after the last feedback detail entry. Accepted values for Pagination.EntriesPerPage for GetFeedback is 25 (the default), 50, 100, and 200. If you specify a value of zero, or a value greater than 200, the call fails with an error. If you specify a value between one and twenty-four, the value is rounded up to 25. Values between 26 and 199 that are not one of the accepted values are rounded down to the nearest accepted value. GetFeedback No OrderLineItemID is a unique identifier for an eBay order line item and is based upon the concatenation of ItemID and TransactionID, with a hyphen in between these two IDs. An OrderLineItemID can be used as an input filter in the GetFeedback request. If an OrderLineItemID value is used to retrieve a feedback record on a specific order line item, the FeedbackType and Pagination fields (if included) are ignored. 100 GetFeedback No The GetFeedback response contains the feedback summary if a TransactionID or ItemID is specified, and contains the specified user's total feedback score and feedback summary data if a UserID is specified. If no value is supplied, the feedback score and feedback summary for the requesting user will be returned. If a detail level value of ReturnAll is specified, an array of all feedback records will be returned. Contains the individual feedback records for the user or order line item specified in the request. There is one FeedbackDetailType object for each feedback record. Only populated with data when a detail level of ReturnAll is specified in the request. Not returned if you specify FeedbackID in the request. GetFeedback

DetailLevel: ReturnAll

Conditionally Indicates the number of FeedbackDetailType objects returned in the FeedbackDetailArray property. Only applicable if feedback details are returned. GetFeedback

DetailLevel: ReturnAll

Conditionally Summary feedback data for the user. Contains counts of positive, neutral, and negative feedback for pre-defined time periods. Only applicable if feedback details are returned. GetFeedback

DetailLevel: none, ReturnAll

Conditionally Indicates the total feedback score for the user. GetFeedback

DetailLevel: none, ReturnAll

Always Contains information regarding the pagination of data (if pagination is used), including total number of pages and total number of entries. This is only applicable when a User ID or no ID (requester option) is specified. GetFeedback

DetailLevel: none, ReturnAll

Always Indicates the number of entries (feedback detail) that are being returned per page of data (i.e., per call). Only returned if entries are returned. GetFeedback

DetailLevel: none, ReturnAll

Conditionally Indicates which page of data was just returned. Will be the same as the value specified in Pagination.PageNumber. (If the input is higher than the total number of pages, the call fails with an error.) Only returned if items are returned. GetFeedback

DetailLevel: none, ReturnAll

Conditionally Returns item data such as title, description, price information, seller information, and so on, for the specified ItemID.  Also for Half.com. DetailLevel half AddItem, AddFixedPriceItem, GetItems, GetSellerEvents, GetSellerList, RelistItem, ReviseItem Retrieving Items http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=RetrievingItems Introduction to Pictures in Item Listings http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=Pictures Specifies the ItemID that uniquely identifies the item listing for which to retrieve the data. ItemID is a required input in most cases. SKU can be used instead in certain cases (see the description of SKU). If both ItemID and SKU are specified for items where the inventory tracking method is ItemID, ItemID takes precedence. 19 (Note: The eBay database specifies 38. ItemIDs are usually 9 to 12 digits) GetItem Conditionally Indicates if the caller wants to include watch count for that item in the response. You must be the seller of the item to retrieve the watch count. GetItem No This flag should no longer be used as eBay Store Cross Promotions are no longer supported by the Trading API. Specifies whether or not to include cross-promotion information for the item in the call response. GetItem No If true, the response returns the ItemSpecifics node (if the listing has custom Item Specifics). Item Specifics are well-known aspects of items in a given category. For example, items in a washer and dryer category might have an aspect like Type=Top-Loading; whereas items in a jewelry category might have an aspect like Gemstone=Amber. (This does not cause the response to include ID-based attributes. To also retrieve ID-based attributes, pass DetailLevel in the request with the value ItemReturnAttributes or ReturnAll.) GetItem No Working with Custom Item Specifics http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ItemSpecifics If true, an associated tax table is returned in the response. If no tax table is associated with the item, then no tax table is returned, even if IncludeTaxTable is set to true. GetItem No Retrieves an item that was listed by the user identified in AuthToken and that is being tracked by this SKU. A SKU (stock keeping unit) is an identifier defined by a seller. Some sellers use SKUs to track complex flows of products and information on the client side. eBay preserves the SKU on the item, enabling you to obtain it before and after an order line item is created. (SKU is recommended as an alternative to ApplicationData.) In GetItem, SKU can only be used to retrieve one of your own items, where you listed the item by using AddFixedPriceItem or RelistFixedPriceItem, and you set Item.InventoryTrackingMethod to SKU at the time the item was listed. (These criteria are necessary to uniquely identify the listing by a SKU.) Either ItemID or SKU is required in the request. If both are passed, they must refer to the same item, and that item must have InventoryTrackingMethod set to SKU. 50 GetItem Conditionally Variation-level SKU that uniquely identifes a Variation within the listing identified by ItemID. Only applicable when the seller listed the item with Variation-level SKU (Variation.SKU) values. Retrieves all the usual Item fields, but limits the Variations content to the specified Variation. If not specified, the response includes all Variations. GetItem No Name-value pairs that identify one or more Variations within the listing identified by ItemID. Only applicable when the seller listed the item with Variations. Retrieves all the usual Item fields, but limits the Variations content to the specified Variation(s). If the specified pairs do not match any Variation, eBay returns all Variations. To retrieve only one variation, specify the full set of name/value pairs that match all the name-value pairs of one Variation. To retrieve multiple variations (using a wildcard), specify one or more name/value pairs that partially match the desired variations. For example, if the listing contains Variations for shirts in different colors and sizes, specify Color as Red (and no other name/value pairs) to retrieve all the red shirts in all sizes (but no other colors). GetItem No A unique identifier for an order line item (transaction). An order line item is created when a buyer commits to purchasing an item. Since you can change active multiple-quantity fixed-price listings even after one of the items has been purchased, the TransactionID is associated with a snapshot of the item data at the time of the purchase. After one item in a multi-quantity listing has been sold, sellers can not change the values in the Title, Primary Category, Secondary Category, Listing Duration, and Listing Type fields. However, all other fields are editable. Specifying a TransactionID in the GetItem request allows you to retrieve a snapshot of the listing as it was when the order line item was created. 19 (Note: The eBay database specifies 38. TransactionIDs are usually 9 to 12 digits.) GetItem Conditionally This field is used to specify whether or not to retrieve Parts Compatiblity information. If true, any compatible applications associated with the item will be returned in the response ( Item.ItemCompatibilityList). If no compatible applications have been specified for the item, no item compatibilities will be returned. If false or not specified, the response will return a compatibility count (ItemCompatibilityCount) when parts compatibilities have been specified for the item. Parts Compatibility is supported in limited Parts & Accessories categories for the eBay US Motors (site ID 100) and eBay Germany (site ID 77) sites only. Contains the item data returned by the call. The data for the specified item listing is returned in an ItemType object. ItemType object that contains the data for the specified item. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always No longer recommended. 805 Avoid 915 Specifies the data for a single item and configures the recommendation engines to use when processing the item. To retrieve recommendations for multiple items, pass a separate GetRecommendationsRequestContainer for each item. In this case, pass a user-defined correlation ID for each item to identify the matching response. GetItemRecommendations Yes GetItemRecommendations returns recommended changes or opportunities for improvement related to listing data that was passed in the request. This call supports batch requests. That is, it can retrieve recommendations for multiple items at once. Specifies recommended changes or opportunities for improving the data of a single item. If multiple items were processed, a separate GetRecommendationsResponseContainer is returned for each item. Each container includes a user-defined correlation ID to help you match items in the request to recommendations in the response. GetItemRecommendations Always Returns shipping cost estimates for an item for every calculated shipping service that the seller has offered with the listing. This is analogous to the Shipping Calculator seen in both the buyer and seller web pages. Determining Shipping Costs for a Listing http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ShippingGettingCosts The item ID that uniquely identifies the item listing for which to retrieve the data. Required input. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) GetItemShipping Yes Number of items sold to a single buyer and to be shipped together. GetItemShipping No Destination country postal code (or zipcode, for US). Ignored if no country code is provided. Optional tag for some countries. More likely to be required for large countries. GetItemShipping Conditionally Destination country code. If DestinationCountryCode is US, a postal code is required and it represents the US zip code. US GetItemShipping Conditionally Contains the data returned by the call. The shipping details for the specified item are returned in a ShippingDetails object. Shipping-related details for the specified item. Any error about shipping services (returned by a vendor of eBay's who calculates shipping costs) is returned in ShippingRateErrorMessage. Errors from a shipping service are likely to be related to issues with shipping specifications, such as package size and the selected shipping method not supported by a particular shipping service. If a buyer buys multiple quantities of an item and the resultant total weight exceeds the weight limit of the shipping service, GetItemShipping returns the shipping cost and shipping service and internally groups the items in separate packages. A shipping service is removed from ShippingDetails only if the weight of a single item exceeds the weight limit of the shipping service. GetItemShipping Always Retrieves order line item (transaction) information for a specified ItemID. & nbsp;Also for Half.com. The call returns zero, one, or multiple order line items, depending on the number of items sold from the listing. You can retrieve order line item data for a specific time range or number of days. If you don't specify a range or number of days, order line item data will be returned for the past 30 days. DetailLevel GetSellerTransactions, GetOrders, GetOrderTransactions Email and Address Privacy Policy http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=EmailPrivacyPolicy the conditions under which buyer and seller email and address are returned. Retrieving Order Line Item Data and Managing Orders http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=RetrievingTransactionsForSingleItem Unique identifier for an eBay item listing. A listing can have multiple order line items (transactions), but only one ItemID. When you use ItemID alone, eBay returns all order line items that are associated with the ItemID (listing). If you pair ItemID with a specific TransactionID, data on a specific order line item is returned. If OrderLineItemID is specified in the request, any ItemID/TransactionID pair specified in the same request will be ignored. Note: GetItemTransactions doesn't support SKU as an input because this call requires an identifier that is unique across your active and ended listings. Even when InventoryTrackingMethod is set to SKU in a listing, the SKU is only unique across your active listings (not your ended listings). To retrieve order line items by SKU, use GetSellerTransactions or GetOrderTransactions instead. 19 (Note: The eBay database specifies 38. ItemIDs are usually 9 to 12 digits) GetItemTransactions Yes The ModTimeFrom and ModTimeTo fields specify a date range for retrieving order line items associated with the specified ItemID. The ModTimeFrom field is the starting date range. All eBay order line items that were last modified within this date range are returned in the output. The maximum date range that may be specified is 30 days. This field is not applicable if a specific TransactionID or OrderLineItemID is included in the request or if the NumberOfDays date filter is used. If you don't specify a ModTimeFrom/ModTimeTo filter, the NumberOfDays time filter is used and it defaults to 30 (days). GetItemTransactions No The ModTimeFrom and ModTimeTo fields specify a date range for retrieving order line items associated with the specified ItemID. The ModTimeTo field is the ending date range. All eBay order line items that were last modified within this date range are returned in the output. The maximum date range that may be specified is 30 days. If the ModTimeFrom field is used and the ModTimeTo field is omitted, the ModTimeTo value defaults to the present time or to 30 days past the ModTimeFrom value (if ModTimeFrom value is more than 30 days in the past). This field is not applicable if a specific TransactionID or OrderLineItemID is included in the request or if the NumberOfDays date filter is used. If you don't specify a ModTimeFrom/ModTimeTo filter, the NumberOfDays time filter is used and it defaults to 30 (days). GetItemTransactions No Include a TransactionID field in the request if you want to retrieve the data for a specific order line item (transaction). If a TransactionID is provided, any specified time filter is ignored. 19 (Note: The eBay database specifies 38. TransactionIDs are usually 9 to 12 digits.) GetItemTransactions No Child elements control pagination of the output. Use the EntriesPerPage property to control the number of order line items to return per call and the PageNumber property to specify the specific page of data to return. If multiple pages of order line items are returned based on input criteria and Pagination properties, GetItemTransactions will need to be called multiple times (with the PageNumber value being increased by 1 each time) to scroll through all results. GetItemTransactions No Indicates whether to include the Final Value Fee (FVF) for all order line items in the response. The Final Value Fee is returned in the Transaction.FinalValueFee field. The Final Value Fee is assessed right after the creation of an order line item. GetItemTransactions No Include this field and set it to True if you want the ContainingOrder container to be returned in the response under each Transaction node. For single line item orders, the ContainingOrder.OrderID value takes the value of the OrderLineItemID value for the order line item. For Combined Payment orders, the ContainingOrder.OrderID value will be shared by at least two order line items (transactions) that are part of the same order. false GetItemTransactions No Name of the eBay co-branded site upon which the order line item was created. This filter can be used to limit the number of results that are returned. GetItemTransactions No This time filter specifies the number of days (24-hour periods) in the past to search for order line items. All eBay order line items that were either created or modified within this period are returned in the response. If specified, NumberOfDays will override any date range specified with the ModTimeFrom/ModTimeTo time filters. This field is not applicable if a specific TransactionID or OrderLineItemID is included in the request. 30 1 30 GetItemTransactions No If included in the request and set to True, all variations defined for the item are returned at the root level, including variations that have no sales. If not included in the request or set to false, the variations with sales are still returned in separate Transaction nodes. This information is intended to help sellers to reconcile their local inventory with eBay's records, while processing order line items (without requiring a separate call to GetItem). GetItemTransactions false No A unique identifier for an eBay order line item. This field is created as soon as there is a commitment to buy from the seller, and its value is based upon the concatenation of ItemID and TransactionID, with a hyphen in between these two IDs. If you want to retrieve data on a specific order line item, you can use an OrderLineItemID value in the request instead of the ItemID/TransactionID pair. If an OrderLineItemID is provided, any specified time filter is ignored. 100 GetItemTransactions No Returns an array of order line item (transaction) data for the item specified in the request. The results can be used to create a report of data that is commonly necessary for order processing. Zero, one, or many Transaction objects can be returned in the TransactionArray. The set of order line items returned is limited to those that were modified between the times specified in the request's ModTimeFrom and ModTime filters. Also returns the Item object that spawned the order line items. If pagination filters were specified in the request, returns meta-data describing the effects of those filters on the current response and the estimated effects if the same filters are used in subsequent calls. Data from the TransactionArray may be used to trigger the following Platform Notifications: EndOfAuction, AuctionCheckoutComplete, FixedPriceEndOfTransaction, CheckoutBuyerRequestTotal, FixedPriceTransaction, Checkout, FixedPriceTransactionForSeller, FixedPriceTransactionForBuyer, ItemMarkedAsShipped, and ItemMarkedAsPaid. Each notification will be based on the state of the item (a 'snapshot' of the item) at the time the order line item was created. Contains the total number of pages (TotalNumberOfPages) and the total number of entries (TotalNumberOfEntries) that could be returned given repeated calls that use the same selection criteria as the call that returned this response. GetItemTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Always Indicates whether there are additional order line items (transactions) to retrieve. That is, indicates whether more pages of data are available to be returned, given the filters that were specified in the request. Returns false for the last page of data. GetItemTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Always Number of order line items (transactions) returned per page (per call). May be a higher value than ReturnedTransactionCountActual if the page returned is the last page and more than one page of data exists. GetItemTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Always Page number for the page of order line items the response returned. GetItemTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Always Number of order line items retrieved in the current page of results just returned. May be a lower value than TransactionsPerPage if the page returned is the last page and more than one page of data exists. GetItemTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Always Item object that spawned the order line item. It is a purchase from this item's listing that the order line item represents. GetItemTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Always List of Transaction objects representing the order line items resulting from the listing. Each Transaction object contains the data for one purchase (of one or more items in the same listing). The Transaction.Item field is not returned because the Item object is returned at the root level of the response. See the reference guide for more information about the fields that are returned. GetItemTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Conditionally Indicates whether the item's seller has the preference enabled that shows that the seller prefers PayPal as the method of payment for an item. This preference is indicated on an item's View Item page and is intended to influence a buyer to use PayPal to pay for the item. GetItemTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Always Returns orders in which the user was involved and for which feedback is still needed from either the buyer or seller. GetMyeBayBuying, GetMyeBaySelling, GetMyeBayReminders Specifies how the returned feedback items should be sorted. Valid values are Title, EndTime, QuestionCount, FeedbackLeft, FeedbackReceivedDescending, UserIDDescending, TitleDescending, and EndTimeDescending. GetItemsAwaitingFeedback No Specifies the number of entries per page and the page number to return in the result set. GetItemsAwaitingFeedback No Response to GetItemsAwaitingFeedback. Contains the items awaiting feedback. Returned only if there are items that do not yet have feedback. GetItemsAwaitingFeedback Always Retrieves a list of the messages buyers have posted about your active item listings. AddMemberMessagesAAQToBidder, AddMemberMessageAAQToPartner, AddMemberMessageRTQ, DeleteMyMessages, GetMyMessages, ReviseMyMessages, ReviseMyMessagesFolders Communication Between Members http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=CommunicationBetweenMembers The ID of the item the message is about. For ASQ messages, either the ItemID, or a date range (specified with StartCreationTime and EndCreationTime), or both must be included. ItemID is otherwise ignored. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) GetMemberMessages Conditionally The type of message. Note that GetMemberMessages does not return messages when this field is set to AskSellerQuestion. GetMemberMessages AskSellerQuestion, All Yes The status of the message. GetMemberMessages Conditionally If included in the request and set to True, only public messages (viewable in the Item listing) are returned. If omitted or set to False in the request, all messages (that match other filters in the request) are returned in the response. GetMemberMessages No Used as beginning of date range filter. If specified, filters the returned messages to only those with a creation date greater than or equal to the specified date and time. For CEM messages, StartCreationTime and EndCreationTime must be provided. For ASQ messages, either the ItemID, or a date range (specified with StartCreationTime and EndCreationTime), or both must be included. GetMemberMessages Conditionally Used as end of date range filter. If specified, filters the returned messages to only those with a creation date less than or equal to the specified date and time. For CEM messages, StartCreationTime and EndCreationTime must be provided. For ASQ messages, either the ItemID, or a date range (specified with StartCreationTime and EndCreationTime), or both must be included. GetMemberMessages Conditionally Standard pagination argument used to reduce response. GetMemberMessages No An ID that uniquely identifies the message for a given user to be retrieved. Used for the AskSellerQuestion notification only. GetMemberMessages No An eBay ID that uniquely identifies a user. For GetMemberMessages, this is the sender of the message. If included in the request, returns only messages from the specified sender. GetMemberMessages No The returned member messages. Returned if messages that meet the request criteria exist. Note that GetMemberMessages does not return messages when, in the request, the MailMessageType is AskSellerQuestion. GetMemberMessages Conditionally Shows the pagination of data returned by requests. GetMemberMessages Always Specifies whether the response has more items. GetMemberMessages Always Returns a seller's Ask Seller a Question (ASQ) subjects, each in its own Subject node. SetMessagePreferences The ID of the user to retrieve ASQ subjects for. This value must be specified in the request, but does not need to be the same user as the user making the request. GetMessagePreferences Yes If true, indicates that the ASQ subjects for the specified user should be returned. GetMessagePreferences No Contains the ASQ subjects for the user specified in the request. Returns a seller's ASQ subjects, each in its own Subject node. If the seller has not customized the ASQ subjects using SetMessagePreferences, the call will return the current default values. Returned if IncludeASQPreferences = true was specified in the request. GetMessagePreferences Conditionally Retrieves information about the messages sent to a given user.

Retrieves information about the messages sent to a user.

DetailLevel AddMemberMessageAAQToPartner, AddMemberMessageRTQ, AddMemberMessagesAAQToBidder, DeleteMyMessages, GetMemberMessages, ReviseMyMessages, ReviseMyMessagesFolders Communication Between Members http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=CommunicationBetweenMembers Notifications for Buyers and Sellers http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=NotificationsForBuyersAndSellers This container was deprecated with 685 release. Alerts are now synonymous with Flagged messages. Container consisting of one to 10 MessageID fields. GetMyMessages Conditionally A unique identifier for a My Messages folder. If a FolderID is provided, only messages from the specified folder are returned in the response. GetMyMessages No The beginning of the date-range filter. Filtering takes into account the entire timestamp of when messages were sent. Messages expire after one year. GetMyMessages No The end of the date-range filter. See StartTime (which is the beginning of the date-range filter). GetMyMessages Conditionally This field is currently available on the US site. A container for IDs that uniquely identify messages for a given user. If provided at the time of message creation, this ID can be used to retrieve messages and will take precedence over message ID. GetMyMessages No Specifies how to create virtual pages in the returned list (such as total number of entries and total number of pages to return). Default for EntriesPerPage with GetMyMessages is 25. GetMyMessages No If this field is included in the requst and set to True, only High Priority messages are returned in the response. GetMyMessages No Conains information about the messages sent to a user. Depending on the detail level, this information can include message counts, resolution and flagged status, message headers, and message text. Summary data for a given user's messages. This includes the numbers of new messages, flagged messages, and total messages. The amount and type of data returned is the same whether or not the request includes specific MessageIDs. Always/Conditionally returned logic assumes a detail level of ReturnMessages. GetMyMessages

DetailLevel: ReturnSummary

Conditionally This container was deprecated in 685 version. Alerts are now considered Flagged messages. Contains the message information for each message specified in MessageIDs. The amount and type of information returned varies based on the requested detail level. Contains one MyMessagesMessageType object per message. Returned as an empty node if user has no messages. GetMyMessages

DetailLevel: ReturnHeaders, ReturnMessages

Conditionally Returns items from the Buying section of the user's My eBay account, including items that the user is watching, bidding on, has won, has not won, and has made Best Offers on. GetItemsAwaitingFeedback, GetMyeBayReminders, GetMyeBaySelling My eBay http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=My_eBay DetailLevel Returns the list of items being watched by the user. Set Include to true to return the default response set. GetMyeBayBuying No Returns the list of items on which the user has bid. Set Include to true to return the default response set. GetMyeBayBuying No Returns the list of items on which the user has placed Best Offers. Set Include to true to return the default response set. GetMyeBayBuying No Returns the list of items on which the use has bid. Set Include to true to return the default response set. GetMyeBayBuying No Returns the list of items on which the user has bid on and lost. Set Include to true to return the default response set. GetMyeBayBuying No Returns the list of searches that the user has saved in My eBay. Returned only if the user has saved searches. Set Include to true to return the default response set. GetMyeBayBuying No Returns the list of favorite sellers that the user has saved in My eBay. Returned only if the user has saved a list of favorite sellers. Set Include to true to return the default response set. GetMyeBayBuying No Returns the list of second chance offers made by the user. Returned only if the user has made second chance offers. Set Include to true to return the default response set. GetMyeBayBuying No Indicates whether or not the Bid Assistant feature is being used. Returns the list of items the user has won, and subsequently deleted from their My eBay page. Set Include to true to return the default response set. GetMyeBayBuying No Returns the list of items (auctions) the user did not win and were subsequently deleted from their My eBay page. Set Include to true to return the default response set. GetMyeBayBuying No Returns a summary of the user's buying activity. Add a BuyingSummary element in the request with an Include field set to true to receive a BuyingSummary container in your response. Add a BuyingSummary element with an Include field set to false to exclude the BuyingSummary from your response. GetMyeBayBuying No Returns the user defined lists, which are lists created by the user in the eBay UI and filled with items, or sellers, or searches using the "Add to List" feature. Set Include to true to return the default response set. GetMyeBayBuying No If true, the Variations node is omitted for all multi-variation listings in the response. If false, the Variations node is returned for all multi-variation listings in the response. Please note that if the seller includes a large number of variations in many listings, retrieving variations (setting this flag to false) may degrade the call's performance. Therefore, when this is false, you may need to reduce the total number of items you're requesting at once (by using other input fields, such as Pagination). GetMyeBayBuying No false Returns items from All Buying or All Favorites in the user's My eBay account. Contains a summary of the items the user has bid on. Returned at all detail levels. GetMyeBayBuying

DetailLevel: ReturnAll

Always Contains the items the user is watching. Only returned if items exist that meet the request criteria. GetMyeBayBuying

DetailLevel: ReturnAll

Conditionally Contains all the items the buyer has bid on. Only returned if items exist that meet the request criteria. GetMyeBayBuying

DetailLevel: ReturnAll

Conditionally Contains the items the user has placed Best Offers on. Only returned if items exist that meet the request criteria. GetMyeBayBuying

DetailLevel: ReturnAll

Conditionally Contains the items the user has bid on and won. Only returned if items exist that meet the request criteria. GetMyeBayBuying

DetailLevel: ReturnAll

Conditionally Contains the items the user has bid on and lost. Only returned if items exist that meet the request criteria. GetMyeBayBuying

DetailLevel: ReturnAll

Conditionally Contains a list of the user's favorite searches. Only returned if the user has Favorite Searches. The search name, search query, and search elements, such as QueryKeywords, SortOrder, and Condition are returned. You can paste the Search Query response, that comes back as a URL, into a browser to re-play the Favorite Search. The search elements that are returned by this call can be used as input for the Shopping Web Service FindItemsAdvanced request. GetMyeBayBuying

DetailLevel: ReturnAll

Conditionally Contains a list of the user's favorite sellers. Only returned if items exist that meet the request criteria. GetMyeBayBuying

DetailLevel: ReturnAll

Conditionally Contains the list of second chance offers the user has received. Only returned if items exist that meet the request criteria. GetMyeBayBuying

DetailLevel: ReturnAll

Conditionally Contains the items that were bid on using the Bid Assistant feature. Contains the items the buyer has bid on, won, and deleted from My eBay. Only returned if items exist that meet the request criteria. GetMyeBayBuying

DetailLevel: ReturnAll

Conditionally Contains the items the buyer has bid on, lost, and deleted from My eBay. Only returned if items exist that meet the request criteria. GetMyeBayBuying

DetailLevel: ReturnAll

Conditionally Contains the items, searches, or sellers that the user has saved to this list using the "Add to list" feature. The name of the list is given by the "Name" element. Returned only if UserDefineLists is specified in the request. GetMyeBayBuying Conditionally Requests totals for the Buying and Selling reminders from the user's My eBay account. GetItemsAwaitingFeedback, GetMyeBayBuying, GetMyeBaySelling My eBay http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=My_eBay Specifies the type of buying reminders for which you want information. GetMyeBayReminders No Specifies the type of selling reminders for which you want information. GetMyeBayReminders No Returns totals of various reminder types from the user's My eBay account. Returns totals of various reminder types from the user's My eBay account. Contains the buying reminders in the user's My eBay account that match the request criteria. GetMyeBayReminders Conditionally Contains the selling reminders in the user's My eBay account that match the request criteria. GetMyeBayReminders Conditionally Returns items from the Selling section of the user's My eBay account, including items that the user is currently selling (the Active list), items that have bids, sold items, and unsold items. DetailLevel GetItemsAwaitingFeedback, GetMyeBayBuying, GetMyeBayReminders My eBay http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=My_eBay Managing Selling and Reminders with My eBay http://pages.ebay.com/help/myebay/manage-selling.html Returns the list of items the user has scheduled to sell but whose listings have not yet opened. Include and set the ScheduledList.Include flag to 'true' to retrieve the default response set of ScheduledList in the response. GetMyeBaySelling No Returns the list of items the user is actively selling (the currently active listings). Include and set the ActiveList.Include flag to 'true' to retrieve the default response set of ActiveList in the response. GetMyeBaySelling No Returns the list of items the user has sold. Include and set the SoldList.Include flag to 'true' to retrieve the default response set of SoldList in the response. GetMyeBaySelling No Returns the list of items the user has listed, but whose listings have ended without being sold. Include and set the UnsoldList.Include flag to 'true' to retrieve the default response set of UnsoldList in the response. GetMyeBaySelling No This container is no longer applicable to GetMyeBaySelling. Returns the list of items the user sold, and then deleted from their My eBay page. Allowed values for DurationInDays are 0-60. Include and set the DeletedFromSoldList.Include flag to 'true' to retrieve the default response set of DeletedFromSoldList in the response. GetMyeBaySelling No Returns the list of items the user either ended or did not sell, and subsequently were deleted them from their My eBay page. Allowed values for DurationInDays are 0-60. Include and set the DeletedFromUnsoldList.Include flag to 'true' to retrieve the default response set of DeletedFromUnsoldList in the response. GetMyeBaySelling No Returns a summary of the user's buying activity. Include and set the SellingSummary.Include flag to 'true' to retrieve the default response set of SellingSummary in the response. GetMyeBaySelling No If 'true', the Variations node is omitted for all multi-variation listings in the response. If 'false', the Variations node is returned for all multi-variation listings in the response. Please note that if the seller includes a large number of variations in many listings, retrieving variations (setting this flag to 'false') may degrade the call's performance. Therefore, when this is 'false', you may need to reduce the total number of items you're requesting at once (by using other input fields, such as Pagination). GetMyeBaySelling No false Returns summary and detail information about items the user is selling, items scheduled to sell, currently listed, sold, and closed but not sold. Contains summary information about the items the user is selling. GetMyeBaySelling

DetailLevel: none, ReturnAll

Always Contains the items the user has scheduled for sale, but whose listings have not yet started. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally Contains the items the user is selling that have active listings. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally Contains the items the user has sold. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally Contains the items whose listings have ended but that have not sold. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally Contains summary information about the items the user is selling. GetMyeBaySelling

DetailLevel: none, ReturnAll

Always This container is no longer applicable to GetMyeBaySelling. Contains the items the seller has sold and deleted from My eBay. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally Contains the items with listings that were ended or did not sell and have been deleted from My eBay. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally Retrieves the requesting application's notification preferences. Details are only returned for events for which a preference has been set. For example, if you enabled notification for the EndOfAuction event and later disabled it, the GetNotificationPreferences response would cite the EndOfAuction event preference as Disabled. Otherwise, no details would be returned regarding EndOfAuction. Working with Platform Notifications http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=PlatformNotifications Specifies the type of preferences to retrieve. For example, preferences can be associated with a user, with an application, or with events. GetNotificationPreferences Yes Contains the requesting application's notification preferences. GetNotificationPreferences retrieves preferences that you have deliberately set. For example, if you enable the EndOfAuction event and then later disable it, the response shows the EndOfAuction event preference as Disabled. But if you have never set a preference for the EndOfAuction event, no EndOfAuction preference is returned at all. Specifies application-based event preferences that have been enabled. GetNotificationPreferences Conditionally Specifies application delivery URL Name associated with this user. GetNotificationPreferences Conditionally Specifies user-based event preferences that have been enabled or disabled. GetNotificationPreferences Conditionally Returns user data for notification settings, such as set mobile phone. GetNotificationPreferences Conditionally Contains names and values assigned to a notification event. Currently can only be set for wireless applications. GetNotificationPreferences Conditionally Retrieves usage information about platform notifications for a given application. You can use this notification information to troubleshoot issues with platform notifications. You can call this up to 50 times per hour for a given application. Working with Platform Notifications http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=PlatformNotifications Specifies the start date and time for which notification information will be retrieved. StartTime is optional. If no StartTime is specified, the default value of 24 hours prior to the call time is used. If no StartTime is specified or if an invalid StartTime is specified, date range errors are returned in the response. For a StartTime to be valid, it must be no more than 72 hours before the time of the call, it cannot be more recent than the EndTime, and it cannot be later than the time of the call. If an invalid StartTime is specified, the default value is used. GetNotificationsUsage Conditionally Specifies the end date and time for which notification information will be retrieved. EndTime is optional. If no EndTime is specified, the current time (the time the call is made) is used. If no EndTime is specified or if an invalid EndTime is specified, date range errors are returned in the response. For an EndTime to be valid, it must be no more than 72 hours before the time the of the call, it cannot be before the StartTime, and it cannot be later than the time of the call. If an invalid EndTime is specified, the current time is used. GetNotificationsUsage Conditionally Specifies an item ID for which detailed notification information will be retrieved. ItemID is optional. If no ItemID is specified, the response will not include any individual notification details. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) GetNotificationsUsage Conditionally Returns an array of notifications sent to a given application identified by the appID (comes in the credentials). The result can be used by third-party developers troubleshoot issues with notifications. Zero, one or many notifications can be returned in the array. The set of notifications returned is limited to those that were sent between the StartTime and EndTime specified in the request. If StartTime or EndTime filters were not found in the request, then the response will contain the data for only one day (Now-1day). By default, maximum duration is limited to 3 days (Now-3days). These min (1day) and max(3days) applies to Notifications,MarkDownMarkUpHistory and NotificationStatistics. Notifications are sent only if the ItemID is included in the request. If there is no ItemID, then only Statistics and MarkDownMarkUpHistory information is included. Returns the start date and time for the notification information that is returned by this call. The oldest date allowed for this field is Now-3days. Default is Now-1day. GetNotificationsUsage Always Returns the end date and time for the notification information that is returned by this call. The default is Now. GetNotificationsUsage Always List of notification objects representing the notifications sent to an application for the given time period. It will only be returned if ItemID was specified in the input request. GetNotificationsUsage Conditionally List of objects representing MarkUp or MarkDown history for a given appID and for given StartTime and EndTime. This node will always be returned. GetNotificationsUsage Always Summary information about number of notifications that were successfully delivered, queued, failed, connection attempts made, connection timeouts, http errors for the given appID and given time period. By default, statistics for only one day (Now-1day) is included. Maximum time duration allowed is 3 days (Now-3days). GetNotificationsUsage Always Retrieves information about one or more orders based on OrderIDs, ItemIDs, or SKU values.  Also for Half.com. DetailLevel GetOrders, GetItemTransactions, GetSellerTransactions Basic Building Blocks http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=TransactionsEndOfAuction An array of one or more ItemTransactionID containers. Each ItemTransactionID container identifies an order line item to retrieve in the response. GetOrderTransactions Conditionally An array of one or more OrderID containers. Each OrderID container identifies an order to retrieve in the response. Up to 20 orders (using 20 OrderID containers) can be retrieved with one GetOrderTransactions call. GetOrderTransactions Conditionally Name of the eBay co-branded site upon which the order line item was created. This will serve as a filter for the orders to get emitted in the response. GetOrderTransactions No Indicates whether to include Final Value Fee (FVF) in the response. For most listing types, the Final Value Fee is returned in Transaction.FinalValueFee. The Final Value Fee is returned for each order line item (Transaction container) for fixed-price listings. For all other listing types, the Final Value Fee is returned when the listing status is Completed. This value is not returned if the auction ended with Buy It Now. GetOrderTransactions No Response to GetOrderTransactions request. An array of Orders. GetOrderTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always Retrieves the orders for which the authenticated user is a participant, either as the buyer or the seller. Also for Half.com. The call returns all the orders that meet the request specifications. DetailLevel AddOrder, GetItemTransactions, GetOrderTransactions Listing an Item http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=WorkingWithCombinedPayment A container for eBay order IDs. If one or more order IDs are specified in this container, no other call-specific input fields are applicable. Not applicable to Half.com. GetOrders Conditionally The CreateTimeFrom and CreateTimeTo fields specify a date range for retrieving orders. The CreateTimeFrom field is the starting date range. All eBay orders that were created within this date range are returned in the output. The maximum date range that may be specified with the CreateTimeFrom and CreateTimeTo fields is 90 days. CreateTimeFrom/CreateTimeTo date filters are ignored if the NumberOfDays date filter is used in the request, or if one or more order IDs are passed in the request. Applicable to Half.com. GetOrders Conditionally The CreateTimeFrom and CreateTimeTo fields specify a date range for retrieving orders. The CreateTimeTo field is the ending date range. All eBay orders that were created within this date range are returned in the output. The maximum date range that may be specified with the CreateTimeFrom and CreateTimeTo fields is 90 days. If the CreateTimeFrom field is used and the CreateTimeTo field is omitted, the "TimeTo" value defaults to the present time or to 90 days past the CreateTimeFrom value (if CreateTimeFrom value is more than 90 days in the past). CreateTimeFrom/CreateTimeTo date filters are ignored if the NumberOfDays date filter is used in the request, or if one or more order IDs are passed in the request. Note: If a GetOrders call is made within a few seconds after the creation of a multiple line item order, the caller runs the risk of retrieving orders that are in an inconsistent state, since the order consolidation involved in a multi-line item order may not have been completed. For this reason, it is recommended that sellers include the CreateTimeTo field in the call, and set its value to: Current Time - 2 minutes. Applicable to Half.com. GetOrders Conditionally Filters the returned orders based on the role of the user. The user's role is either buyer or seller. If this field is used with a date filter, returned orders must satisfy both the date range and the OrderRole value. Applicable to eBay.com and Half.com. GetOrders Conditionally Filters the returned orders by order status. For eBay orders, only the Active and Completed values are applicable. The Shipping value can be used for Half.com orders. If this field is used with a date filter, returned orders must satisfy both the date range and the OrderStatus value. To retrieve orders with a status of Inactive or Cancelled, you must specify the order IDs (OrderIDArray.OrderID). When you specify order IDs, no other filters may be used. For Half.com, you can get some, but not all orders. Orders on Half.com have different order status values from eBay orders. When you set ListingType to Half, set OrderStatus to Shipped. Otherwise, GetOrders may return incomplete information or have indeterminate results. GetOrders Active, Completed, Shipped,Cancelled,Inactive Conditionally Specify Half to retrieve Half.com orders. Note: Do not use this field if you are retrieving eBay orders. This field cannot be used as a listing type filter on eBay.com. If not provided, or if you specify any value other than Half, this field has no useful effect and the call retrieves eBay orders of all types. Also, you can't retrieve both eBay and Half.com orders in the same response. GetOrders Half Conditionally If many orders are available to retrieve, you may need to call GetOrders multiple times to retrieve all the data. Each result set is returned as a page of entries. Use the Pagination filters to control the maximum number of entries to retrieve per page (i.e., per call), the page number to retrieve, and other data. GetOrders No The ModTimeFrom and ModTimeTo fields specify a date range for retrieving existing orders that have been modified within this time window (for example, 'Incomplete' status to 'Pending' status or 'Pending' status to 'Complete' status). The ModTimeFrom field is the starting date range. All eBay orders that were last modified within this date range are returned in the output. The maximum date range that may be specified with the ModTimeFrom and ModTimeTo fields is 30 days. ModTimeFrom/ModTimeTo date filters are ignored if the CreateTimeFrom/CreateTimeTo or NumberOfDays date filters are used in the request, or if one or more order IDs are passed in the request. Applicable to Half.com. GetOrders Conditionally The ModTimeFrom and ModTimeTo fields specify a date range for retrieving existing orders that have been modified within this time window (for example, 'Incomplete' status to 'Pending' status or 'Pending' status to 'Complete' status). The ModTimeTo field is the ending date range. All eBay orders that were last modified within this date range are returned in the output. The maximum date range that may be specified with the ModTimeFrom and ModTimeTo fields is 30 days. If the ModTimeFrom field is used and the ModTimeTo field is omitted, the "TimeTo" value defaults to the present time (if ModTimeFrom value is less than 30 days in the past) or to 30 days past the ModTimeFrom value. ModTimeFrom/ModTimeTo date filters are ignored if the CreateTimeFrom/CreateTimeTo or NumberOfDays date filters are used in the request, or if one or more order IDs are passed in the request. Applicable to Half.com. GetOrders Conditionally This filter specifies the number of days (24-hour periods) in the past to search for orders. All eBay orders that were either created or modified within this period are returned in the output. This field cannot be used in conjunction with the CreateTimeFrom/CreateTimeTo or ModTimeFrom/ModTimeTo date filters. This date filter is ignored if one or more order IDs are passed in the request. Applicable to Half.com. 1 30 GetOrders Conditionally Indicates whether to include the Final Value Fee (FVF) for all Transaction objects in the response. The Final Value Fee is returned in Transaction.FinalValueFee. The Final Value Fee is assessed right after the creation of an eBay order line item. GetOrders Conditionally Returns the set of orders that match the order IDs or filter criteria specified. Contains information regarding the pagination of data, including the total number of pages and the total number of orders. GetOrders

DetailLevel: none, ReturnAll

Always A true value indicates that there are more orders to be retrieved. Additional GetOrders calls with higher page numbers or more entries per page must be made to retrieve these orders. If false, no more orders are available or no orders match the request (based on the input filters). GetOrders

DetailLevel: none, ReturnAll

Always The set of orders that match the order IDs or filter criteria specified. Also applicable to Half.com (only returns orders that have not been marked as shipped). GetOrders

DetailLevel: none, ReturnAll

Always Indicates the number of orders that can be returned per page of data (i.e., per call). This is the same value specified in the Pagination.EntriesPerPage input (or the default value, if EntriesPerPage was not specified). This is not necessarily the actual number of orders returned per page (see ReturnedOrderCountActual). GetOrders

DetailLevel: none, ReturnAll

Always Indicates the page number of data returned in the response. This is the same value specified in the Pagination.PageNumber input. If orders are returned, the first page is 1. GetOrders

DetailLevel: none, ReturnAll

Always Indicates the total number of orders returned. GetOrders

DetailLevel: none, ReturnAll

Always This type is deprecated as the call is no longer available. Specifies the ID of a product in the family to be retrieved, along with pagination and sorting instructions. ProductSearch is a required input. This type is deprecated as the call is no longer available. Container for one or more DataElement fields containing supplemental helpful data. A DataElement field is an HTML snippet that specifies hints for the user, help links, help graphics, and other supplemental information that varies per characteristics set. Usage of this information is optional and may require developers to inspect the information to determine how it can be applied in an application. Contains the attributes and summary product details for all products that match the product ID (or IDs) passed in the request. This type is deprecated as the call is no longer available. A version of the product finder attribute definitions for the site. Typically, an application passes the version value that was returned the last time the application executed this call. Filter that causes the call to return only the Product Finders for which the attribute meta-data has changed since the specified version. The latest version value is not necessarily greater than the previous value that was returned. Therefore, when comparing versions, only compare whether the value has changed. A number that uniquely identifies a product finder. For sell-side searches, you can determine the product finder IDs for a category by calling GetCategory2CS. For buy-side searches, you can't use GetCategory2CS to reliably determine the product finder IDs for an eBay category. GetProductFinder may work for some attributes. Alternatively, you can use the pfid parameter from the URL of the Product Finder search page on the site you're interested in. See the Knowledge Base article referenced below for more details. Multiple categories can be mapped to the same product finder ID. You can pass zero or multiple IDs in the request. When IDs are specified, the call only returns product finder meta-data for the specified product finders. When no IDs are specified, the call returns all the current product finder meta-data available on the site. This type is deprecated as the call is no longer available. Current version of the product search page data for the site. This value changes each time changes are made to the search page data. The current version value is not necessarily greater than the previous value. Therefore, when comparing versions, only compare whether the value has changed. A string containing a list of search attributes that can be used in a "Product Finder" style query, along with related meta-data. The meta-data specifies possible values of each attribute, the logic for presenting attributes to a user, and rules for validating the user's selections. For backward compatibility, this data is in the same XML format that was used in the Legacy XML API so that you can apply the same Product Finder XSL stylesheet to it. That is, individual elements are not described using the new eBay XML schema format. For information about each element in the ProductFinderData string, see the product finder model documentation in the eBay Web Services guide (see links below). Because this is returned as a string, the XML markup is escaped with character entity references (e.g., &lt;eBay&gt;&lt;ProductFinders&gt;...). See the appendices in the eBay Web Services guide for general information about string data types. This type is deprecated as the call is no longer available. The name of the XSL file to retrieve. If not specified, the call returns the latest versions of all available XSL files. Currently, this call only retrieves the product_finder.xsl file. FileName is an optional input. The desired version of the XSL file. Required if FileName is specified. If not specified, the call returns the latest versions of all available XSL files that could be returned by the call. (Currently, this call only retrieves the product_finder.xsl file.) This is not a filter for retrieving changes to the XSL file. This type is deprecated as the call is no longer available. Child elements specify data related to one XSL file. In theory, multiple XSLFile objects can be returned. Currently, this call only retrieves the product_finder.xsl file. This type is deprecated as the call is no longer available. A version of the search page definitions for the site. Typically, an application passes the version value that was returned the last time the application executed this call. Filter that causes the call to return only the search pages for which the attribute meta-data has changed since the specified version. The latest version value is not necessarily greater than the previous value that was returned. Therefore, when comparing versions, only compare whether the value has changed. A characteristic set ID that is associated with a catalog-enabled category that supports product search pages. You can pass an array of these IDs in the request. Each characteristic set corresponds to a level in the eBay category hierarchy at which all items share common characteristics. Multiple categories can be mapped to the same characteristic set. Each ID is used as a filter to limit the response content to fewer characteristic sets. When IDs are specified, the call only returns search page data for the corresponding characteristic sets. When no IDs are specified, the call returns all the current search page data in the system. This type is deprecated as the call is no longer available. Current version of the product search page data for the site. This value changes each time changes are made to the search page data. The current version value is not necessarily greater than the previous value. Therefore, when comparing versions, only compare whether the value has changed. A list of catalog search criteria and sort keys associated with a catalog-enabled category, plus supplemental information to help the seller understand how to make selections. This type is deprecated as the call is no longer available. Specifies the keywords or attributes that make up the product query, with pagination instructions. ProductSearch is a required input. To search for multiple different products at the same time (i.e., to perform a batch search), pass in multiple ProductSearch properties. This type is deprecated as the call is no longer available. Container for one or more DataElement fields containing supplemental helpful data. A DataElement field is an HTML snippet that specifies hints for the user, help links, help graphics, and other supplemental information that varies per characteristic set. Usage of this information is optional and may require you to inspect the information to determine how it can be applied in an application. Also returned with warnings when no matches are found. Contains the attributes and product details that match the attributes or query keywords passed in the request. Always returned when product search results are found. his type is deprecated as the call is no longer available. Specifies the context in which the call is being executed, which will imply certain validation rules. Use this property to make sure you retrieve the appropriate version of product information and attribute meta-data when you are listing, revising, or relisting an item with Pre-filled Item Information. A catalog product identifies a prototype description of a well-known type of item, such as a popular book. As this call supports batch requests, you can pass in an array of products to retrieve data for several products at the same time. This type is deprecated as the call is no longer available. A string containing a list of all the attributes that are applicable to the products specified in the request, along with related meta-data. The meta-data specifies the pre-filled values of each attribute, the possible values of attributes that are not pre-filled, the logic for presenting the attributes to a user, and rules for validating the user's selections. For backward compatibility, this data is in the same XML format that was used in the Legacy XML API so that you can apply the same Item Specifics XSL stylesheet to it. That is, individual elements are not described using the unified schema format. The data is based on the GetAttributesCS response (AttributeData), with additional information that is specific to catalog products. Product and attribute information is nested within a set of Product tags. The product-specific data is merged into the attribute data so that the same XSL stylesheet used to render the results of GetAttributeCS can be used to render catalog product data. See GetAttributesXSL. See the Attribute Meta-Data Model section of the eBay Web Services guide for information about each element in the ProductSellingPagesData string. Because the content is returned as a string, the XML markup elements are escaped with character entity references (e.g.,&lt;eBay&gt;&lt;Attributes&gt;...). See the appendices in the eBay Web Services guide for general information about string data types. No longer recommended. eBay Store Cross Promotions are no longer supported in the Trading API. Retrieves all promotion rules associated with the specified item or store category. Cross-Promotions http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=CrossPromotionsChapter The unique ID of the item for which to retrieve promotion rules. Mutually exclusive with StoreCategoryID. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) GetPromotionRules Conditionally The unique ID of the store category for which to retrieve promotion rules. Mutually exclusive with ItemID. GetPromotionRules Conditionally The type of promotion. (CrossSell: items that are related to or useful in combination with this item. UpSell: items that are more expensive than or of higher quality than this item.) GetPromotionRules Yes Returns all promotion rules associated with the specified item or store category. Note: eBay Store Cross Promotions are no longer supported in the Trading API. An array of promotion rules associated with the item or store category specified in the request. GetPromotionRules Always Retrieves information about promotional sales set up by an eBay store owner (the authenticated caller). GetPromotionRules, SetPromotionalSale, SetPromotionalSaleListings Putting Store Items on Sale http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=PuttingItemsOnSale The ID of the promotional sale about which you want information. If you do not specify this field, then all promotional sales for the seller making the call are returned or only those promotional sales matching the specified promotional sale status filter, PromotionalSaleStatus. If PromotionalSaleID and PromotionalSaleStatus are both specified, the single promotional sale specified by ID is returned only if its status matches the specified status filter. GetPromotionalSaleDetails No Specifies the promotional sales to return, based upon their status. For example, specify "Scheduled" to retrieve only promotional sales with a Status of Scheduled. If you want to retrieve promotional sales for more than one status, you can repeat the field with an additional status value, such as Active. If this field is used together with PromotionalSaleID, the single promotional sale specified by ID is returned only if its status matches the specified status filter. If neither field is used, all of the seller's promotional sales are returned, regardless of status. No filtering GetPromotionalSaleDetails No Contains information about promotional sales. This call is part of the Promotional Price Display feature. Contains information about a promotional sale or sales. If you did not specify a PromotionalSaleID in the request, then all promotional sales for the seller are returned. Promotional sales enable sellers to add discounts and/or free shipping to items. GetPromotionalSaleDetails Conditionally Retrieves a brief summary of the requester's status as an eBay seller. GetAccount, GetFeedback, GetUser About Your Seller Dashboard (eBay US online help) http://pages.ebay.com/help/myebay/seller-dashboard.html Zum Thema Verkaufer-Cockpit (eBay Germany online help) http://pages.ebay.de/help/myebay/seller-dashboard.html Returns a brief summary of the requester's status as an eBay seller. The status information can help an eBay seller monitor their selling performance and keep their account in good standing. Provides information about the visibility level you have earned for your listings. The higher your search standing rating, the higher your items will be placed in search results sorted by Best Match. Because your search standing rating is directly tied to your customer service record, this rating is an important way that eBay rewards you as a good seller--it encourages you to give buyers the best possible shopping experience. This element is not returned for all sites. Beginning at the end of 2009, eBay stopped returning it for sellers registered on several large sites, including the US, German, and UK sites. GetSellerDashboard Conditionally About Your Seller Dashboard: Search Standing http://pages.ebay.com/help/myebay/seller-dashboard.html#standing Zum Thema Verkaeufer-Cockpit: Platzierung in der Suche http://pages.ebay.de/help/myebay/seller-dashboard.html#standing Provides information about the PowerSeller discount level you have earned, if any. As a PowerSeller, you can earn discounts on your monthly invoice Final Value Fees based on how well you're rated as a seller. Only returned for members of the eBay US or Canada PowerSeller program. GetSellerDashboard Conditionally About Your Seller Dashboard: PowerSeller Discount http://pages.ebay.com/help/myebay/seller-dashboard.html#discount Zum Thema Verkaeufer-Cockpit: PowerSeller-Rabatt http://pages.ebay.de/help/myebay/seller-dashboard.html#discount Provides information about your PowerSeller status, such as whether or not you meet the PowerSeller requirements. Your PowerSeller status directly affects your discount (SellerFeeDiscount). For eBay Germany and France, you must be a registered business seller to see your PowerSeller status. GetSellerDashboard Conditionally About Your Seller Dashboard: PowerSeller Status http://pages.ebay.com/help/myebay/seller-dashboard.html#status PowerSeller Benefits and Requirements http://pages.ebay.com/services/buyandsell/welcome.html Zum Thema Verkaeufer-Cockpit: PowerSeller-Status http://pages.ebay.de/help/myebay/seller-dashboard.html#status Rating on how well you are following eBay rules and policies in your selling practices, and alerts you if your account or listings have any policy violations. eBay's policies and rules are guidelines that help to create a safe, fair, and enjoyable trading environment for all eBay members. If you violate certain policies, your account can be restricted without notice. This is true even if your status shows a good level of policy compliance. Because of this, understanding and following eBay's policies can help you to avoid restrictions on your account. Policy compliance directly affects your PowerSeller status. GetSellerDashboard Always About Your Seller Dashboard: Policy Compliance http://pages.ebay.com/help/myebay/seller-dashboard.html#compliance Rules for Sellers http://pages.ebay.com/help/policies/seller-rules-overview.html Zum Thema Verkaeufer-Cockpit: Einhaltung der Grundsaetze http://pages.ebay.de/help/myebay/seller-dashboard.html#compliance Rates your level of customer service. This information helps you to keep track of how well you are providing members with positive buying experiences. This element is not returned for all sites. GetSellerDashboard Conditionally About Your Seller Dashboard: Buyer Satisfaction http://pages.ebay.com/help/myebay/seller-dashboard.html#buyer Zum Thema Verkaeufer-Cockpit: Kaeuferzufriedenheit http://pages.ebay.de/help/myebay/seller-dashboard.html#buyer The status of your latest eBay invoice. Includes any alerts issued to your account to help you identify possible problems. GetSellerDashboard Always About Your Seller Dashboard: Account Status http://pages.ebay.com/help/myebay/seller-dashboard.html#account Zum Thema Verkaeufer-Cockpit: Kontostand http://pages.ebay.de/help/myebay/seller-dashboard.html#account Provides information about the seller's performance within different eBay regions. A seller's performance rating can be Top-Rated, Above Standard, Standard, and Below Standard. GetSellerDashboard Always Top-Rated Seller Status http://pages.ebay.com/sell/July2009Update/Details/index.html#1-2 About Your Seller Dashboard: Performance Status http://pages.ebay.com/help/myebay/seller-dashboard.html#performance Zum Thema Verkaeufer-Cockpit: Leistung http://pages.ebay.de/help/myebay/seller-dashboard.html#performance Retrieves price changes, item revisions, description revisions, and other changes that have occurred within the last 48 hours related to a seller's eBay listings. DetailLevel Working with Seller Events http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=WorkingWithSellerEvents eBay user ID for the seller whose events are to be returned. If not specified, retrieves events for the user identified by the authentication token passed in the request. Note that since user information is anonymous to everyone except the bidder and the seller (during an active auction), only sellers looking for information about their own listings and bidders who know the user IDs of their sellers will be able to make this API call successfully. Working with Anonymous User Information http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=AnonymousUserInfo GetSellerEvents No Describes the earliest (oldest) time to use in a time range filter based on item start time. Must be specified if StartTimeTo is specified. Either the StartTimeFrom, EndTimeFrom, or ModTimeFrom filter must be specified. If you do not specify the correspoding To filter, it is set to the time you make the call. For better results, the time period you use should be less than 48 hours. If 3000 or more items are found, use a smaller time range. Include a 2-minute, overlapping buffer between requests. For example, if StartTimeTo was 6:58 in a prior request, the current request should use 6:56 in StartTimeFrom (e.g., use ranges like 5:56-6:58, 6:56-7:58, 7:56-8:58). KB article: Best Practices for GetSellerEvents and GetSellerTransactions http://ebay.custhelp.com/cgi-bin/ebay.cfg/php/enduser/std_adp.php?p_faqid=222 GetSellerEvents Conditionally Describes the latest (most recent) date to use in a time range filter based on item start time. If you specify the corresponding From filter, but you do not include StartTimeTo, the StartTimeTo is set to the time you make the call. GetSellerEvents No Describes the earliest (oldest) date to use in a time range filter based on item end time. Must be specified if EndTimeTo is specified. Either the StartTimeFrom, EndTimeFrom, or ModTimeFrom filter must be specified. If you do not specify the correspoding To filter, it is set to the time you make the call. For better results, the time range you use should be less than 48 hours. If 3000 or more items are found, use a smaller time range. Include a 2-minute, overlapping buffer between requests. For example, if EndTimeTo was 6:58 in a prior request, the current request should use 6:56 in EndTimeFrom (e.g., use ranges like 5:56-6:58, 6:56-7:58, 7:56-8:58). KB article: Best Practices for GetSellerEvents and GetSellerTransactions http://ebay.custhelp.com/cgi-bin/ebay.cfg/php/enduser/std_adp.php?p_faqid=222 GetSellerEvents Conditionally Describes the latest (most recent) date to use in a time range filter based on item end time. If you specify the corresponding From filter, but you do not include EndTimeTo, then EndTimeTo is set to the time you make the call. GetSellerEvents No Describes the earliest (oldest) date to use in a time range filter based on item modification time. Must be specified if ModTimeTo is specified. Either the StartTimeFrom, EndTimeFrom, or ModTimeFrom filter must be specified. If you do not specify the correspoding To filter, it is set to the time you make the call. Include a 2-minute, overlapping buffer between requests. For example, if ModTimeTo was 6:58 in a prior request, the current request should use 6:56 in ModTimeFrom (e.g., use ranges like 5:56-6:58, 6:56-7:58, 7:56-8:58). For better results, the time range you use should be less than 48 hours. If 3000 or more items are found, use a smaller time range. If an unexpected item is returned (including an old item or an unchanged active item), please ignore the item. Although a maintenance process may have triggered a change in the modification time, item characteristics are unchanged. KB article: Best Practices for GetSellerEvents and GetSellerTransactions http://ebay.custhelp.com/cgi-bin/ebay.cfg/php/enduser/std_adp.php?p_faqid=222 GetSellerEvents Conditionally Describes the latest (most recent) date and time to use in a time range filter based on the time an item's record was modified. If you specify the corresponding From filter, but you do not include ModTimeTo, then ModTimeTo is set to the time you make the call. Include a 2-minute buffer between the current time and the ModTimeTo filter. GetSellerEvents No Default is true. If true, response includes only items that have been modified within the ModTime range. If false, response includes all items. GetSellerEvents No Specifies whether to include WatchCount in Item nodes returned. WatchCount is the number of watches buyers have placed on the item from their My eBay accounts. GetSellerEvents No Specifies whether to force the response to include variation specifics for multi-variation listings. If false (or not specified), eBay keeps the response as small as possible by not returning Variation.VariationSpecifics. It only returns Variation.SKU as an identifier (along with the variation price and other selling details). If the variation has no SKU, then Variation.VariationSpecifics is returned as the variation's unique identifier. If true, Variation.VariationSpecifics is returned. (Variation.SKU is also returned, if the variation has a SKU.) This may be useful for applications that don't track variations by SKU. Ignored when HideVariations=true. Please note that if the seller includes a large number of variations in many listings, using this flag may degrade the call's performance. Therefore, when you use this flag, you may need to reduce the total number of items you're requesting at once. For example, you may need to use shorter time ranges in the EndTime, StartTime, or ModTime filters. false GetSellerEvents No Specifies whether to force the response to hide variation details for multi-variation listings. If false (or not specified), eBay returns variation details (if any). In this case, the amount of detail can be controlled by using IncludeVariationSpecifics. If true, variation details are not returned (and IncludeVariationSpecifics has no effect). This may be useful for applications that use other calls, notifications, alerts, or reports to track price and quantity details. false GetSellerEvents No Contains the items returned by the call. Items for which a seller event has occurred (and that meet any filters specified as input) are returned in an ItemArrayType object, within which are zero, one, or multiple ItemType objects. Each ItemType object contains the detail data for one item listing. Indicates the latest (most recent) date for any date-based filtering specified as input. Specifically, this field contains the value you specified in the StartTimeTo, EndTimeTo, or ModTimeTo filter, if you used a time filter in the request. If no time filter was specified, TimeTo returns the current time. GetSellerEvents

DetailLevel: none, ReturnAll

Always Collection of items whose last modified time matches the filters specified in the request. Returns empty if no items were modified within the time range of the request. If 1 to 2999 items are returned, then the results are complete. If 3000 or more items are returned, it usually means additional items exist within the time range you requested, but they were not all returned. To retrieve complete results, use a smaller time range in the request so that fewer than 3000 are returned per response. KB article: Best Practices for GetSellerEvents and GetSellerTransactions http://ebay.custhelp.com/cgi-bin/ebay.cfg/php/enduser/std_adp.php?p_faqid=222 GetSellerEvents

DetailLevel: none, ReturnAll

Always Returns a list of the items posted by the authenticated user, including the related item data. DetailLevel, GranularityLevel AddItem, GetBidderList, GetItem, RelistItem, ReviseItem GetSellerList http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=GetSellerList_BP Browsing a Seller's Items http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=BrowsingSellerItems GetBidderList Specifies the seller whose items will be returned. UserID is an optional input. If not specified, retrieves listings for the user identified by the authentication token passed in the request. Note that since user information is anonymous to everyone except the bidder and the seller (during an active auction), only sellers looking for information about their own listings and bidders who know the user IDs of their sellers will be able to make this API call successfully. See <a href= "http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=AnonymousUserInfo" >Working with Anonymous User Information</a>in the eBay Web Services Guide for more information. GetSellerList No Specifies the list of Motors Dealer sellers for which a special set of metrics can be requested. Applies to eBay Motors Pro applications only. GetSellerList No Specifies the earliest (oldest) date to use in a date range filter based on item end time. Specify either an end-time range or a start-time range filter in every call request. Each of the time ranges must be a value less than 120 days. GetSellerList Conditionally Specifies the latest (most recent) date to use in a date range filter based on item end time. Must be specified if EndTimeFrom is specified. GetSellerList Conditionally Specifies the order in which returned items are sorted (based on the end dates of the item listings). Valid values: 0 = No sorting 1 = Sort in descending order 2 = Sort in ascending order GetSellerList No Specifies the earliest (oldest) date to use in a date range filter based on item start time. Each of the time ranges must be a value less than 120 days. In all calls, at least one date-range filter must be specified (i.e., you must specify either the end time range or start time range in every request). GetSellerList Conditionally Specifies the latest (most recent) date to use in a date range filter based on item start time. Must be specified if StartTimeFrom is specified. GetSellerList Conditionally Contains the data controlling the pagination of the returned values. If you set a DetailLevel in this call, you must set pagination values. The Pagination field contains the number of items to be returned per page of data (per call), and the page number to return with the current call. GetSellerList Yes Specifies the subset of item and user fields to return. See GetSellerList in the eBay Web Services guide for a list of the fields that are returned for each granularity level. For GetSellerList, use DetailLevel or GranularityLevel in a request, but not both. For GetSellerList, if GranularityLevel is specified, DetailLevel is ignored. GetSellerList http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=GetSellerList_BP Yes GetSellerList No Container for a set of SKUs. Filters (reduces) the response to only include active listings that the seller listed with any of the specified SKUs. If multiple listings include the same SKU, they are all returned (assuming they also match the other criteria in the GetSellerList request). SKUArray can be used to retrieve items listed by the user identified in AuthToken or in UserID. Note: Listings with matching SKUs are returned regardless of their Item.InventoryTrackingMethod settings. GetSellerList No Specifies whether to include WatchCount in Item nodes returned. WatchCount is only returned with DetailLevel ReturnAll. GetSellerList No Specifies whether to return only items that were administratively ended based on a policy violation. GetSellerList No The category ID for the items retrieved. If you specify CategoryID in a GetSellerList call, the response contains only items in the category you specify. GetSellerList No If true, the Variations node is returned for all multi-variation listings in the response. Please note that if the seller includes a large number of variations in many listings, using this flag may degrade the call's performance. Therefore, when you use this flag, you may need to reduce the total number of items you're requesting at once. For example, you may need to use shorter time ranges in the EndTime or StartTime filters, fewer entries per page in Pagination, and/or SKUArray. GetSellerList No Contains a list of the items listed by the seller specified as input. The list of items is returned in an ItemArrayType object, in which are returned zero, one, or multiple ItemType objects. Each ItemType object contains the detail data for one item listing. Contains information regarding the pagination of data (if pagination is used), including total number of pages and total number of entries. GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Always If true, there are more items yet to be retrieved. Additional GetSellerList calls with higher page numbers or more items per page must be made to retrieve these items. Not returned if no items match the request. GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Contains the list of the seller's items, one ItemType object per item. Returns empty if no items are available that match the request. GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Always Indicates the number of items that are being returned per page of data (i.e., per call). Will be the same as the value specified in the Pagination.EntriesPerPage input. Only returned if items are returned. GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates which page of data was just returned. Will be the same as the value specified in the Pagination.PageNumber input. (If the input is higher than the total number of pages, the call fails with an error.) Only returned if items are returned. GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates the total number of items returned (i.e., the number of ItemType objects in ItemArray). GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Always Indicates the seller whose items are returned. The seller is the eBay member whose UserID was passed in the request. If UserID was not specified, the seller is the user who made the request (identified by eBayAuthToken). GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always Half.com only. Retrieves a summary of pending or paid payments that Half.com created for the seller identified by the authentication token in the request. Only retrieves payments that occurred within a particular pay period. Each payment is for one order line item in one order. An order can contain order line items for multiple items from multiple sellers, but this call only retrieves payments that are relevant to one seller. The financial value of a payment is typically based on an amount that a buyer paid to Half.com for an order line item, with adjustments for shipping costs and Half.com's commission. For most sellers, each month contains two pay periods: One from the 1st to the 15th of the month, and one from the 16th to the last day of the month. Sellers can refer to their account information on the Half.com site to determine their pay periods. (You cannot retrieve a seller's pay periods by using eBay Web Services.) When a buyer makes a purchase and an order is created, Half.com creates a payment for the seller and marks it as Pending in the seller's Half.com account. Within a certain number of days after the pay period ends, Half.com settles payments for that period and marks each completed payment as Paid. See the Half.com Web site online help for more information about how payments are managed. Half.com http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=HalfOverview Filter to retrieve only items with the specified payment status (Paid or Pending). "Pending payments" are payments that Half.com has created but that have not yet been sent to the seller's financial institution. Pending payments are typically available once a buyer pays for an order. As Half.com processes payments by using periodic batch jobs, the GetSellerPayments response might not include an order line item's payment for up to 20 minutes after the buyer has paid. You can retrieve pending payments for the current pay period. Pending payments that have not been settled yet can also be retrieved for previous pay periods. "Paid payments" are payments that Half.com processed during previous pay periods. Paid payments might not appear in the seller's financial institution account balance until a certain number of days after the current pay period ends (see the Half.com online help for details). You can only retrieve paid payments for one previous pay period at a time. GetSellerPayments Canceled Yes Time range filter that retrieves Half.com payments that were created within a single pay period. Sellers can refer to the Half.com site to determine their pay periods. PaymentTimeFrom is the earliest (oldest) time and PaymentTimeTo is the latest (most recent) time in the range. Half.com pay periods start and end at midnight Pacific time, but the time values are stored in the database in GMT (not Pacific time). See "Time Values" in the eBay Web Services guide for information about converting between GMT and Pacific time. If you specify a PaymentStatus of Pending, add a buffer of one hour (or one day) to both ends of the time range to retrieve more data than you need, and then filter the results on the client side as needed. If any pending payments match the request, the response may include all payments since the beginning of the period. If you specify a PaymentStatus of Paid, the time range must contain one full pay period. That is, PaymentTimeFrom must be earlier or equal the start time of the pay period, and PaymentTimeTo must be later than or equal to the end time of the pay period. Otherwise, no paid payments are returned. For example, if the pay period starts on 2005-09-16 and ends on 2005-09-30, you could specify an earlier PaymentTimeFrom value of 2005-09-16T00:00:00.000Z and a later PaymentTimeTo value of 2005-10-01T12:00:00.000Z. If you specify a time range that covers two pay periods, only the payments from the most recent pay period are returned. The earliest time you can specify is 18 months ago. GetSellerPayments Yes Time range filter that retrieves Half.com payments for a single pay period. See the description of PaymentTimeTo for details about using this time range filter. For paid payments, this value should be equal to or later than the end of the last day of the pay period, where the time is converted to GMT. For example, if the period ends on 2005-09-30, you could specify 2005-10-01T09:00:00.000Z, which is later than the end of the last day. GetSellerPayments Yes If many payments are available, you may need to call GetSellerPayments multiple times to retrieve all the data. Each result set is returned as a page of entries. Use this Pagination information to indicate the maximum number of entries to retrieve per page (i.e., per call), the page number to retrieve, and other data. GetSellerPayments No Returns a summary of pending or paid payments that Half.com created for the seller identified by the authentication token in the request. Only returns payments that occurred within a particular pay period. Each payment is for one transaction for one item in one order. An order can contain transactions for multiple items from multiple sellers, but this call only retrieves payments that are relevant to one seller. Payments are only issued for items and transactions that the seller has confirmed (see the Half.com online help for details). The financial value of a payment is typically based on an amount that a buyer paid to Half.com for a transaction, plus the shipping cost the buyer paid to Half.com for the item, minus Half.com's commission. For most sellers, each month contains two pay periods: One from the 1st to the 15th of the month, and one from the 16th to the last day of the month. Payments are submitted to the seller's financial institution a certain number of days after the current pay period ends (see the Half.com online help for details). Contains information regarding the pagination of data (if pagination is used), including total number of pages and total number of entries. GetSellerPayments Always If true, there are more payments yet to be retrieved. Additional GetSellerPayments calls with higher page numbers or more entries per page must be made to retrieve these payments. If false, no more payments are available or no payments match the request (based on the payment status and time filter). GetSellerPayments Always Information about a single payment that matches the criteria in the request. A payment is between Half.com and a seller. Each payment is for one transaction for one item in one order. An order can contain transactions for multiple items from multiple sellers, but this call only retrieves payments that are relevant to one seller. The financial value of a payment is typically based on an amount that a buyer paid to Half.com for a transaction, plus the shipping cost the buyer paid for the item, minus Half.com's commission. Payments can also describe refunds that the seller has issued. Multiple SellerPayment entries can be returned per page of results. Typically, they are returned in reverse chronological order (most recent PaidTime first). Only returned if payments exist that match the request. GetSellerPayments Conditionally Indicates the number of payments that can be returned per page of data (i.e., per call). This is the same as the value specified in the Pagination.EntriesPerPage input (or the default value, if EntriesPerPage was not specified). This is not necessarily the actual number of payments returned per page (see ReturnedPaymentCountActual). GetSellerPayments Always Indicates which page of data holds the current result set. Will be the same as the value specified in the Pagination.PageNumber input. (If the input is higher than the total number of pages, the call fails with an error.) If no payments are returned, the value is 0. If payments are returned, the first page number is 1. GetSellerPayments Always Indicates the total number of payments returned (i.e., the number of SellerPayment entries returned. GetSellerPayments Always Retrieves order line item (transaction) information for the user for which the call is made, and not for any other user. Also for Half.com. (To retrieve order line items for another seller's listings, use GetItemTransactions.)

Retrieves order line item (transaction) information for the user for which the call is made, and not for any other user. Also for Half.com. (To retrieve order line items for another seller's listings, use GetItemTransactions.)

DetailLevel GetItemTransactions, GetOrderTransactions Email and Address Privacy Policy http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=EmailPrivacyPolicy the conditions under which buyer and seller email and address are returned Retrieving Order Line Item Data and Managing Orders http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=RetrievingTransactionsForSpecificSeller The ModTimeFrom and ModTimeTo fields specify a date range for retrieving order line items associated with the seller. The ModTimeFrom field is the starting date range. All of the seller's order line items that were last modified within this date range are returned in the output. The maximum date range that may be specified is 30 days. This field is not applicable if the NumberOfDays date filter is used. If you don't specify a ModTimeFrom/ModTimeTo filter, the NumberOfDays time filter is used and it defaults to 30 (days). GetSellerTransactions No The ModTimeFrom and ModTimeTo fields specify a date range for retrieving order line items associated with the seller. The ModTimeTo field is the ending date range. All of the seller's order line items that were last modified within this date range are returned in the output. The maximum date range that may be specified is 30 days. If the ModTimeFrom field is used and the ModTimeTo field is omitted, the ModTimeTo value defaults to the present time or to 30 days past the ModTimeFrom value (if ModTimeFrom value is more than 30 days in the past). This field is not applicable if the NumberOfDays date filter is used. If you don't specify a ModTimeFrom/ModTimeTo filter, the NumberOfDays time filter is used and it defaults to 30 (days). GetSellerTransactions No Child elements control pagination of the output. Use EntriesPerPage property to control the number of transactions to return per call and PageNumber property to specify the page of data to return. GetSellerTransactions No Indicates whether to include Final Value Fee (FVF) in the response. For most listing types, the Final Value Fee is returned in Transaction.FinalValueFee. The Final Value Fee is returned for each order line item. GetSellerTransactions No Include this field and set it to True if you want the ContainingOrder container to be returned in the response under each Transaction node. For single line item orders, the ContainingOrder.OrderID value takes the value of the OrderLineItemID value for the order line item. For Combined Payment orders, the ContainingOrder.OrderID value will be shared by at least two order line items (transactions) that are part of the same order. false GetSellerTransactions No Container for a set of SKUs. Filters (reduces) the response to only include order line items for listings that include any of the specified SKUs. If multiple listings include the same SKU, order line items for all of them are returned (assuming they also match the other criteria in the GetSellerTransactions request). You can combine SKUArray with InventoryTrackingMethod. For example, if you also pass in InventoryTrackingMethod=SKU, the response only includes order line items for listings that include InventoryTrackingMethod=SKU and one of the requested SKUs. GetSellerTransactions No Name of the eBay co-branded site upon which the order line item was made. This will serve as a filter for the order line items to get emitted in the response. GetSellerTransactions No NumberOfDays enables you to specify the number of days' worth of new and modified order line items that you want to retrieve. The call response contains the order line items whose status was modified within the specified number of days since the API call was made. NumberOfDays is often preferable to using the ModTimeFrom and ModTimeTo filters because you only need to specify one value. If you use NumberOfDays, then ModTimeFrom and ModTimeTo are ignored. For this field, one day is defined as 24 hours. 30 GetSellerTransactions No Filters the response to only include order line items for listings that match this InventoryTrackingMethod setting. To track items by seller-defined SKU values instead of by Item IDs, the InventoryTrackingMethod must be included and set to 'SKU' in the AddFixedPriceItem (or ReviseFixedPriceItem or RelistFixedPriceItem) call. You can combine SKUArray with InventoryTrackingMethod. For example, if you set this to SKU and you also pass in SKUArray, the response only includes order line items for listings that include InventoryTrackingMethod=SKU and one of the requested SKUs. GetSellerTransactions No If this flag is included in the request and set to 'true', the buyer's Codice Fiscale number is returned in the response (if provided by the buyer). This field is only applicable to Italian sellers. The Codice Fiscale number is unique for each Italian citizen and is used for tax purposes. false GetSellerTransactions No Returns an array of order line item (transaction) data for the seller specified in the request. The results can be used to create a report of data that is commonly necessary for order processing. Zero, one, or many Transaction objects can be returned in the TransactionArray. The set of order line items returned is limited to those that were modified between the times specified in the request's ModTimeFrom and ModTimeTo filters. The order line items returned are sorted by Transaction.Status.LastTimeModified, ascending order (that is, order line items that more recently were modified are returned last). Also returns information about the seller whose order line items were requested. If pagination filters were specified in the request, returns meta-data describing the effects of those filters on the current response and the estimated effects if the same filters are used in subsequent calls. Container consisting of the total number of order line items that match the input criteria and the total number of pages that must be scrolled through to view all order line items. To scroll through each page of order line item data, make subsequent GetSellerTransactions calls, incrementing the Pagination.PageNumber field by a value of '1' each time. GetSellerTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Always This flag indicates whether there are additional pages of order line items to view. This field will be returned as 'true' if there are additional pages or order line items to view, or 'false' if the current page of order line item data is the last page of data. GetSellerTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Always This value indicates the number of order line items returned per page (per call) and is controlled by the Pagination.EntriesPerPage value passed in the call request. Unless it is the last (or possibly only) page of data (HasMoreTransactions=false), the TransactionsPerPage value should equal the Pagination.EntriesPerPage value passed in the call request. Note: Due to the fact that item data on the eBay platform has a shorter retention period than order data, it is possible that some retrieved pages will contain no data. For pages that contain no data, the ReturnedTransactionCountActual value will be '0'. It is also possible that pages 2, 3, and 4 have no data, but pages 1 and 5 do have data. Therefore, we recommend that you scroll through each page of data (making subsequent GetSellerTransactions calls and incrementing the Pagination.PageNumber value by '1' each time) until you reach the last page, indicated by HasMoreTransactions=false. GetSellerTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Always This value indicates the page number of retrieved order line items that match the input criteria. This value is controlled by the Pagination.PageNumber value passed in the call request. To scroll through all pages of order line items that match the input criteria, you increment the Pagination.PageNumber value by '1' with each subsequent GetSellerTransactions call. GetSellerTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Always This value indicates the total number of (non-empty) order line items retrieved in the current page of results. The ReturnedTransactionCountActual value will be lower than the TransactionsPerPage value if one or more empty order line items are retreived on the page. Note: Due to the fact that item data on the eBay platform has a shorter retention period than order data, it is possible that some retrieved pages will contain no data. For pages that contain no order line item data, the ReturnedTransactionCountActual value will be '0'. It is also possible that pages 2, 3, and 4 have no data, but pages 1 and 5 do have data. Therefore, we recommend that you scroll through each page of data (making subsequent GetSellerTransactions calls and incrementing the Pagination.PageNumber value by '1' each time) until you reach the last page, indicated by HasMoreTransactions=false. GetSellerTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Always Contains information about the seller whose order line items are being returned. See the reference guide for information about the Seller object fields that are returned. GetSellerTransactions

DetailLevel: none, ReturnAll

Always List of Transaction objects representing the seller's recent sales. Each Transaction object contains the data for one purchase (of one or more items in the same listing). See the reference guide for more information about the fields that are returned for each order line item. GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Indicates whether the seller has the preference enabled that shows that the seller prefers PayPal as the method of payment for an item. This preference is indicated on an item's View Item page and is intended to influence a buyer to use PayPal to pay for the item. GetSellerTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Always Retrieves Selling Manager alerts. This call is subject to change without notice; the deprecation process is inapplicable to this call. AddSellingManagerTemplate,GetSellingManagerTemplates Using Selling Manager Calls in the Trading API http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SellingManagerApps Selling Manager page on the eBay Site http://pages.ebay.com/selling_manager/ Selling Manager Pro page on the eBay Site http://pages.ebay.com/selling_manager_pro Type defining the call-specific response fields for the GetSellingManagerAlerts call. Container consisting of details related to a Selling Manager alert. Alert types include listing automation, inventory, PaisaPay (India only), item sold, and a general alert. GetSellingManagerAlerts Conditionally Retrieves a log of emails sent, or scheduled to be sent, to buyers. The standard Trading API deprecation process is not applicable to this call.

Retrieves a log of emails sent, or scheduled to be sent, to buyers. Includes success or failure status.

Retrieves a paginated listing of a user's Selling Manager inventory.

Retrieves information about items that a seller has sold.

AddSellingManagerTemplate,GetSellingManagerTemplates Using Selling Manager Calls in the Trading API http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SellingManagerApps Selling Manager page on the eBay Site http://pages.ebay.com/selling_manager/ Selling Manager Pro page on the eBay Site http://pages.ebay.com/selling_manager_pro Search filters for sold listings. GetSellingManagerSoldListings No Listings with this store category ID will be listed. GetSellingManagerSoldListings No This holds the list of filters that can be applicable for sold listings. GetSellingManagerSoldListings No Requests listing records that are more than 90 days old. Records are archived between 90 and 120 days after being created, and thereafter can only be retrieved using this tag. GetSellingManagerSoldListings No Field to be used to sort the response. GetSellingManagerSoldListings No Order to be used for sorting the requested listings. GetSellingManagerSoldListings No Details about how many listings to return per page and which page to view. GetSellingManagerSoldListings No Specifies the earliest (oldest) and latest (most recent) dates to use in a date range filter based on item start time. A time range can be up to 120 days. GetSellingManagerSoldListings No Returns a Selling Manager user's sold listings. Response can be filtered by date, search values, and stores. Returns a Selling Manager user's sold listings. GetSellingManagerSoldListings Always Contains the total number of pages (TotalNumberOfPages) and the total number of products entries (TotalNumberOfEntries) that can be returned on repeated calls with the same format and report criteria. GetSellingManagerSoldListings Always Retrieves the set of Selling Manager automation rules associated with a Selling Manager template. This call is subject to change without notice; the deprecation process is inapplicable to this call. AddSellingManagerTemplate,GetSellingManagerTemplates,SetSellingManagerTemplateAutomationRule Using Selling Manager Calls in the Trading API http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SellingManagerApps Selling Manager page on the eBay Site http://pages.ebay.com/selling_manager/ Selling Manager Pro page on the eBay Site http://pages.ebay.com/selling_manager_pro SetSellingManagerTemplateAutomationRule The ID of the Selling Manager template whose Selling Manager automation rules you want to retrieve. You can obtain a SaleTemplateID by calling GetSellingManagerInventory. GetSellingManagerTemplateAutomationRule Yes Contains the set of automation rules associated with the specified template. The information for the automated listing rule associated with the template. GetSellingManagerTemplateAutomationRule Conditionally The information for the automated relisting rule associated with the template. GetSellingManagerTemplateAutomationRule Conditionally The information for the automated second chance offer rule associated with the template. GetSellingManagerTemplateAutomationRule Conditionally Contains fees that may be incurred when items are listed using the automation rule (e.g., a scheduled listing fee). Use of an automation rule does not in itself have a fee, but use can result in a fee. GetSellingManagerTemplateAutomationRule Conditionally Retrieves Selling Manager templates. This call is subject to change without notice; the deprecation process is inapplicable to this call. AddSellingManagerTemplate Using Selling Manager Calls in the Trading API http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SellingManagerApps Selling Manager page on the eBay Site http://pages.ebay.com/selling_manager/ Selling Manager Pro page on the eBay Site http://pages.ebay.com/selling_manager_pro The ID of the template whose data will be returned. A SaleTemplateID is the ID of a Selling Manager template. A Selling Manager template contains the data needed to list an item. One or more template IDs can be specified, each in its own container. You can obtain a SaleTemplateID by calling GetSellingManagerInventory. GetSellingManagerTemplates Yes Contains the templates requested on input. Each SellingManagerTemplateType object in the response contains the data for one Selling Manager template. Contains the data of the templates requested on input. A Selling Manager template contains the data needed to list an item. Empty if no items are available that match the request. GetSellingManagerTemplates Always Retrieves a session ID that identifies a user and your application when you make a FetchToken request. ConfirmIdentity, FetchToken, GetTokenStatus, RevokeToken Getting Tokens http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=GettingAToken Getting Tokens for Applications with Multiple Users http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=GettingATokenViaFetchToken Setting Up an Application to Receive Tokens http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=RuName The runame provided must match the one that will be used for validation during the creation of a user token. GetSessionID Yes Contains the generated SessionID, which is a unique identifier for authenticating data entry during the process that creates a user token. A 40-character identifier supplied by eBay to an application. Used to confirm the identities of the user and the application in a URL redirect during the process in which the user agrees to let the application wield a user token that grants the application the right to access eBay data on behalf of the user. Subsequently also used as input for the FetchToken API call. The SessionID is valid for five minutes after it is retrieved. GetSessionID Always Returns the shipping discount profiles defined by the user, along with other combined payment-related details such as packaging and handling costs. AddItem, GetItem, RelistItem, RevisteItem, SetShippingDiscountProfiles, VerifyAddItem Other Shipping Features http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ShippingDiscountProfiles Response to call of GetShippingDiscountProfiles. The three-digit code of the currency to be used for shipping cost discounts and insurance for combined payment orders. A discount profile can only be associated with a listing if the CurrencyID value of the profile matches the Item.Currency value specified in a listing. GetShippingDiscountProfiles Always Details of an individual discount profile defined by the user for flat rate shipping--one for each profile defined by the user. Empty if no shipping discount profiles were defined. GetShippingDiscountProfiles Always Details of an individual discount profile defined by the user for calculated shipping--one for each profile defined by the user. Empty if no shipping discount profiles were defined. GetShippingDiscountProfiles Always Indicates whether the user defined a promotional discount (the discount is active as soon as it exists). GetShippingDiscountProfiles Always This container is used by the seller to specify/modify packaging and handling discounts that are applied for combined payment orders. This container is only returned if it is set for the Shipping Discount Profile. GetShippingDiscountProfiles Conditionally The data for the specific promotional shipping discount. Returned only if it has been defined. GetShippingDiscountProfiles Conditionally The data for the domestic insurance for combined payment. Returned only if it has been defined. GetShippingDiscountProfiles Conditionally The data for the international insurance for combined payment. Returned only if it has been defined. GetShippingDiscountProfiles Conditionally This field indicates the number of days after the sale of an item in which the buyer or seller can combine multiple and mutual order line items into one Combined Payment order. In a Combined Payment order, the buyer makes one payment for all order line items, hence only unpaid order line items can be combined into a Combined Payment order. GetShippingDiscountProfiles Always Retrieves configuration information for the eBay store owned by the specified UserID, or by the caller. GetStoreCategoryUpdateStatus, GetStoreCustomPage, GetStoreOptions, SetStore, SetStoreCategories, SetStoreCustomPage Managing eBay Stores http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ManagingeBayStores Editing the Store Settings http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=EditingStoreSettings If this is set to True, only the category structure of the store is returned. If this is not specified or set to False, the complete store configuration is returned. GetStore Conditionally Specifies the category ID for the topmost category to return (along with the subcategories under it, the value of the LevelLimit property determining how deep). This tag is optional. If RootCategoryID is not specified, then the category tree starting at that root Category is returned. GetStore Conditionally Specifies the limit for the number of levels of the category hierarchy to return, where the given root category is level 1 and its children are level 2. Only categories at or above the level specified are returned. This tag is optional. If LevelLimit is not set, the complete category hierarchy is returned. Stores support category hierarchies up to 3 levels only. GetStore Conditionally Specifies the user whose store data is to be returned. If not specified, then the store returned is that for the requesting user. GetStore No Returns the data describing a seller's eBay store, including name, description, URL, and other information. The caller making the request must be the owner of an eBay store. If the authenticated caller does not have an eBay store, the response is an error. A successful response contains either the complete store configuration or information about the category hierarchy for the store only. The data describing the store configuration. GetStore Always Returns the status of the processing for category-structure changes specified with a call to SetStoreCategories. GetStore, SetStore, SetStoreCategories Managing eBay Stores http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ManagingeBayStores The task ID returned by the SetStoreCategories call. If the SetStoreCategories call was processed asynchronously, the TaskID will be a positive number. If SetStoreCategories returned a TaskID with a value of 0, the change was completed at the time the call was made (and there is no need to check status). GetStoreCategoryUpdateStatus Yes Returns the store category structure update status, when a prior SetStoreCategories call was processed asynchronously. If a SetStoreCategories request affects many listings, then the category structure changes will be processed asynchronously. If not many listings are affected by category structure changes, the status is returned in the SetStoreCategories response. The status (Pending, InProgress, Complete, or Failed) of an update to the store category structure. GetStoreCategoryUpdateStatus Always Retrieves the custom page or pages for the authenticated user's Store. GetStoreOptions, GetStore, SetStore, SetStoreCustomPage Managing Custom Pages http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ManagingCustomPages Managing eBay Stores http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ManagingeBayStores If a PageID is specified, then that page is returned, and the returned page contains the page Content. If no PageID is specified, then all pages are returned, without the page Content. GetStoreCustomPage No Contains the custom page or pages for the user's Store. The custom page or custom pages. GetStoreCustomPage Always Retrieves the current list of eBay store configuration settings. GetStore Editing the Store Settings http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=EditingStoreSettings Managing eBay Stores http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ManagingeBayStores Contains the current list of options for Store configurations. The current set of basic themes. Each basic theme definition specifies a valid color scheme for the theme. GetStoreOptions Always The current set of advances themes. Unlike basic themes, you can use any color scheme with an advanced theme. These themes are suitable for more advanced customization. GetStoreOptions Always The current set of Store logos. These logos are used in the Store header. GetStoreOptions Always The current set of eBay Store subscription tiers and corresponding subscription prices. GetStoreOptions Always The maximum number of categories in this store. GetStoreOptions Always The maximum number of category levels in this store. GetStoreOptions Always Retrieves a user's Store preferences. SetStore, SetStorePreferences Managing eBay Stores http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ManagingeBayStores Contains the Store preferences retrieved for a user. The user's Store preferences. GetStorePreferences Always Returns a list of up to 10 categories that have the highest percentage of listings whose titles or descriptions contain the keywords you specify. AddItem, GetCategories, GetCategoryMappings, GetItemRecommendations Specifies the search string, consisting of one or more words to search for in the listing title. The words "and" and "or" are treated like any other word. 350 (characters) GetSuggestedCategories Yes Returns a list of categories with the highest number of listings whose titles or descriptions contain the keywords specified in a GetSuggestedCategoriesRequest. Contains the categories that contain listings that match the query string in the request. The array can have up to 10 categories. Not returned if no categories match the query in the request. GetSuggestedCategories Conditionally Indicates the number of categories in the array. GetSuggestedCategories Always Retrieves the tax table for a user on a given site or retrieves the valid jurisdictions (if any) for a given site. SetTaxTable DetailLevel Enabling Multi-jurisdiction Sales Tax http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SalesTax Response to GetTaxTableRequest. The last time (in GMT) that the tax table was updated. Only returned if the user previously created a tax table and if the site has jurisdictions. LastUpdateTime is useful for synchronization. If you cache the user's tax table, you can use GetTaxTable to check if it has changed and whether you need to update the cached tax table. GetTaxTable

DetailLevel: ReturnAll, none

Conditionally A container of tax jurisdiction information unique to a user/site combination. Empty if not set for user. If DetailLevel is not specified, information is only returned for the jurisdictions for which the user provided tax information. If DetailLevel is ReturnAll, tax information is returned for all possible jurisdictions, whether specified by the user or not. ShippingIncludedInTax and SalesTaxPercent are returned but are empty. GetTaxTable

DetailLevel: ReturnAll, none

Always Requests current status of user token. FetchToken, RevokeToken Returns token status. Returns token status and details. For example, if revoked, whether by eBay, the user, or the application, and also when revoked. GetTokenStatus Always Retrieves data pertaining to a single eBay user. Callers can use this call to return their own user data or the data of another eBay user. Unless the caller passes in an ItemID that identifies a current or past common order, not all data (like email addresses) will be returned in the User object. DetailLevel GetAccount, GetFeedback, GetSellerDashboard,GetSellerEvents, GetSellerList, GetSellerTransactions, GetUserPreferences Managing User Information http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ManagingUserInformationChapter Specify the item ID for a successfully concluded listing in which the requestor and target user were participants (one as seller and the other as buyer). Necessary to return certain data (like an email address). Not necessary if the requestor is retrieving their own data. ItemID is an optional input. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) GetUser No Specify the user whose data you want returned by the call. UserID is optional. If not specified, eBay returns data pertaining to the requesting user (as specified with the eBayAuthToken). GetUser No This field is deprecated. 579 NoOp false If IncludeFeatureEligibility is true, the response includes a FeatureEligibility node. (The FeatureEligibility node indicates whether the seller can list with certain features.) GetUser No Contains the data retrieved by the call. User data is returned in a User object. Contains the returned user data for the specified eBay user. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Always Returns contact information for a specified user, given that a bidding relationship (as either a buyer or seller) exists between the caller and the user. AddMemberMessagesAAQToBidder, DeleteMyMessages, GetMemberMessages, ReviseMyMessages, ReviseMyMessagesFolders An eBay item ID that uniquely identifies a currently active item. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) GetUserContactDetails Yes An eBay ID that uniquely identifies a given user for whom the caller is seeking information. This is the user's eBay username. Either a seller's or bidder's username can be specified here, as long as a bidding relationship exists between the requester and the user specified by this field. That is, a bidder must be bidding on the seller's active item, or have made an offer on the item via Best Offer. GetUserContactDetails Yes An eBay ID that uniquely identifies the person who is making the call. This is the requester's eBay username. Either a seller's or bidder's username can be specified here, as long as a bidding relationship exists between the requester and the user for whom information is being requested. GetUserContactDetails Yes Returns contact information to a seller for both bidders and users who have made offers (via Best Offer) during an active listing. An eBay ID that uniquely identifies a given user. The eBay username of the requested contact. GetUserContactDetails Always Contact information for the requested contact. Note that the email address is NOT returned. GetUserContactDetails Always The date and time that the requested contact registered with eBay. GetUserContactDetails Always Requests a list of disputes the requester is involved in as buyer or seller. eBay Buyer Protection Item Not Received and Significantly Not As Described cases are not returned with this call. To retrieve eBay Buyer Protection cases, the getUserCases call of the Resolution Case Management API must be used instead.

Requests a list of disputes the requester is involved in as buyer or seller. eBay Buyer Protection Item Not Received and Significantly Not As Described cases are not returned with this call.

DetailLevel AddDispute, AddDisputeResponse, GetDispute, SellerReverseDispute Unpaid Item Disputes http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=UnpaidItemDisputes Buyer Disputes http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=BuyerDisputes Getting Details About a Dispute http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=GettingDetailsAboutADispute An inclusive filter that isolates the returned disputes to a certain type such as Item Not Received or Unpaid Item disputes. eBay Buyer Protection cases are not retrieved with this call, even if the ItemNotReceivedDisputes filter is included in the request. GetUserDisputes No The value and sequence to use to sort the returned disputes. GetUserDisputes No A filter that retrieves disputes whose DisputeModifiedTime is later than or equal to this value. Specify the time value in GMT. See the eBay Web Services documentation for information about specifying time values. For more precise control of the date range filter, it is a good practice to also specify ModTimeTo. Otherwise, the end of the date range is the present time. Filtering by date range is optional. You can use date range filters in combination with other filters like DisputeFilterType to control the amount of data returned. GetUserDisputes No A filter that retrieves disputes whose DisputeModifiedTime is earlier than or equal to this value. Specify the time value in GMT. See the eBay Web Services documentation for information about specifying time values. For more precise control of the date range filter, it is a good practice to also specify ModTimeFrom. Otherwise, all available disputes modified prior to the ModTimeTo value are returned. Filtering by date range is optional. You can use date range filters in combination with other filters like DisputeFilterType to control the amount of data returned. GetUserDisputes No The virtual page number of the result set to display. A result set has a number of disputes divided into virtual pages, with 200 disputes per page. The response can only display one page. The first page in the result set is number 1. Required. If not specified, a warning is returned and Pagination.PageNumber is set to 1 by default. GetUserDisputes Yes Returns a list of disputes that involve the calling user as buyer or seller, in response to a GetUserDisputesRequest. The index of the first dispute in the current result set, relative to the total number of disputes available. Primarily useful for interpreting paginated results. For example, if 228 disputes are available and 200 results are returned per page: The first page returns a StartingDisputeID value of 1 and the second page returns a StartingDisputeID value of 201. GetUserDisputes

DetailLevel: ReturnSummary, ReturnAll, none

Always The index of the last dispute in the current result set, relative to the total number of disputes available. Primarily useful for interpreting paginated results. For example, if 228 disputes are available and 200 results are returned per page: The first page returns an EndingDisputeID value of 200 and the second page returns an EndingDisputeID value of 228. GetUserDisputes

DetailLevel: ReturnSummary, ReturnAll, none

Always The array of disputes returned. GetUserDisputes

DetailLevel: ReturnSummary, ReturnAll, none

Always The number of disputes on each virtual page in the result set. The virtual page returned is determined by PageNumber. Default is 200. GetUserDisputes

DetailLevel: ReturnSummary, ReturnAll, none

Always The page of the total result set returned in the call. The entire result set is virtual and the call returns only one page of it. GetUserDisputes

DetailLevel: ReturnSummary, ReturnAll, none

Always The number of disputes that involve the requester as buyer or seller and match a given filter type. GetUserDisputes

DetailLevel: ReturnSummary, ReturnAll, none

Always The result of the pagination, including the total number of virtual pages in the result set and the total number of disputes returned. GetUserDisputes

DetailLevel: ReturnSummary, ReturnAll, none

Always Retrieves the specified user preferences for the authenticated caller. SetUserPreferences Managing User Preferences http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ManagingUserPreferences If included and set to true, the seller's preference for receiving contact information for unsuccessful bidders is returned in the response. false GetUserPreferences No If included and set to true, the seller's combined payment preferences are returned in the response. Note: The CombinedPaymentPreferences.CombinedPaymentOption field is the only preference that should be managed with the GetUserPreferences and SetUserPreferences calls. All other Combined Payment preferences should be managed with the SetDiscountProfiles and GetDiscountProfiles calls. false GetUserPreferences No This container should no longer be used as eBay Store Cross Promotions are no longer supported in the Trading API. This container will be removed from the Trading WSDL and API Call Reference docs in a future release. If included and set to true, the seller's cross-promotion preferences are returned in the response. These preferences are only applicable for eBay Store owners. false GetUserPreferences No If included and set to true, the seller's payment preferences are returned in the response. false GetUserPreferences No If included and set to true, the seller's preferences for the end-of-auction email sent to the winning bidder is returned in the response. These preferences are only applicable for auction listings. false GetUserPreferences No If included and set to true, the seller's favorite item preferences are returned in the response. false GetUserPreferences No If included and set to true, the seller's ProStores preferences are returned in the response. false GetUserPreferences No If included and set to true, the seller's preference for sending an email to the buyer with the shipping tracking number is returned in the response. false GetUserPreferences No If included and set to true, the seller's preference for requiring that the buyer supply a shipping phone number upon checkout is returned in the response. Some shipping carriers require the receiver's phone number. false GetUserPreferences No If included and set to true, all of the seller's excluded shipping locations are returned in the response. The returned list mirrors the seller's current Exclude shipping locations list in My eBay's Shipping Preferences. An excluded shipping location in My eBay can be an entire geographical region (such as Middle East) or only an individual country (such as Iraq). Sellers can override these default settings for an individual listing by using the Item.ShippingDetails.ExcludeShipToLocation field in the AddItem family of calls. false GetUserPreferences No If included and set to true, the seller's Unpaid Item Assistant preferences are returned in the response. The Unpaid Item Assistant automatically opens an Unpaid Item dispute on the behalf of the seller. Note: To return the list of buyers excluded from the Unpaid Item Assistant mechanism, the ShowUnpaidItemAssistanceExclusionList field must also be included and set to true in the request. Excluded buyers can be viewed in the UnpaidItemAssistancePreferences.ExcludedUser field. false GetUserPreferences No If included and set to true, the seller's preference for sending a purchase reminder email to buyers is returned in the response. false GetUserPreferences No If included and set to true, the list of eBay user IDs on the Unpaid Item Assistant Excluded User list is returned through the UnpaidItemAssistancePreferences.ExcludedUser field in the response. For excluded users, an Unpaid Item dispute is not automatically filed through the UPI Assistance mechanism. The Excluded User list is managed through the SetUserPreferences call. Note: To return the list of buyers excluded from the Unpaid Item Assistant mechanism, the ShowUnpaidItemAssistancePreference field must also be included and set to true in the request. false GetUserPreferences No If this flag is included and set to true, the seller's Business Policies profile information is returned in the response. This information includes a flag that indicates whether or not the seller has opted into Business Policies, as well as Business Policies profiles (payment, shipping, and return policy) active on the seller's account. false GetUserPreferences No If this flag is included and set to true, the seller's eBay Return Center preference information will be returned. eBay managed returns are currently only available on the US site. false GetUserPreferences No If this flag is included and set to true, the seller's preference for offering the Global Shipping Program to international buyers will be returned in OfferGlobalShippingProgramPreference. false GetUserPreferences No If this flag is included and set to true, the seller's same day handling cut off time is returned in DispatchCutoffTimePreference.CutoffTime. Note: Same day handling is available on the eBay Sandbox for release 817. It will become available on the production site as of Seller Release 13.1. false GetUserPreferences No Specifying Shipping Services http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SameDayHandling details about dispatch cut off times Contains some or all of the authenticated user's preferences. The preferences are grouped in sets and are returned according to the flag settings in the request. Container consisting of the seller's preference for receiving contact information for unsuccessful bidders. This container is returned when ShowBidderNoticePreferences is included and set to 'true' in the request. This preference is only applicable for auction listings. GetUserPreferences Conditionally Container consisting of the seller's combined payment preferences. This container is returned when ShowCombinedPaymentPreferences is included and set to 'true' in the request. Note: Calculated and flat-rate shipping preferences are no longer managed using the SetUserPreferences and GetUserPreferences calls. Instead,use the SetDiscountProfiles and GetDiscountProfiles calls to manage shipping discounts for combined payment orders. GetUserPreferences Conditionally This container is no longer supported as eBay Store Cross Promotions are no longer supported in the Trading API. This container will be removed from the Trading WSDL and API Call Reference docs in a future release. Container consisting of the seller's cross-promotion preferences. This container is returned when ShowCrossPromotionPreferences is included and set to 'true' in the request. These preferences are only applicable for eBay Store owners. GetUserPreferences Conditionally Container consisting of the seller's payment preferences. This container is returned when ShowSellerPaymentPreferences is included and set to 'true' in the request. GetUserPreferences Conditionally Container consisting of the seller's preferences for displaying items on a buyer's Favorite Sellers' Items page or Favorite Sellers' Items digest. This container is returned when ShowSellerFavoriteItemPreferences is included and set to 'true' in the request. GetUserPreferences Conditionally Container consisting of the seller's preferences for the end-of-auction email sent to the winning bidder. This container is returned when ShowEndOfAuctionEmailPreferences is included and set to 'true' in the request. These preferences are only applicable for auction listings. GetUserPreferences Conditionally Container consisting of the seller's preference for sending an email to the buyer with the shipping tracking number. This container is returned when ShowEmailShipmentTrackingNumberPreference is included and set to 'true' in the request. GetUserPreferences Conditionally Container consisting of the seller's preference for requiring that the buyer supply a shipping phone number upon checkout. Some shipping carriers require the receiver's phone number. This container is returned when ShowRequiredShipPhoneNumberPreference is included and set to 'true' in the request. GetUserPreferences Conditionally Container consisting of the seller's ProStores preferences. This container is returned when ShowProStoresPreference is included and set to 'true' in the request. GetUserPreferences Conditionally Container consisting of a seller's Unpaid Item Assistant preferences. The Unpaid Item Assistant automatically opens an Unpaid Item dispute on the behalf of the seller. This container is returned if ShowUnpaidItemAssistancePreference is included and set to 'true' in the request. Note: To return the list of buyers excluded from the Unpaid Item Assistant mechanism, the ShowUnpaidItemAssistanceExclusionList field must also be included and set to 'true' in the request. Excluded buyers can be viewed in the UnpaidItemAssistancePreferences.ExcludedUser field. GetUserPreferences Conditionally Container consisting of a list of the seller's excluded shipping locations. The returned list mirrors the seller's current Exclude shipping locations list in My eBay's shipping preferences. An excluded shipping location in My eBay can be an entire geographical region (such as Middle East) or only an individual country (such as Iraq). Sellers can override these default settings for an individual listing by using the Item.ShippingDetails.ExcludeShipToLocation field in the Add/Revise/Relist calls. This container is returned if the ShowSellerExcludeShipToLocationPreference field is included and set to 'true' in the request. GetUserPreferences Conditionally Container consisting of a seller's preference for sending a purchase reminder email to buyers. This container is returned if the ShowPurchaseReminderEmailPreferences field is included and set to 'true' in the request. GetUserPreferences Conditionally This flag is set with the SellerThirdPartyCheckoutDisabled field of the SetUserPreferences call, and is used to disable the use of a third-party application to handle the checkout flow for a seller. If true, Third-Party Checkout is disabled and any checkout flow initiated on the seller's application is redirected to the eBay checkout flow. This field is only returned if the SellerThirdPartyCheckoutDisabled field has been set with the SetUserPreferences call. GetUserPreferences Conditionally Parent response container consisting of high-level information for all Business Policies profiles defined for the user's account. This container is returned if ShowSellerProfilePreferences is included and set to 'true' in the GetUserPreferences request (and one or more Business Policies profiles are defined for the user's account). GetUserPreferences Conditionally Container consisting of a seller's eBay Return Center preferences. This container is returned if ShowSellerReturnPreferences is included and set to true in the request. GetUserPreferences Conditionally This flag indicates whether the seller has opted in to the Global Shipping Program and is able to offer global shipping to international buyers. Returned when ShowGlobalShippingProgramPreference is included and set to true. GetUserPreferences Conditionally Contains information about a seller's order cut off time preferences for same day shipping. If the seller specifies a value of <code>0</code> in Item.DispatchTimeMax to offer same day handling when listing an item, the seller's shipping time commitment depends on the order cut off time set for the listing site, as indicated by DispatchCutoffTimePreference.CutoffTime. Note: Same day handling is available on the eBay Sandbox for release 817. It will become available on the production site as of Seller Release 13.1. GetUserPreferences Conditionally Specifying Shipping Services http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SameDayHandling details about dispatch cut off times Retrieves details for VeRO reason codes and their descriptions. You can specify a reason code ID to get details for a specific reason on the site specified in the request header. If ReasonCodeID is not passed in the request, all reason codes are returned. Set ReturnAllSites to true to retrieve reason codes for all sites. You must be a member of the Verified Rights Owner (VeRO) Program to use this call.

Retrieves details about VeRO reason codes for a given site or all sites. You must be a member of the Verified Rights Owner (VeRO) Program to use this call.

Unique identifier for a reason code. If this ReasonCodeID is passed then only details of this ReasonCodeID will be returned. If no reason code is specified, all reason codes are returned. GetVeROReasonCodeDetails Conditionally Set to true to retrieve reason codes for all sites. If not specified, reason codes are returned for the site specified in the request header only. If ReasonCodeID is specified, this parameter is ignored. false GetVeROReasonCodeDetails No Contains the reason codes for all sites. Contains the list of the status codes for a site. GetVeROReasonCodeDetails Always Retrieves status information about VeRO reported items you have submitted. You can receive the status of individual items you have reported or, by specifying VeROReportPacketID, you can retrieve status for all items reported with a given VeROReportItems request. You can also retrieve items that were reported during a given time period. If no input parameters are specified, status is returned on all items you have reported in the last two years. You must be a member of the Verified Rights Owner (VeRO) Program to use this call.

Retrieves status information about VeRO reported items. You must be a member of the Verified Rights Owner (VeRO) Program to use this call.

Packet identifier associated with the reported items for which you want to retrieve status. By default, reported item details are not returned when you specify the packet ID in the request. Applies only to items reported with VeROReportItems. GetVeROReportStatus No Item ID for an item reported for alleged infringement. Applies to items reported with VeROReportItems or by other means (e.g., through the web flow). 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) GetVeROReportStatus No Set to true to return reported item details when you specify VeROReportPacketID in the request. false GetVeROReportStatus No Limits returned items to only those that were submited on or after the date-time specified. If specified, TimeTo must also be specified. Express the date-time in the format YYYY-MM-DD HH:MM:SS, and in GMT. (For information on how to convert between your local time zone and GMT, see Time Values Note.) Applies to items reported with VeROReportItems or by other means (e.g., through the web flow). Infringement reporting data is maintained for two years after the date of submission. This field is ignored if VeROReportPacketID or ItemID is specified. GetVeROReportStatus No Limits returned items to only those that were submited on or before the date-time specified. If specified, TimeFrom must also be specified. Express date-time in the format YYYY-MM-DD HH:MM:SS, and in GMT. (For information on how to convert between your local time zone and GMT, see Time Values Note.) Applies to items reported with VeROReportItems or by other means (e.g., through the web flow). Infringement reporting data is maintained for two years after the date of submission. This field is ignored if VeROReportPacketID or ItemID is specified. GetVeROReportStatus No Contains the data controlling the pagination of the returned values: how many items are returned per page of data (per call) and the number of the page to return with the current call. GetVeROReportStatus No Contains status information for items reported by the VeRO Program member. Contains information regarding the pagination of data (if pagination is used), including total number of pages and total number of entries. GetVeROReportStatus Conditionally If true, there are more items yet to be retrieved. Additional calls with higher page numbers or more items per page must be made to retrieve these items. Not returned if no items match the request. GetVeROReportStatus Conditionally Indicates the maximum number of ItemType objects that can be returned in ReportedItemDetails for any given call. 1 200 GetVeROReportStatus Conditionally Indicates the page of data returned by the current call. For instance, for the first set of items can be returned, this field has a value of one. 1 GetVeROReportStatus Conditionally The packet ID for status being returned. GetVeROReportStatus Conditionally Status of the packet. GetVeROReportStatus Conditionally Contains the list of the reported item details. Returns empty if no items are available that match the request. GetVeROReportStatus Conditionally Retrieves data for a specific, active Want It Now post identified by a post ID. The response includes the following fields: CategoryID, Description, PostID, Site, StartTime, ResponseCount, and Title. Although GetWantItNowSearchResults returns most of this information, only GetWantItNowPost returns Description for a post. Want It Now http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=WantItNowChapter Specifies the post ID that uniquely identifies the Want It Now post for which to retrieve the data. PostID is a required input. PostID is unique across all eBay sites. GetWantItNowPost Yes Contains the Want It Now post data returned by the call. The data for the specified post listing is returned in a WantItNowPostType object. Contains the data defining a single Want It Now post. GetWantItNowPost Always Retrieves a list of active Want It Now posts that match specified keywords and/or a specific category ID. The response contains the following data: CategoryID, PostID, StartTime, ResponseCount, Site, and Title. To get the post description (Description), you must use GetWantItNowPost to retrieve individual posts. Want It Now http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=WantItNowChapter Limits the result set to just those Want It Now posts listed in the specified category. Defaults to all categories if no category ID is specified. If the specified category ID does not match an existing category for the site, an invalid-category error message is returned. Controls the set of listings to return (not the details to return for each listing). You must specify a Query and/or a CategoryID in the request. 10 GetWantItNowSearchResults No Specifies a search string. The search string consists of one or more keywords to search for in the listing title. Note that the post description will also be searched if SearchInDescription is enabled. By default, requests return a list of Want It Now posts that include all of the keywords specified in the Query. All words used in the query, including "and," "or," and "the," will be treated as keywords. You can, however, use modifiers and wildcards (e.g., +, -, and *) in the Query field to create more complex searches. Be careful when using spaces before or after modifiers and wildcards (+, -, or *), as the spaces can affect the query logic. See the eBay Web Services Guide for a list of valid search keyword query operators and examples. 350 (characters) GetWantItNowSearchResults No If true, include the description field of Want It Now posts in the keyword search. Want It Now posts returned are those where specified search keywords appear in either the description or the title. This is the default behavior if SearchInDescription is not specified. If false, only the title will be searched. SearchInDescription is an optional input. GetWantItNowSearchResults No If true, the search applies to all eBay sites. If false, the search is limited to the site specified in the URL query string when the call is made. GetWantItNowSearchResults No Controls the pagination of the result set. Child elements specify the maximum number of item listings to return per call and which page of data to return. GetWantItNowSearchResults No Response contains the Want It Now posts that have the specified keyword(s) in the title and (optionally) the description. Response contains the Want It Now posts that have the specified keyword(s) in the title and (optionally) the description. Contains the returned Want It Now posts, if any. The data for each post is returned in a WantItNowPostType object. GetWantItNowSearchResults Always Indicates whether there are additional Want It Now posts that meet the search criteria. GetWantItNowSearchResults Always Indicates the maximum number of Want It Now posts that can be returned in a WantItNowPostArray for a request. This value can be specified in the request by EntriesPerPage in Pagination in the request. GetWantItNowSearchResults Always Indicates the page of data returned by the current call. GetWantItNowSearchResults Always Indicates the results of the pagination, including the total number of pages of data there are to be returned and the total number of posts there are to be returned. GetWantItNowSearchResults Always Retrieves eBay IDs and codes (e.g., site IDs and shipping service codes), enumerated data (e.g., payment methods), and other common eBay meta-data. This call enables you to keep certain data up to date in your applications without referring to the schema, the documentation, or the eBay online help. Other data is returned for your reference, but you may need to refer to the schema or the documentation for information about valid values and usage. In some cases, the data returned in the response will vary according to the site that you use for the request. If you use GeteBayDetails in preparation for listing in the US Motors Parts and Accessories categories, use site ID 0 (which is the site ID of the US site) when you call GeteBayDetails. Sellers who engage in cross-border trade on sites that require a recoupment agreement, must agree to the recoupment terms before adding items to the site. This agreement allows eBay to reimburse a buyer during a dispute and then recoup the cost from the seller. Information about whether a site is a recoupment site is returned in the GeteBayDetailsResponse.RecoupmentPolicyDetails container. A designation of what kind of information you wish returned for the specified eBay site. If omitted, all details are returned. The possible values for input (the enumeration values of DetailNameCodeType) are the same name as fields returned by the response. See the documentation for the GeteBayDetails response to better understand the DetailName options. GeteBayDetails No Details about a specified site in response to GeteBayDetailsRequest. If no DetailName field is identified in the request, all elements of GeteBayDetailsResponse are returned. Otherwise, eBay returns only the elements corresponding to the specified DetailName fields. UpdateTime gives the time of modification of the most recently modified DetailName. Details about a specified site in response to GeteBayDetailsRequest. If no DetailName field is identified in the request, all elements of GeteBayDetailsResponse are returned. Otherwise, eBay returns only the elements corresponding to the specified DetailName fields. UpdateTime gives the time of modification of the most recently modified DetailName. Lists the country code and associated name of the countries supported by the eBay system, regardless of the site specified in the request. GeteBayDetails Conditionally Lists the currencies supported by the eBay system, regardless of the site specified in the request. Note: This container is only returned if CurrencyDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. GeteBayDetails Conditionally A dispatch time specifies the maximum number of business days a seller commits to for shipping an item to domestic buyers after receiving a cleared payment. Returns all dispatch times in the system, regardless of the site specified in the request. Note: This container is only returned if DispatchTimeMaxDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. GeteBayDetails Conditionally Deprecated Use GetCategoryFeatures instead, and pass in PaymentMethods as a FeatureID value in the request. GetCategoryFeatures GetCategoryFeatures.html GeteBayDetails Conditionally No longer returned; replaced by ShippingLocationDetails. GeteBayDetails Conditionally ShippingLocationDetails #Response.ShippingLocationDetails Lists the regions and locations supported by eBay's shipping services. Returns all shipping locations supported by eBay, regardless of the site specified in the request. Note: This container is only returned if ShippingLocationDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. GeteBayDetails Conditionally Lists the shipping services supported by the specified eBay site. Returns only the shipping services that are applicable to the site specified in the request. Note: This container is only returned if ShippingServiceDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. GeteBayDetails Conditionally Lists all available eBay sites and their associated SiteID numbers. Note: This container is only returned if SiteDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. GeteBayDetails Conditionally Details the different tax jurisdictions or tax regions applicable to the site specified in the request. Note: This container is only returned if TaxJurisdiction is included as a DetailName filter in the request, or if no DetailName filters are used in the request. TaxTable.TaxJurisdiction in SetTaxTable SetTaxTable.html#Request.TaxTable.TaxJurisdiction Item.UseTaxTable in AddItem AddItem.html#Request.Item.UseTaxTable GeteBayDetails Conditionally Lists eBay URLs that are applicable to the site specified in the request.\ Note: This container is only returned if URLDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. GeteBayDetails Conditionally Lists the details of the time zones supported by the eBay system. Note: This container is only returned if TimeZoneDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. GeteBayDetails Conditionally The site's validation rules (e.g., string lengths) for custom Item Specifics. Note: This container is only returned if ItemSpecificDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. GeteBayDetails Conditionally Lists the suggested unit-of-measurement strings to use with Item Specifics descriptions. Note: This container is only returned if UnitOfMeasurementDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. GeteBayDetails Conditionally No longer returned. GeteBayDetails Conditionally Lists the various shipping packages supported by the specified site. Note: This container is only returned if ShippingPackageDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. GeteBayDetails Conditionally Lists the shipping carriers supported by the specified site. Note: This container is only returned if ShippingCarrierDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. GeteBayDetails Conditionally Lists the return policies supported by the eBay site specified in the request. Note: This container is only returned if ReturnPolicyDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. GeteBayDetails Conditionally Lists the minimum starting prices for the supported types of eBay listings. Note: This container is only returned if ListingStartPriceDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. GeteBayDetails Conditionally Details various eBay-buyer requirements. GeteBayDetails Conditionally Details the listing features available for the site specified in the request. Note: This container is only returned if ListingFeatureDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. GeteBayDetails Conditionally Site-level validation rules for multi-variation listings (for example, the maximum number of variations per listing). Use GetCategoryFeatures to determine which categories on a site support variations. Use GetCategorySpecifics for rules related to recommended or required variation specifics. Note: This container is only returned if VariationDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. GetCategoryFeatures GetCategoryFeatures.html#Response.Category.VariationsEnabled GetCategorySpecifics GetCategorySpecifics.html GeteBayDetails Conditionally Lists the locations supported by the ExcludeShipToLocation feature. These are locations that a seller can list as areas where they will not ship an item. The codes reflect the <a href= "http://www.iso.org/iso/country_codes/iso_3166_code_lists/english_country_names_and_code_elements.htm" >ISO 3166</a> location codes. GeteBayDetails Conditionally The time of the most recent modification to any feature detail. If specific feature details are passed in the request, gives the most recent modification time of those feature details. GeteBayDetails Always Details the recoupment policies for the site specified in the request. Note: This container is only returned if RecoupmentPolicyDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. GeteBayDetails Conditionally A shipping service category supported for the site. Note: This container is only returned if ShippingCategoryDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. Each shipping service supported for a site is automatically categorized by eBay into one of the shipping categories available for that site depending on how the shipping service shipping time aligns with the shipping times specified by eBay for each category. Notice that you cannot specify a ShippingCategory as an input to any API call - eBay does this categorizing automatically. ShippingCategory is read-only data that is returned in the ShippingServiceDetails container. One possible use of this data is to segregate shipping services by ShippingCategory in a pick list. (For an example of this, see the Services pulldown menu in the Give buyers shipping details form in the eBay Sell Your Item flow.) One way to populate the picklist would be to call GeteBayDetails with DetailName set to ShippingServiceDetails. Then sort these results by ShippingCategory and populate the picklist. GeteBayDetails Conditionally Gets the official eBay system time in GMT. The Timestamp field indicates the official eBay system time in GMT. For information about converting between GMT and other time zones, see "Time Values" in the Data Types appendix in the eBay Web Services guide. Half.com only. Issues a refund for a specific Half.com order line item. This can only be called by a seller. Sellers do not have the ability to issue a general refund (a refund not tied to an order line item) to a buyer. Half.com http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=HalfOverview Unique identifier for the Half.com item listing. Unless an OrderLineItemID is specified in the IssueRefund request, the ItemID is required along with the corresponding TransactionID to identify the order line item that will be refunded. You can use GetSellerPayments to retrieve the ItemID and/or TransactionID associated with the order line item. 19 (Note: The eBay database specifies 38. ItemIDs are usually 9 to 12 digits) IssueRefund Yes Unique identifier for a Half.com order line item (transaction). An order line item is created once there is a commitment from a buyer to purchase an item. Along with its corresponding ItemID, a TransactionID is used to identify the order line item that will be refunded. Unless an OrderLineItemID is specified in the IssueRefund request, the TransactionID is required along with the corresponding ItemID. You can use GetSellerPayments to retrieve the ItemID and/or TransactionID associated with the order line item. 19 (Note: The eBay database specifies 38. TransactionIDs are usually 9 to 12 digits.) IssueRefund Yes Explanation of the reason that the refund is being issued. IssueRefund Yes Explanation of the costs that the refund amount covers. IssueRefund Yes The amount the seller wants to refund to the buyer, in US Dollars (USD). Must be greater than 0.00. Half.com allows a maximum of the original item sale price (order line item price plus original shipping reimbursement) plus return shipping costs (the amount the buyer paid to return the item). Typically, the return shipping cost is based on the current cost of shipping the individual item (not the discounted cost calculated during the original checkout for a Combined Payment order). You can also issue a partial refund for the amount you want the buyer to receive. If RefundType=Full or RefundType=FullPlusShipping and you do not pass RefundAmount in the request, Half.com will calculate the refund amount for you. If you pass RefundAmount in the request, the amount you specify will override Half.com's calculated value. Required if RefundType= CustomOrPartial. IssueRefund Conditionally Note to the buyer. Cannot include HTML. 400 IssueRefund No A unique identifier for an eBay order line item. This field is created as soon as there is a commitment to buy from the seller, and its value is based upon the concatenation of ItemID and TransactionID, with a hyphen in between these two IDs. The OrderLineItemID value is used to identify the order line item that will be refunded. Unless an ItemID/TransactionID pair is specified in the IssueRefund request, the OrderLineItemID is required. You can use GetSellerPayments to retrieve the OrderLineItemID associated with the order line item. 50 (Note: ItemIDs and TransactionIDs usually consist of 9 to 12 digits.) IssueRefund No Indicates the refund amount that a seller issued to a buyer for a single Half.com order line item. Refunds may only be issued for a specific order line item. Sellers do not have the ability to issue a general refund (not tied to an order line item) to a buyer. Total amount that the seller asked Half.com to refund to a buyer for a Half.com order line item. IssueRefund Always Total amount that Half.com refunded to the buyer (which could include the refund amount from the seller plus a refund amount from Half.com). IssueRefund Always Enables a buyer and seller to leave feedback for their order partner at the conclusion of a successful order. Feedback is left at the order line item level, so multiple line item orders may have multiple Feedback entries.  Also for Half.com. GetFeedback, GetSellerDashboard, GetSellerTransactions Leaving and Retrieving Feedback http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=Feedback Introduction to Feedback http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=FeedbackIntro Leaving Feedback for Another User http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=FeedbackLeave Detailed Seller Ratings http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=DetailedSellerRatings Unique identifier for an eBay item listing. A listing can have multiple order line items, but only one ItemID. Unless an OrderLineItemID is specified in the LeaveFeedback request, the ItemID is required along with the TargetUser to identify an order line item existing between the caller and the TargetUser that requires feedback. A Feedback entry will be posted for this order line item. If there are multiple order line items between the two order partners that still require feedback, the TransactionID will also be required to isolate the targeted order line item. Feedback cannot be left for order line items with creation dates more than 60 days in the past. 19 (Note: The eBay database specifies 38. ItemIDs are usually 9 to 12 digits) LeaveFeedback Conditionally Textual comment that explains, clarifies, or justifies the Feedback rating specified in CommentType. This comment will still be displayed even if submitted Feedback is withdrawn. 80 LeaveFeedback Yes LeaveFeedback Withdrawn, IndependentlyWithdrawn Yes Unique identifier for an eBay order line item (transaction). If there are multiple order line items between the two order partners that still require feedback, the TransactionID is required along with the corresponding ItemID and TargetUser to isolate the targeted order line item. If an OrderLineItemID is included in the response to identify a specific order line item, none of the preceding fields (ItemID, TransactionID, TargetUser) are needed. Feedback cannot be left for order line items with creation dates more than 60 days in the past. 19 (Note: The eBay database specifies 38. TransactionIDs are usually 9 to 12 digits.) LeaveFeedback Conditionally This eBay User ID identifies the recipient user for whom the feedback is being left. LeaveFeedback Yes Container for detailed seller ratings (DSRs). If a buyer is providing DSRs, they are specified in this container. Sellers have access to the number of ratings they've received, as well as to the averages of the DSRs they've received in each DSR area (i.e., to the average of ratings in the item-description area, etc.). Detailed Seller Ratings http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=DetailedSellerRatings LeaveFeedback No OrderLineItemID is a unique identifier for an eBay order line item and is based upon the concatenation of ItemID and TransactionID, with a hyphen in between these two IDs. If an OrderLineItemID is included in the request, the ItemID, TransactionID, and TargetUser fields are not required. Feedback cannot be left for order line items with creation dates more than 60 days in the past. 100 LeaveFeedback Conditionally LeaveFeedback response message includes an acknowledgement if the feedback was successfully left. The ID of the feedback that has been left. LeaveFeedback Always Moves a Selling Manager inventory folder. This call is subject to change without notice; the deprecation process is inapplicable to this call. AddSellingManagerTemplate,GetSellingManagerTemplates Using Selling Manager Calls in the Trading API http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SellingManagerApps Selling Manager page on the eBay Site http://pages.ebay.com/selling_manager/ Selling Manager Pro page on the eBay Site http://pages.ebay.com/selling_manager_pro Unique ID of the folder that will be moved. User can retrieve the FolderId using GetSellingManagerInventoryFolder. MoveSellingManagerInventoryFolder Yes Unique folder ID for the new parent folder. If no NewParentFolderID is submitted, the folder is moved to the root level. MoveSellingManagerInventoryFolder No Returns the status of move folder operation. Enables the authenticated user to to make a bid, a best offer, or a purchase on the item specified by the ItemID input field. Enabling Best Offer http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=EnablingBestOffer API License Agreement http://developer.ebay.com/join/licenses/Default.aspx eBay User Agreement http://pages.ebay.com/help/policies/user-agreement.html PlaceOffer API License Agreement Addendum http://developer.ebay.com/terms/PlaceOffer_API_License_Addendum_uv.pdf API Logo Usage Requirements http://developer.ebay.com/join/licenses/apilogousage Filing a Support Ticket http://developer.ebay.com/support/developersupport/request eBay Partner Network https://www.ebaypartnernetwork.com/ GetChallengeToken, GetBestOffers Specifies the type of offer being made. If the item is a competitive-bidding listing, the offer is a bid. If the item is a fixed-price listing, then the offer purchases the item. If the item is a competitive-bidding listing and the offer is of type with an active, unexercised Buy It Now option, then the offer can either purchase the item or be a bid. See the schema documentation for OfferType for details on its properties and their meanings. PlaceOffer Yes Unique item ID that identifies the item listing for which the action is being submitted. If the item was listed with Variations, you must also specify VariationSpecifics in the request to uniquely identify the variant being purchased. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) PlaceOffer Yes If a warning message exists and BlockOnWarning is true, the warning message is returned and the bid is blocked. If no warning message exists and BlockOnWarning is true, the bid is placed. If BlockOnWarning is false, the bid is placed, regardless of warning. PlaceOffer No Container for affiliate-related tags, which enable the tracking of user activity. If you include AffiliateTrackingDetails in your PlaceOffer call, then it is possible to receive affiliate commissions based on calls made by your application. (See the <a href= "http://www.ebaypartnernetwork.com/" target="_blank">eBay Partner Network</a> for information about commissions.) Please note that affiliate tracking is not available in the Sandbox environment, and that affiliate tracking is not available when you make a best offer. Affiliate Tracking Concepts http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=AffiliateTrackingConcepts PlaceOffer No Name-value pairs that identify a single variation within the listing identified by ItemID. Required when the seller listed the item with Item Variations. If you want to buy items from multiple variations in the same listing, use a separate PlaceOffer request for each variation. For example, if you want to buy 3 red shirts and 2 black shirts from the same listing, use one PlaceOffer request for the 3 red shirts, and another PlaceOffer request for the 2 black shirts. PlaceOffer Conditionally The PlaceOffer response notifies you about the success and result of the call. Indicates the current bidding/purchase state of the item listing regarding the offer extended using PlaceOffer. See the schema documentation for the SellingStatus object, the properties of which contain such post-offer information as the current high bidder, the current price for the item, and the bid increment. PlaceOffer Always Unique identifier for an eBay order line item (transaction). The TransactionID field is only returned if the Offer.Action field was set to Purchase in the input and the purchase was successful. A Purchase action in PlaceOffer can be used for a fixed-price listing, or for an auction listing where the Buy It Now option is available. 19 (Note: The eBay database specifies 38. TransactionIDs are usually 9 to 12 digits.) PlaceOffer Conditionally Container consisting of the status for a Best Offer. This container is only returned if applicable based on the listing and the value set for Offer.Action field in the request. PlaceOffer Conditionally OrderLineItemID is a unique identifier for an eBay order line item and is based upon the concatenation of ItemID and TransactionID, with a hyphen in between these two IDs. The OrderLineItemID field is only returned if the Offer.Action field is set to Purchase in the input and the purchase is successful. A Purchase action in PlaceOffer can be used for a fixed-price listing, or for an auction listing where the Buy It Now option is available. 50 (Note: The eBay database specifies 38. ItemIDs and TransactionIDs are usually 9 to 12 digits.) PlaceOffer Conditionally Enables a seller to take a single fixed-price item (or a single multi-item listing) that has ended and re-list it on a specified eBay site. AddFixedPriceItem, RelistItem, ReviseFixedPriceItem, GetCategories Introduction to Pictures in Item Listings http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=Pictures Relisting Items http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=RelistingItems Relisting Your Item (eBay Web site onine help) http://pages.ebay.com/help/sell/relist.html Listing an Item http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ConsideringBestMatch Listing an Item http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=BestMatchReviseRelist Child elements hold the values for item properties that change for the relisted item. Item is a required input. At a minimum, the Item.ItemID property must be set to the ID of the original listing (a listing that ended in the past 90 days). By default, the new listing's Item object properties are the same as those of the original (ended) listing. By setting a new value in the Item object, the new listing uses the new value rather than the original value from the old listing. RelistFixedPriceItem Yes Specifies the name of the field to delete from a listing. See the eBay Trading API guide for rules on deleting values when relisting items. Also see the relevant field descriptions to determine when to use DeletedField (and potential consequences). The request can contain zero, one, or many instances of DeletedField (one for each field to be deleted). DeletedField accepts the following path names, which delete the corresponding nodes: Some data (such as Variation nodes within Variations) can't be deleted by using DeletedFields. See the relevant field descriptions for how to delete such data. Item.ApplicationData Item.AttributeSetArray Item.Charity Item.ConditionID Item.ItemSpecifics Item.ListingCheckoutRedirectPreference.ProStoresStoreName Item.ListingCheckoutRedirectPreference.SellerThirdPartyUsername Item.ListingDesigner.LayoutID Item.ListingDesigner.ThemeID Item.ListingDetails.LocalListingDistance Item.ListingDetails.MinimumBestOfferMessage Item.ListingDetails.MinimumBestOfferPrice Item.ListingEnhancement[Value] Item.PayPalEmailAddress Item.PictureDetails.GalleryURL Item.PictureDetails.PictureURL Item.PostalCode Item.ProductListingDetails Item.SecondaryCategory Item.SellerContactDetails Item.SellerContactDetails.CompanyName Item.SellerContactDetails.County Item.SellerContactDetails.InternationalStreet Item.SellerContactDetails.Phone2AreaOrCityCode Item.SellerContactDetails.Phone2CountryCode Item.SellerContactDetails.Phone2CountryPrefix Item.SellerContactDetails.Phone2LocalNumber Item.SellerContactDetails.PhoneAreaOrCityCode Item.SellerContactDetails.PhoneCountryCode Item.SellerContactDetails.PhoneCountryPrefix Item.SellerContactDetails.PhoneLocalNumber Item.SellerContactDetails.Street Item.SellerContactDetails.Street2 Item.ShippingDetails.PaymentInstructions Item.SKU Item.SubTitle These values are case-sensitive. Use values that match the case of the schema element names (Item.PictureDetails.GalleryURL) or make the initial letter of each field name lowercase (item.pictureDetails.galleryURL). However, do not change the case of letters in the middle of a field name. For example, item.picturedetails.galleryUrl is not allowed. To delete a listing enhancement like Featured, specify the value you are deleting; for example, Item.ListingEnhancement[Featured]. RelistFixedPriceItem Conditionally Returns the Item ID, SKU (if any), listing recommendations (if applicable), the estimated fees for the relisted item (except the Final Value Fee, which isn't calculated until the item has sold), the start and end times of the listing, and other details. Unique item ID for the relisted item. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) RelistFixedPriceItem Always Item-level SKU for the new listing, if the seller specified Item.SKU in the listing. Variation SKUs are not returned (see GetItem instead). RelistFixedPriceItem Conditionally Child elements contain the estimated listing fees for the relisted item. The fees do not include the Final Value Fee (FVF), which cannot be determined until an item is sold. RelistFixedPriceItem Always Date and time the relisting became active on the eBay site. RelistFixedPriceItem Always Date and time when the relisted item ends. This is the starting time plus the listing duration. RelistFixedPriceItem Always ID of the primary category in which the item was listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID passed in Item.PrimaryCategory was mapped to a new ID by eBay. If the primary category has not changed or it has expired with no replacement, CategoryID does not return a value. 10 RelistFixedPriceItem Conditionally ID of the secondary category in which the item was listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID passed in Item.SecondaryCategory was mapped to a new ID by eBay. If the secondary category has not changed or it has expired with no replacement, Category2ID does not return a value. 10 RelistFixedPriceItem Conditionally The nature of the discount, if a discount applied. RelistFixedPriceItem Conditionally Provides a list of products recommended by eBay which match the item information provided by the seller. Not applicable to Half.com. RelistFixedPriceItem Conditionally Container consisting of one or more Recommendation containers. Each Recommendation container provides a message to the seller on how a listing can be improved or brought up to standard in reqards to Top-Rated Plus listing requirements, Item Specifics, picture requirements, and/or a recommendation to use a product code to list the item, such as a UPC, an EAN, or an ISBN. This container is only returned if the IncludeRecommendations flag was included and set to 'true' in the RelistFixedPriceItem request, and if at least one listing recommendation exists for the newly relisted item. If one or more listing recommendations are returned, it will be at the seller's discretion about whether to revise the item based on eBay's listing recommendation(s). RelistFixedPriceItem Conditionally Enables a seller to take a single item (or a single multi-item listing) and re-list it on a specified eBay site. AddItem, AddToItemDescription, GetItem, GetItemRecommendations, GetSellerList, RelistFixedPriceItem, ReviseItem Relisting Items http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=RelistingItems http://ebay.custhelp.com/cgi-bin/ebay.cfg/php/enduser/std_adp.php?p_faqid=1542 Best practices for relisting items Introduction to Pictures in Item Listings http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=Pictures Listing an Item http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ConsideringBestMatch Listing an Item http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=BestMatchReviseRelist Child elements hold the values for item properties that change for the item re-list. Item is a required input. At a minimum, the Item.ItemID property must be set to the ID of the listing being re-listed (a listing that ended in the past 90 days). By default, the new listing's Item object properties are the same as those of the original (ended) listing. By setting a new value in the Item object, the new listing uses the new value rather than the corresponding value from the old listing. RelistItem Yes Specifies the name of the field to delete from a listing. See the eBay Web Services guide for rules on deleting values when relisting items. Also see the relevant field descriptions to determine when to use DeletedField (and potential consequences). The request can contain zero, one, or many instances of DeletedField (one for each field to be deleted). DeletedField accepts the following path names, which delete the corresponding nodes: Item.ApplicationData Item.AttributeSetArray Item.BuyItNowPrice Item.Charity Item.ConditionID Item.ItemSpecifics Item.ListingCheckoutRedirectPreference.ProStoresStoreName Item.ListingCheckoutRedirectPreference.SellerThirdPartyUsername Item.ListingDesigner.LayoutID Item.ListingDesigner.ThemeID Item.ListingDetails.LocalListingDistance Item.ListingDetails.MinimumBestOfferMessage Item.ListingDetails.MinimumBestOfferPrice Item.ListingEnhancement[Value] Item.PayPalEmailAddress Item.PictureDetails.GalleryURL Item.PictureDetails.PictureURL Item.PostalCode Item.ProductListingDetails Item.SecondaryCategory Item.SellerContactDetails Item.SellerContactDetails.CompanyName Item.SellerContactDetails.County Item.SellerContactDetails.InternationalStreet Item.SellerContactDetails.Phone2AreaOrCityCode Item.SellerContactDetails.Phone2CountryCode Item.SellerContactDetails.Phone2CountryPrefix Item.SellerContactDetails.Phone2LocalNumber Item.SellerContactDetails.PhoneAreaOrCityCode Item.SellerContactDetails.PhoneCountryCode Item.SellerContactDetails.PhoneCountryPrefix Item.SellerContactDetails.PhoneLocalNumber Item.SellerContactDetails.Street Item.SellerContactDetails.Street2 Item.ShippingDetails.PaymentInstructions Item.SKU Item.SubTitle These values are case-sensitive. Use values that match the case of the schema element names (Item.PictureDetails.GalleryURL) or make the initial letter of each field name lowercase (item.pictureDetails.galleryURL). However, do not change the case of letters in the middle of a field name. For example, item.picturedetails.galleryUrl is not allowed. To delete a listing enhancement like Featured, specify the value you are deleting; for example, Item.ListingEnhancement[Featured]. RelistItem Conditionally Returns the Item ID, SKU (if any), listing recommendations (if applicable), the estimated fees for the relisted item (except the Final Value Fee, which isn't calculated until the item has sold), the start and end times of the listing, and other details. Unique item ID for the new listing. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) RelistItem Always Child elements contain the estimated listing fees for the new item listing. The fees do not include the Final Value Fee (FVF), which cannot be determined until an item is sold. RelistItem Always Date and time the new listing became active on the eBay site. RelistItem Always Date and time when the new listing ends. This is the starting time plus the listing duration. RelistItem Always ID of the primary category in which the item was listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID passed in Item.PrimaryCategory was mapped to a new ID by eBay. If the primary category has not changed or it has expired with no replacement, CategoryID does not return a value. 10 RelistItem Conditionally ID of the secondary category in which the item was listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID passed in Item.SecondaryCategory was mapped to a new ID by eBay. If the secondary category has not changed or it has expired with no replacement, Category2ID does not return a value. 10 RelistItem Conditionally The nature of the discount, if a discount applied. RelistItem Conditionally Provides a list of products recommended by eBay which match the item information provided by the seller. Not applicable to Half.com. RelistItem Conditionally Container consisting of one or more Recommendation containers. Each Recommendation container provides a message to the seller on how a listing can be improved or brought up to standard in reqards to Top-Rated Plus listing requirements, Item Specifics, picture requirements, and/or a recommendation to use a product code to list the item, such as a UPC, an EAN, or an ISBN. This container is only returned if the IncludeRecommendations flag was included and set to 'true' in the RelistItem request, and if at least one listing recommendation exists for the newly relisted item. If one or more listing recommendations are returned, it will be at the seller's discretion about whether to revise the item based on eBay's listing recommendation(s). RelistItem Conditionally Enables a user to remove one or more items from their My eBay watch list. AddToWatchList, GetMyeBayBuying, GetMyeBaySelling The ID of the item to be removed from the watch list. Either ItemID, RemoveAllItems, or VariationKey must be specified, but NOT more than one of these. Multiple ItemID fields can be specified in the same request. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) RemoveFromWatchList Conditionally If true, then all the items in the user's watch list are removed. Either ItemID, RemoveAllItems, or VariationKey must be specified, but NOT more than one of these. RemoveFromWatchList Conditionally A variation (or set of variations) that you want to remove from the watch list. Either ItemID, RemoveAllItems, or VariationKey must be specified, but NOT more than one of these. RemoveFromWatchList Conditionally Returns information about the user's My eBay watch list. The current number of items in the user's watch list (after those specified in the call request have been removed) RemoveFromWatchList Always The maximum number of items allowed in watch lists. Currently this value is 200, and is the same for all sites and all users. RemoveFromWatchList Always Enables the seller of a Best Offer item to accept, decline, or counter offers made by bidders. Best offers can be declined in bulk, using the same message from the seller to the bidders of all rejected offers. GetBestOffers Enabling Best Offer http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=EnablingBestOffer Specifies the item for which the BestOffer data is to be returned. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) RespondToBestOffer Yes The ID of a Best Offer for the item. RespondToBestOffer Yes The action taken on the Best Offer by the seller (e.g., Accept, Decline, or Counter). Bulk Accept and Bulk Counter are not supported. That is, you cannot accept or counter multiple offers in a single call. You can, however, decline multiple offers in a single call. RespondToBestOffer Yes A comment from the seller to the buyer. 250 RespondToBestOffer Conditionally The counter offer price. When Action is set to Counter, you must specify the amount for the counter offer with CounterOfferPrice. The value of CounterOfferPrice cannot exceed the Buy It Now price for a single quantity item. The value of CounterOfferPrice may exceed the Buy It Now price if the value for CounterOfferQuantity is greater than 1. RespondToBestOffer Conditionally The quantity of items in the counter offer. When Action is set to Counter you must specify the quantity of items for the counter offer with CounterOfferQuantity. RespondToBestOffer Conditionally Contains a list of BestOffers that were either accepted or declined. A list of BestOffers that were either accepted or declined. RespondToBestOffer Always Used to reply to feedback that has been left for a user, or to post a follow-up comment to a feedback comment the user has left for someone else. GetFeedback, LeaveFeedback A unique identifier for a Feedback record. Buying and selling partners leave feedback for one another after the completion of an order. Feedback is left at the order line item (transaction) level, so a Feedback comment for each line item in a Combined Payment order is expected from the buyer and seller. A unique FeedbackID is created whenever a buyer leaves feedback for a seller, and vice versa. A FeedbackID is created by eBay when feedback is left through the eBay site, or through the LeaveFeedback call. FeedbackIDs can be retrieved with the GetFeedback call. In the RespondToFeedback call, FeedbackID can be used as an input filter to respond to a specific Feedback comment. Since Feedback is always linked to a unique order line item, an ItemID/TransactionID pair or an OrderLineItemID can also be used to respond to a Feedback comment. RespondToFeedback Conditionally Unique identifier for an eBay item listing. A listing can have multiple order line items (transactions), but only one ItemID. An ItemID can be paired up with a corresponding TransactionID and used as an input filter to respond to a Feedback comment in the RespondToFeedback call. Unless the specific Feedback record is identified by a FeedbackID or an OrderLineItemID in the request, an ItemID/TransactionID pair is required. 19 (Note: The eBay database specifies 38. ItemIDs are usually 9 to 12 digits) RespondToFeedback Conditionally Unique identifier for an eBay order line item (transaction). A TransactionID can be paired up with its corresponding ItemID and used as an input filter to respond to a Feedback comment in the RespondToFeedback call. Unless the specific Feedback record is identified by a FeedbackID or an OrderLineItemID in the request, an ItemID/TransactionID pair is required. 19 (Note: The eBay database specifies 38. TransactionIDs are usually 9 to 12 digits.) RespondToFeedback No The eBay user ID of the caller's order partner. The caller is either replyting to or following up on this user's Feedback comment. RespondToFeedback Yes Specifies whether the response is a reply or a follow-up to a Feedback comment left by the user identified in the TargetUserID field. RespondToFeedback Yes Textual comment that the user who is subject of feedback may leave in response or rebuttal to the Feedback comment. Alternatively, when the ResponseType is FollowUp, this value contains the text of the follow-up comment. 80 (125 for the Taiwan site) RespondToFeedback Yes OrderLineItemID is a unique identifier for an eBay order line item and is based upon the concatenation of ItemID and TransactionID, with a hyphen in between these two IDs. Since Feedback is always linked to a unique order line item, an OrderLineItemID can be used to respond to a Feedback comment. Unless an ItemID/TransactionID pair or a FeedbackID is used to identify a Feedback record, the OrderLineItemID must be specified. 50 (Note: ItemIDs and TransactionIDs usually consist of 9 to 12 digits.) RespondToFeedback Conditionally Indicates the success or failure of the attempt to reply to feedback that has been left for a user, or to post a follow-up comment to a feedback comment a user has left for someone else. Enables a seller to respond to a Want It Now post with an item listed on the eBay site. Responses appear on the Want It Now post page, with the item title, the price of the item, the number of bids on the item, and the time left before the listing ends. If the item has a picture, the picture is also included on the Want It Now post page. GetWantItNowSearchResults, GetWantItNowPost Want It Now http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=WantItNowChapter The unique identifier of an item listed on the eBay site. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) RespondToWantItNowPost Yes The unique identifier of a Want It Now post on the eBay site. RespondToWantItNowPost Yes Indicates the success or failure of the attempt to respond to a Want It Now post. A seller can use this call to update the payment details, the shipping details, and the status of an order. ReviseItem Checkout http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=Checkout Listing an Item http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=WorkingWithCombinedPayment Unique identifier for an eBay item listing. A listing can have multiple order line items (transactions), but only one ItemID. An ItemID can be paired up with a corresponding TransactionID and used as an input filter for ReviseCheckoutStatus. Unless an OrderLineItemID is used to identify a single line item order, or the OrderID is used to identify a single or multiple line item (Combined Payment) order, the ItemID/TransactionID pair must be specified. For a multiple line item (Combined Payment) order, OrderID should be used. If OrderID or OrderLineItemID are specified, the ItemID/TransactionID pair is ignored if present in the same request. It is also possible to identify a single line item order with a ItemID/BuyerID combination, but this is not the most ideal approach since an error is returned if there are multiple order line items for that combination. 19 (Note: The eBay database specifies 38. ItemIDs are usually 9 to 12 digits) ReviseCheckoutStatus Conditionally Unique identifier for an eBay order line item (transaction). An order line item is created once there is a commitment from a buyer to purchase an item. Since an auction listing can only have one order line item during the duration of the listing, the TransactionID for auction listings is always 0. Along with its corresponding ItemID, a TransactionID is used and referenced during an order checkout flow and after checkout has been completed. The ItemID/TransactionID pair can be used as an input filter for ReviseCheckoutStatus. Unless an OrderLineItemID is used to identify a single line item order, or the OrderID is used to identify a single or multiple line item (Combined Payment) order, the ItemID/TransactionID pair must be specified. For a multiple line item (Combined Payment) order, OrderID must be used. If OrderID or OrderLineItemID are specified, the ItemID/TransactionID pair is ignored if present in the same request. 19 (Note: The eBay database specifies 38. TransactionIDs are usually 9 to 12 digits.) ReviseCheckoutStatus Conditionally A unique identifier that identifies a single line item or multiple line item (Combined Payment) order. For a single line item order, the OrderID value is identical to the OrderLineItemID value that is generated upon creation of the order line item. For a Combined Payment order, the OrderID value is created by eBay when the buyer or seller (sharing multiple, common order line items) combines multiple order line items into a Combined Payment order through the eBay site. A Combined Payment order can also be created by the seller through the AddOrder call. The OrderID can be used as an input filter for ReviseCheckoutStatus. OrderID overrides an OrderLineItemID or ItemID/TransactionID pair if these fields are also specified in the same request. ReviseCheckoutStatus Conditionally The total amount paid by the buyer. For a motor vehicle purchased on eBay Motors, AmountPaid is the total amount paid by the buyer for the deposit. AmountPaid is optional if CheckoutStatus is Incomplete and required if it is Complete. ReviseCheckoutStatus Conditionally Payment method used by the buyer. This field is required if CheckoutStatus is Complete and the payment method is a trusted payment method other than PayPal. See eBay's <a href="http://pages.ebay.com/help/policies/accepted-payments-policy.html">Accepted Payments Policy</a>. If the payment method is PayPal, this field should not be used since only PayPal can set this field's value to "PayPal". ReviseCheckoutStatus cannot be used for a non-trusted payment method. Note: Required or allowed payment methods vary by site and category. Refer to <a href="http://developer.ebay.com/DevZone/XML/docs/WebHelp/wwhelp/wwhimpl/js/html/wwhelp.htm?context=eBay_XML_API&topic=PaymentMethodDifferences"> Payment Method Differences (PaymentMethod)</a> in the eBay Trading API Guide for information to help you determine which payment methods you are required or allowed to specify. ReviseCheckoutStatus PayPal Conditionally The current checkout status of the order. Often, the seller or application will mark this value as 'Complete' if payment has been made. The CheckoutStatus value cannot be updated by DE and AT sellers who are subject to the new payment process, and an attempt to do so in a ReviseCheckoutStatus call will result in a call error. Note: The introduction of the new eBay payment process for the entire German and Austrian eBay marketplace has been delayed until further notice. ReviseCheckoutStatus Yes The shipping service selected by the buyer from among the shipping services offered by the seller (such as UPS Ground). For a list of valid values, call GeteBayDetails with DetailName set to ShippingServiceDetails. The ShippingServiceDetails.ValidForSellingFlow flag must also be present. Otherwise, that particular shipping service option is no longer valid and cannot be offered to buyers through a listing. Note: ReviseCheckoutStatus is not available for the Global Shipping program; specifying InternationalPriorityShipping as a value for this field will produce an error. ShippingServiceCodeType ReviseCheckoutStatus No An indicator of whether shipping costs were included in the taxable amount. . ReviseCheckoutStatus No false Enumeration value that indicates whether shipping insurance was offered to and selected by the buyer. ReviseCheckoutStatus No Marks the order as paid or awaiting payment in My eBay. If you specify Paid, My eBay displays an icon for each item in the order to indicate that the order status is Paid. If you specify Pending, this indicates that the order is awaiting payment. (Some applications may use Pending when the buyer has paid but the funds have not yet been sent to the seller's financial institution.) ReviseCheckoutStatus cannot be used to update payment and checkout status for a non-trusted payment method. See eBay's <a href=" http://pages.ebay.com/help/policies/accepted-payments-policy.html"> Accepted Payments Policy</a> for more information on trusted payment methods. If the payment method is PayPal, this field should not be used since PayPal automatically set this field's value to "Paid" upon receiving the buyer's payment. The PaymentStatus value cannot be updated by DE and AT sellers who are subject to the new eBay payment process, and an attempt to do so in a ReviseCheckoutStatus call will result in a call error. Note: The introduction of the new eBay payment process for the entire German and Austrian eBay marketplace has been delayed until further notice. ReviseCheckoutStatus No Paid, Pending Discount or charge agreed to by the buyer and seller. A positive value indicates that the amount is an extra charge being paid to the seller by the buyer. A negative value indicates that the amount is a discount given to the buyer by the seller. ReviseCheckoutStatus No For internal use. ReviseCheckoutStatus No eBay user ID for the order's buyer. A single line item order can actually be identified by a BuyerID/ItemID pair, but this approach is not recommended since an error is returned if there are multiple order line items for that combination. BuyerID is ignored if any other valid filter or filter combination is used in the same request. ReviseCheckoutStatus Conditionally The amount of money paid for shipping insurance. ReviseCheckoutStatus No The sales tax amount for the order. This field should be used if sales tax was applied to the order. ReviseCheckoutStatus No The amount of money paid for shipping. ReviseCheckoutStatus No Not supported. 20 ReviseCheckoutStatus No Container consisting of a unique identifier and timestamp for the electronic payment of an order. An ExternalTransactionID is not exposed to a new DE or AT seller who is subject to the new eBay payment process. Note: The introduction of the new eBay payment process for the entire German and Austrian eBay marketplace has been delayed until further notice. ReviseCheckoutStatus No Not supported. ReviseCheckoutStatus No This dollar value indicates the money due from the buyer upon delivery of the item. This field should only be specified in the ReviseCheckoutStatus request if 'COD' (cash-on-delivery) was the payment method selected by the buyer and it is included as the PaymentMethodUsed value in the same request. ReviseCheckoutStatus No Other Shipping Features http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=CODInShippingDetails OrderLineItemID is a unique identifier for an eBay order line item and is based upon the concatenation of ItemID and TransactionID, with a hyphen in between these two IDs. For a single line item order, the OrderLineItemID value can be passed into the OrderID field to revise the checkout status of the order. Unless an ItemID/TransactionID pair is used to identify a single line item order, or the OrderID is used to identify a single or multiple line item (Combined Payment) order, the OrderLineItemID must be specified. For a multiple line item (Combined Payment) order, OrderID should be used. If OrderLineItemID is specified, the ItemID/TransactionID pair are ignored if present in the same request. 100 ReviseCheckoutStatus Conditionally Indicates success or failure of the attempt to revise the listing's checkout status. Enables a seller to change the properties of a currently active fixed-price listing (including multi-variation listings). AddFixedPriceItem, RelistFixedPriceItem, ReviseItem Revising Items http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=RevisingItems Introduction to Pictures in Item Listings http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=Pictures Listing an Item http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ConsideringBestMatch Listing an Item http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=BestMatchReviseRelist Child elements hold the values for item details that you want to change. The Item.ItemID must always be set to the ID of the listing being changed. Only specify Item fields for the details that are changing. Unless otherwise specified in the field descriptions below, the listing retains its existing values for fields that you don't pass in the ReviseFixedPriceItem request. Use DeletedField to remove a field from the listing. ReviseFixedPriceItem Yes Specifies the name of a field to delete from a listing. The request can contain zero, one, or many instances of DeletedField (one for each field to be deleted). See the relevant field descriptions to determine when to use DeletedField (and potential consequences). You cannot delete required fields from a listing. Some fields are optional when you first list an item (e.g., SecondaryCategory), but once they are set they cannot be deleted when you revise an item. Some optional fields cannot be deleted if the item has bids and/or ends within 12 hours. Some optional fields cannot be deleted if other fields depend on them. See the eBay Trading API guide for rules on removing values when revising items. Some data (such as Variation nodes within Variations) can't be deleted by using DeletedFields. See the relevant field descriptions for how to delete such data. DeletedField accepts the following path names, which delete the corresponding nodes: Item.ApplicationData Item.AttributeSetArray Item.ConditionID Item.ItemSpecifics Item.ListingCheckoutRedirectPreference.ProStoresStoreName Item.ListingCheckoutRedirectPreference.SellerThirdPartyUsername Item.ListingDesigner.LayoutID Item.ListingDesigner.ThemeID Item.ListingEnhancement[Value] Item.PayPalEmailAddress Item.PictureDetails.GalleryURL Item.PictureDetails.PictureURL Item.PostalCode Item.ProductListingDetails Item.SellerContactDetails Item.SellerContactDetails.CompanyName Item.SellerContactDetails.County Item.SellerContactDetails.InternationalStreet Item.SellerContactDetails.Phone2AreaOrCityCode Item.SellerContactDetails.Phone2CountryCode Item.SellerContactDetails.Phone2CountryPrefix Item.SellerContactDetails.Phone2LocalNumber Item.SellerContactDetails.PhoneAreaOrCityCode Item.SellerContactDetails.PhoneCountryCode Item.SellerContactDetails.PhoneCountryPrefix Item.SellerContactDetails.PhoneLocalNumber Item.SellerContactDetails.Street Item.SellerContactDetails.Street2 Item.ShippingDetails.PaymentInstructions Item.SKU (unless InventoryTrackingMethod is SKU) Item.SubTitle These values are case-sensitive. Use values that match the case of the schema element names (Item.PictureDetails.GalleryURL) or make the initial letter of each field name lowercase (item.pictureDetails.galleryURL). However, do not change the case of letters in the middle of a field name. For example, item.picturedetails.galleryUrl is not allowed. To delete a listing enhancement like BoldTitle, specify the value you are deleting in square brackets ("[ ]"); for example, Item.ListingEnhancement[BoldTitle]. ReviseFixedPriceItem Conditionally Returns the Item ID, SKU (if any), listing recommendations (if applicable), the estimated fees for the revised listing (except the Final Value Fee, which isn't calculated until the item has sold), the start and end times of the listing, and other details. Item ID that uniquely identifies the item listing that was revised. Provided for confirmation purposes. The value returned should be the same as the item ID specified in the ItemID property of the Item object specified as input for the call. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) ReviseFixedPriceItem Always Item-level SKU for the listing, if the seller specified Item.SKU for the listing. Variation SKUs are not returned (see GetItem instead). ReviseFixedPriceItem Conditionally Starting date and time for the listing. ReviseFixedPriceItem Always Date and time when the new listing ends. This equals the starting time plus the listing duration. ReviseFixedPriceItem Always Child elements contain the estimated listing fees for the revised item listing. The fees do not include the Final Value Fee (FVF), which cannot be determined until an item is sold. Revising an item does not itself incur a fee. However, certain item properties are fee-based and result in the return of fees in the call's response. ReviseFixedPriceItem Always eBay.com Fees http://pages.ebay.com/help/sell/fees.html Fees per Site http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=FeesPerSite Final Value Fees and Credits http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=FinalValueFeesAndCredits Final Value Fees http://pages.ebay.com/help/sell/fvf.html ID of the primary category in which the item was listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID passed in Item.PrimaryCategory was mapped to a new ID by eBay. If the primary category has not changed or it has expired with no replacement, CategoryID does not return a value. 10 ReviseFixedPriceItem Conditionally ID of the secondary category in which the item was listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID passed in Item.SecondaryCategory was mapped to a new ID by eBay. If the secondary category has not changed or it has expired with no replacement, Category2ID does not return a value. 10 ReviseFixedPriceItem Conditionally The nature of the discount, if a discount applied. ReviseFixedPriceItem Conditionally Provides a list of products recommended by eBay which match the item information provided by the seller. Not applicable to Half.com. ReviseFixedPriceItem Conditionally Container consisting of one or more Recommendation containers. Each Recommendation container provides a message to the seller on how a listing can be improved or brought up to standard in reqards to Top-Rated Plus listing requirements, Item Specifics, picture requirements, and/or a recommendation to use a product code to list the item, such as a UPC, an EAN, or an ISBN. This container is only returned if the IncludeRecommendations flag was included and set to 'true' in the ReviseFixedPriceItem request, and if at least one listing recommendation exists for the listing about to be revised. If one or more listing recommendations are returned, it will be at the seller's discretion about whether to revise the item again based on eBay's listing recommendation(s). ReviseFixedPriceItem Conditionally Enables a seller to change the price and quantity of a currently- active, fixed-price listing. Using ReviseInventoryStatus to modify data qualifies as revising the listing. Inputs are the item IDs or SKUs of the listings being revised, and the price and quantity that are being changed for each revision. Only applicable to fixed-price listings. Changing the price or quantity of a currently- active, fixed-price listing does not reset the Best Match performance score. For Best Match information related to multi-variation listings, see the Best Match information at the following topic: <a href="http://pages.ebay.com/sell/variation/">Multi-quantity Fixed Price listings with variations</a>. As with all listing calls, the site you specify in the request URL (for SOAP) or the X-EBAY-API-SITEID HTTP header (for XML) should match the original listing's Item.Site value. In particular, this is a best practice when you submit new and revised listings. For Large Merchant Services users: When you use ReviseInventoryStatus within a Merchant Data file, it must be enclosed within two BulkDataExchangeRequest tags. After release 637, a namespace is returned in the BulkDataExchangeResponseType (top level) of the response. The BulkDataExchange tags are not shown in the call input/output descriptions.

Enables a seller to change the price and quantity of currently active fixed-price items.

AddItems, GetSellerList, ReviseItem, RelistItem Standard Data for All Calls http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=TargetSite Listing an Item http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ConsideringBestMatch Listing an Item http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=BestMatchReviseRelist Contains the updated quantity and/or price of a listing being revised. You should not modify the same listing twice (by using a duplicate ItemID or SKU) in the same request; otherwise, you may get an error or unexpected results. (For example, you should not use one InventoryStatus node to update the quantity and another InventoryStatus node to update the price of the same item.) You can pass up to 4 InventoryStatus nodes in a single request. ReviseInventoryStatus Yes 4 Returns the Item ID or SKU with changed Price and Quantity for the revised listing. Confirms the quantity and price associated with a listing or variation that was revised. StartTime, EndTime ReviseInventoryStatus Always 4 Child elements contain the estimated listing fees for a listing that was revised. Use the ItemID to correlate the Fees data with the InventoryStatus data in the response. The fees do not include the Final Value Fee (FVF), which can't be determined until the listing has sales. If you revise a variation in a multi-variation listing, the fees are for the entire listing. The insertion fee and listing fee are affected by the highest priced variation in the listing (which is not necessarily the variation that you passed in the request). Also note that the call returns only one Fees node per listing. For example, if you revise 4 variations from the same multi-variation listing, the response includes 4 InventoryStatus nodes and 1 Fees node. ReviseInventoryStatus Always eBay.com Fees http://pages.ebay.com/help/sell/fees.html Fees per Site http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=FeesPerSite Final Value Fees and Credits http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=FinalValueFeesAndCredits Final Value Fees http://pages.ebay.com/help/sell/fvf.html Enables a seller to change the properties of a currently active listing. Also for Half.com. After one item in a multi-quantity fixed-price listing has been sold, you can not the values in the Title, Primary Category, Secondary Category, Listing Duration, and Listing Type fields for that listing. However, all other fields in the multi-quantity, fixed-price listing are editable. Inputs are the Item ID of the listing you are revising, and the field or fields that you are updating. AddItem, AddToItemDescription, GetItem, GetSellerList, RelistItem, ReviseFixedPriceItem, GetCategories, GetCategoryMappings Revising Items http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=RevisingItems Introduction to Pictures in Item Listings http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=Pictures Listing an Item http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ConsideringBestMatch Listing an Item http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=BestMatchReviseRelist Child elements hold the values for properties that are changing. The Item.ItemID property must always be set to the ID of the item listing being changed. Set values in the Item object only for those properties that are changing. Use DeletedField to remove a property. Applicable to Half.com. ReviseItem Yes Specifies the name of a field to delete from a listing. See the eBay Trading API guide for rules on deleting values when revising items. Also see the relevant field descriptions to determine when to use DeletedField (and potential consequences). The request can contain zero, one, or many instances of DeletedField (one for each field to be deleted). You cannot delete required fields from a listing. Some fields are optional when you first list an item (e.g., SecondaryCategory), but once they are set they cannot be deleted when you revise an item. Some optional fields cannot be deleted from auction listings if the item has bids and/or ends within 12 hours. Some optional fields cannot be deleted if other fields depend on them. Some data (such as Variation nodes within Variations) can't be deleted by using DeletedFields. See the relevant field descriptions for how to delete such data. See the eBay Web Services guide for rules on removing values when revising items. Also see the relevant field descriptions for details on when to use DeletedField (and potential consequences). DeletedField accepts the following path names, which delete the corresponding nodes: Item.ApplicationData Item.AttributeSetArray Item.BuyItNowPrice Item.ConditionID Item.ExtendedSellerContactDetails Item.ClassifiedAdContactByEmailEnabled Item.ItemSpecifics Item.ListingCheckoutRedirectPreference.ProStoresStoreName Item.ListingCheckoutRedirectPreference.SellerThirdPartyUsername Item.ListingDesigner.LayoutID Item.ListingDesigner.ThemeID Item.ListingDetails.MinimumBestOfferMessage Item.ListingDetails.MinimumBestOfferPrice Item.ListingEnhancement[Value] Item.PayPalEmailAddress Item.PictureDetails.GalleryURL Item.PictureDetails.PictureURL Item.PostalCode Item.ProductListingDetails Item.SellerContactDetails Item.SellerContactDetails.CompanyName Item.SellerContactDetails.County Item.SellerContactDetails.InternationalStreet Item.SellerContactDetails.Phone2AreaOrCityCode Item.SellerContactDetails.Phone2CountryCode Item.SellerContactDetails.Phone2CountryPrefix Item.SellerContactDetails.Phone2LocalNumber Item.SellerContactDetails.PhoneAreaOrCityCode Item.SellerContactDetails.PhoneCountryCode Item.SellerContactDetails.PhoneCountryPrefix Item.SellerContactDetails.PhoneLocalNumber Item.SellerContactDetails.Street Item.SellerContactDetails.Street2 Item.ShippingDetails.PaymentInstructions Item.SKU (unless InventoryTrackingMethod is SKU) Item.SubTitle These values are case-sensitive. Use values that match the case of the schema element names (Item.PictureDetails.GalleryURL) or make the initial letter of each field name lowercase (item.pictureDetails.galleryURL). However, do not change the case of letters in the middle of a field name. For example, item.picturedetails.galleryUrl is not allowed. To delete a listing enhancement like BoldTitle, specify the value you are deleting in square brackets ("[ ]"); for example, Item.ListingEnhancement[BoldTitle]. ReviseItem Conditionally When the VerifyOnly boolean tag value is supplied as 'true', the response will include the calculated listing price change if there is an increase in the BIN/Start price, but does not persist the values in DB. This call is similar to VerifyAddItem in revise mode. ReviseItem Conditionally Returns the Item ID, SKU (if any), listing recommendations (if applicable), the estimated fees for the revised listing (except the Final Value Fee, which isn't calculated until the item has sold), the start and end times of the listing, and other details. Item ID that uniquely identifies the item listing that was revised. Provided for confirmation purposes. The value returned should be the same as the item ID specified in the ItemID property of the Item object specified as input for the call. Also applicable to Half.com. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) ReviseItem Always Starting date and time for the revised listing. Also returned for Half.com (for Half.com, the start time is always the time the item was originally listed). ReviseItem Always Date and time when the new listing ends. This is the starting time plus the listing duration. Also returned for Half.com, but for Half.com the actual end time is GTC (not the end time returned in the response). ReviseItem Always Child elements contain the estimated listing fees for the revised item listing. The fees do not include the Final Value Fee (FVF), which cannot be determined until an item is sold. Revising an item does not itself incur a fee. However, certain item properties are fee-based and result in the return of fees in the call's response. Not applicable to Half.com. ReviseItem Always ID of the primary category in which the item was listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID passed in Item.PrimaryCategory was mapped to a new ID by eBay. If the primary category has not changed or it has expired with no replacement, CategoryID does not return a value. Not applicable to Half.com. 10 ReviseItem Conditionally ID of the secondary category in which the item was listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID passed in Item.SecondaryCategory was mapped to a new ID by eBay. If the secondary category has not changed or it has expired with no replacement, Category2ID does not return a value. Not applicable to Half.com. 10 ReviseItem Conditionally Supporting VerifyOnly for ReviseItem call as part of project 24083 (API - Critical enhancements). When the VerifyOnly boolean tag value is supplied as 'true', the response will include the calculated listing price change if there is an increase in the BIN/Start price, but does not persist the values in DB. This call is simialr to VerifyAddItem in revise mode. ReviseItem Conditionally The nature of the discount, if a discount applied. ReviseItem Conditionally Provides a list of products recommended by eBay which match the item information provided by the seller. Not applicable to Half.com. ReviseItem Conditionally Container consisting of one or more Recommendation containers. Each Recommendation container provides a message to the seller on how a listing can be improved or brought up to standard in reqards to Top-Rated Plus listing requirements, Item Specifics, picture requirements, and/or a recommendation to use a product code to list the item, such as a UPC, an EAN, or an ISBN. This container is only returned if the IncludeRecommendations flag was included and set to 'true' in the ReviseItem request, and if at least one listing recommendation exists for the listing about to be revised. If one or more listing recommendations are returned, it will be at the seller's discretion about whether to revise the item again based on eBay's listing recommendation(s). ReviseItem Conditionally Sets the read state for messages, sets the flagged state of messages, and moves messages into and out of folders. AddMemberMessagesAAQToBidder, DeleteMyMessages, GetMessagePreferences, GetMemberMessages, GetMyMessages, ReviseMyMessagesFolders Contains a list of up to 10 MessageID values. MessageIDs must be included in the request. Messages in the Sent box cannot be moved, marked as Read, or Flagged. ReviseMyMessages Conditionally This field will be deprecated in an upcoming release. This field formerly contained a list of up to 10 AlertID values. Alerts cannot be flagged. Alerts cannot be moved into a new folder until they have been resolved. Resolve alerts by marking Read (if no action is required), or by using ActionURL (if action is required). Changes the read states of all messages specified in a request. At least one of the following must be specified in the request: Read, Flagged, or FolderID. Messages in the Sent box cannot be moved, marked as Read, or Flagged. Note that messages retrieved with the API are not automatically marked Read, and must be marked Read with this call. ReviseMyMessages Conditionally Changes the flagged states of all messages specified in a request by their MessageID values. At least one of Read, Flagged, or FolderID must be specified in the request. Messages in the Sent box cannot be moved, marked as Read, or Flagged. ReviseMyMessages Conditionally An ID that uniquely identifies the My Messages folder to move messages into. At least one of Read, Flagged, or FolderID must be specified in the request. Messages in the Sent box cannot be moved, marked as Read, or Flagged. ReviseMyMessages Conditionally The response to ReviseMyMessagesRequestType. If the request was successful, ReviseMyMessages returns nothing. Renames, removes, or restores the specified My Messages folders for a given user. AddMemberMessagesAAQToBidder, DeleteMyMessages, GetMessagePreferences, GetMemberMessages, GetMyMessages, ReviseMyMessages Indicates the type of operation to perform on a specified My Messages folder. Operations include creating, renaming, removing, and restoring folders. Operations cannot be performed on the Inbox and Sent folders. ReviseMyMessagesFolders Yes An ID that uniquely identifies the My Messages folder to perform the operation on. This value is set by eBay and cannot be changed. Retrieve FolderIDs by calling GetMyMessages with a DetailLevel of ReturnSummary. Inbox is FolderID = 0, and Sent is FolderID = 1. ReviseMyMessagesFolders Yes The name of a specified My Messages folder. Depending on the specified Operation, the value is an existing folder name or a new folder name. Retrieve existing FolderNames by calling GetMyMessages with a DetailLevel of ReturnSummary. Inbox is FolderID = 0, and Sent is FolderID = 1. ReviseMyMessagesFolders Conditionally The response to ReviseMyMessagesFoldersRequestType. If the request was successful, ReviseMyMessagesFolders returns nothing. Renames a Selling Manager inventory folder. This call is subject to change without notice; the deprecation process is inapplicable to this call.

Revises the name of a Selling Manager inventory folder.

AddSellingManagerTemplate,GetSellingManagerTemplates Using Selling Manager Calls in the Trading API http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SellingManagerApps Selling Manager page on the eBay Site http://pages.ebay.com/selling_manager/ Selling Manager Pro page on the eBay Site http://pages.ebay.com/selling_manager_pro Identifier of the folder to be modified. Valid inputs are folder ID, folder name, and comments. ReviseSellingManagerInventoryFolder Yes Returns the status of a revise folder operation. Contains information about the folder that has been renamed. ReviseSellingManagerInventoryFolder Always Revises a Selling Manager product. This call is subject to change without notice; the deprecation process is inapplicable to this call. AddSellingManagerTemplate,GetSellingManagerTemplates Using Selling Manager Calls in the Trading API http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SellingManagerApps Selling Manager page on the eBay Site http://pages.ebay.com/selling_manager/ Selling Manager Pro page on the eBay Site http://pages.ebay.com/selling_manager_pro The details of the product that is being revised. ReviseSellingManagerProduct Yes The details of the folder for this product. ReviseSellingManagerProduct Conditionally Specifies the name of a field to remove from a Selling Manager product. The request can contain zero, one, or many instances of DeletedField (one for each field to be removed). DeletedField accepts the following path names, which remove the corresponding fields: SellingManagerProductDetails.CustomLabel SellingManagerProductDetails.QuantityAvailable SellingManagerProductDetails.UnitCost These values are case-sensitive. Use values that match the case of the schema element names. ReviseSellingManagerProduct Conditionally Specifies an eBay category associated with the product, defines Item Specifics that are relevant to the product, and defines variations available for the product (which may be used to create mult-variation listings). ReviseSellingManagerProduct Yes Response for revising a Selling Manager product. The details of the product. ReviseSellingManagerProduct Always Request type containing the input fields for the ReviseSellingManagerSaleRecord call. The standard Trading API deprecation process is not applicable to this call. AddSellingManagerTemplate,GetSellingManagerTemplates Using Selling Manager Calls in the Trading API http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SellingManagerApps Selling Manager page on the eBay Site http://pages.ebay.com/selling_manager/ Selling Manager Pro page on the eBay Site http://pages.ebay.com/selling_manager_pro Unique identifier for an eBay item listing. A listing can have multiple order line items (transactions), but only one ItemID. An ItemID can be paired up with a corresponding TransactionID and used as an input filter for ReviseSellingManagerSaleRecord. The ItemID/TransactionID pair corresponds to a Selling Manager SaleRecordID, which can be retrieved with the GetSellingManagerSaleRecord call. Unless an OrderLineItemID is used to identify a single line item order, or the OrderID is used to identify a single or multiple line item (Combined Payment) order, the ItemID/TransactionID pair must be specified. For a multiple line item (Combined Payment) order, OrderID should be used. If OrderID or OrderLineItemID are specified, the ItemID/TransactionID pair is ignored if present in the same request. ReviseSellingManagerSaleRecord Conditionally Unique identifier for an eBay order line item (transaction). An order line item is created once there is a commitment from a buyer to purchase an item. Since an auction listing can only have one order line item during the duration of the listing, the TransactionID for auction listings is always 0. Along with its corresponding ItemID, a TransactionID is used and referenced during an order checkout flow and after checkout has been completed. The ItemID/TransactionID pair can be used as an input filter for ReviseSellingManagerSaleRecord. The ItemID/TransactionID pair corresponds to a Selling Manager SaleRecordID, which can be retrieved with the GetSellingManagerSaleRecord call. Unless an OrderLineItemID is used to identify a single line item order, or the OrderID is used to identify a single or multiple line item (Combined Payment) order, the ItemID/TransactionID pair must be specified. For a multiple line item (Combined Payment) order, OrderID must be used. If OrderID or OrderLineItemID are specified, the ItemID/TransactionID pair is ignored if present in the same request. ReviseSellingManagerSaleRecord Conditionally A unique identifier that identifies a single line item or multiple line item (Combined Payment) order. For a single line item order, the OrderID value is identical to the OrderLineItemID value that is generated upon creation of the order line item. For a Combined Payment order, the OrderID value is created by eBay when the buyer or seller (sharing multiple, common order line items) combines multiple order line items into a Combined Payment order through the eBay site. A Combined Payment order can also be created by the seller through the AddOrder call. The OrderID can be used as an input filter for ReviseSellingManagerSaleRecord. The OrderID is linked to a Selling Manager SaleRecordID, and can be retrieved with the GetSellingManagerSaleRecord call. OrderID overrides an OrderLineItemID or ItemID/TransactionID pair if these fields are also specified in the same request. ReviseSellingManagerSaleRecord Conditionally Container consisting of order costs, shipping details, order status, and other information. The changes made under this container will update the order in Selling Manager. ReviseSellingManagerSaleRecord Conditionally OrderLineItemID is a unique identifier for an eBay order line item and is based upon the concatenation of ItemID and TransactionID, with a hyphen in between these two IDs. For a single line item order, the OrderLineItemID value can be passed into the OrderID field to revise the order in Selling Manager. Unless an ItemID/TransactionID pair is used to identify a single line item order, or the OrderID is used to identify a single or multiple line item (Combined Payment) order, the OrderLineItemID must be specified. For a multiple line item (Combined Payment) order, OrderID should be used. If OrderLineItemID is specified, the ItemID/TransactionID pair are ignored if present in the same request. 50 (Note: ItemIDs and TransactionIDs usually consist of 9 to 12 digits.) ReviseSellingManagerSaleRecord Conditionally Response to a ReviseSellingManagerSaleRecord call. Revises a Selling Manager template. This call is subject to change without notice; the deprecation process is inapplicable to this call. AddSellingManagerTemplate,GetSellingManagerTemplates Using Selling Manager Calls in the Trading API http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SellingManagerApps Selling Manager page on the eBay Site http://pages.ebay.com/selling_manager/ Selling Manager Pro page on the eBay Site http://pages.ebay.com/selling_manager_pro The ID of the sale template. You can obtain a SaleTemplateID by calling GetSellingManagerInventory or AddSellingManagerTemplate. ReviseSellingManagerTemplate Yes Reserved for future use. The name of the sale template. ReviseSellingManagerTemplate No Required. In Item.ItemID, specify the same value as the value you specified in SaleTemplateID. Other child elements hold the values for properties that are being changed. Set values in the Item object only for those properties that are changing. Use DeletedField to remove a property. ReviseSellingManagerTemplate Yes Specifies the name of a field to remove from a template. See the eBay Web Services guide for rules on removing values when revising items. Also see the relevant field descriptions to determine when to use DeletedField (and potential consequences). The request can contain zero, one, or many instances of DeletedField (one for each field to be removed). DeletedField accepts the following path names, which remove the corresponding fields: Item.ApplicationData Item.AttributeSetArray Item.ConditionID Item.ItemSpecifics Item.ListingCheckoutRedirectPreference.ProStoresStoreName Item.ListingCheckoutRedirectPreference.SellerThirdPartyUsername Item.ListingDesigner.LayoutID Item.ListingDesigner.ThemeID Item.ListingEnhancement[Value] Item.PayPalEmailAddress Item.PictureDetails.GalleryURL Item.PictureDetails.PictureURL Item.PostalCode Item.ProductListingDetails item.ShippingDetails.PaymentInstructions item.SKU Item.SubTitle These values are case-sensitive. Use values that match the case of the schema element names (Item.PictureDetails.GalleryURL) or make the initial letter of each field name lowercase (item.pictureDetails.galleryURL). However, do not change the case of letters in the middle of a field name (e.g., item.picturedetails.galleryUrl is not allowed). Depending on how you have configured your pictures, you cannot necessarily delete both GalleryURL and PictureURL from an existing listing. If GalleryType was already set for the item you are revising, you cannot remove it. This means you still need to include either a first picture or a gallery URL in your revised listing. ReviseSellingManagerTemplate Conditionally Use this field to verify the template instead of revising it. ReviseSellingManagerTemplate No Returns the template ID and the estimated fees for the revised listing. This sale template ID uniquely identifies the template that was revised in the request. This sale template ID should match the template ID specified in the request. specified for the call. ReviseSellingManagerTemplate Always Child elements contain the estimated listing fees for the revised item listing. The fees do not include the Final Value Fee (FVF), which cannot be determined until an item is sold. Revising an item does not itself incur a fee. However, certain item properties are fee-based and result in the return of fees in the call's response. Not applicable to Half.com. ReviseSellingManagerTemplate Always ID of the primary category in which the item was listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID passed in Item.PrimaryCategory was mapped to a new ID by eBay. If the primary category has not changed or it has expired with no replacement, CategoryID does not return a value. Not applicable to Half.com. ReviseSellingManagerTemplate Conditionally ID of the secondary category in which the item was listed. Only returned if you set Item.CategoryMappingAllowed to true in the request and the ID passed in Item.SecondaryCategory was mapped to a new ID by eBay. If the secondary category has not changed or it has expired with no replacement, Category2ID does not return a value. Not applicable to Half.com. ReviseSellingManagerTemplate Conditionally Instead of revising, only verifies the template. ReviseSellingManagerTemplate Always The name of the sale template. ReviseSellingManagerTemplate Always The details of the product that this template belongs to. ReviseSellingManagerTemplate Always Revokes a token before it would otherwise expire. FetchToken, GetSessionID, GetTokenStatus Cancels notification subscriptions for the user/application if set to true. Default value is false. RevokeToken No Response when an application has voluntarily revoked a user token. Creates a Selling Manager listing template that is similar to an item. This call is subject to change without notice; the deprecation process is inapplicable to this call. AddSellingManagerTemplate,GetSellingManagerTemplates Using Selling Manager Calls in the Trading API http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SellingManagerApps Selling Manager page on the eBay Site http://pages.ebay.com/selling_manager/ Selling Manager Pro page on the eBay Site http://pages.ebay.com/selling_manager_pro ItemID which should be created as a template and saved to inventory. SaveItemToSellingManagerTemplate Yes Associates the new template with a product. SaveItemToSellingManagerTemplate Yes Name associated with the template. If no name is submitted, the template will be named automatically. SaveItemToSellingManagerTemplate Yes Returns the status of save to template operation. Template ID that is newly created. SaveItemToSellingManagerTemplate Always Enables a seller to "reverse" an Unpaid Item dispute that has been closed, for example, if buyer and seller reach an agreement. The seller's Final Value Fee credit and the buyer's strike are both reversed, if applicable. The dispute might have resulted in a strike to the buyer and a Final Value Fee credit to the seller. A buyer and seller sometimes come to agreement after a dispute has been closed. In particular, the seller might discover that the buyer actually paid, or the buyer might agree to pay the seller's fees in exchange for having the strike removed. A dispute can only be reversed if it was closed with DisputeActivity set to SellerEndCommunication, CameToAgreementNeedFVFCredit, or MutualAgreementOrNoBuyerResponse.

Enables a seller to "reverse" an Unpaid Item dispute that has been closed, for example, if buyer and seller reach an agreement. The seller's Final Value Fee credit and the buyer's strike are both reversed. if applicable.

AddDispute, AddDisputeResponse, GetDispute, GetUserDisputes Reversing a Closed Unpaid Item Dispute http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ReverseClosedUPIDispute Unpaid Item Disputes http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=UnpaidItemDisputes The unique identifier of the dispute that was returned when the dispute was created. The dispute must be an Unpaid Item dispute that the seller opened. SellerReverseDispute Yes The reason the dispute is being reversed. SellerReverseDispute Yes Returned after calling SellerReverseDisputeRequest. Contains the status of the call and any errors or warnings. Enables a seller to send an order invoice to a buyer. Where applicable, updates to shipping, payment methods, and sales tax made in this request are applied to the specified order as a whole and to the individual order line items whose data are stored in individual Transaction objects.

Enables a seller to send an order invoice to a buyer.

AddItem, GetItemTransactions, GetSellerTransactions Unique identifier for an eBay item listing. Unless OrderID or OrderLineItemID is provided in the request, the ItemID (or SKU) is required and must be paired with the corresponding TransactionID to identify a single line item order. For a multiple line item (Combined Payment) order, OrderID should be used. 19 (Note: The eBay database specifies 38. ItemIDs are usually 9 to 12 digits) SendInvoice Conditionally Unique identifier for an eBay order line item (transaction). An order line item is created once there is a commitment from a buyer to purchase an item. Since an auction listing can only have one order line item during the duration of the listing, the TransactionID for auction listings is always 0. Unless OrderID or OrderLineItemID is provided in the request, the TransactionID is required and must be paired with the corresponding ItemID to identify a single line item order. For a multiple line item (Combined Payment) order, OrderID should be used. 19 (Note: The eBay database specifies 38. TransactionIDs are usually 9 to 12 digits.) SendInvoice Conditionally A unique identifier that identifies a single line item or multiple line item (Combined Payment) orders. For a single line item order, the OrderID value is identical to the OrderLineItemID value that is generated upon creation of the order line item. For a Combined Payment order, the OrderID value is created by eBay when the buyer or seller (sharing multiple, common order line items) combines multiple order line items into a Combined Payment order. A Combined Payment order can also be created by the seller through the AddOrder call. Unless the ItemID (or SKU) and corresponding TransactionID, or the OrderLineItemID is provided in the request to identify a single line item order, the OrderID must be specified. If OrderID is specified, OrderLineItemID, ItemID, TransactionID, and SKU are ignored if present in the same request. SendInvoice Conditionally If the buyer has an International shipping address, use this container to offer up to three International shipping services. If International shipping services are offered, (domestic) ShippingServiceOptions should not be included in the request. SendInvoice No If the buyer has a domestic shipping address, use this container to offer up to three domestic shipping services. If domestic shipping services are offered, InternationalShippingServiceOptions should not be included in the request. SendInvoice No Container consisting of sales tax details. The amount of sales tax to add to the price of an order is dependent on the sales tax rate in the buyer's state and whether sales tax is being applied to the cost of the order only or the cost of the order plus shipping. SendInvoice No Specifies whether an insurance fee is required. An InsuranceOption value of IncludedInShippingHandling cannot be used if the item will use calculated shipping. Some shipping carriers automatically include shipping insurance for qualifying items. SendInvoice NotOfferedOnSite No Determining Shipping Costs for a Listing http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ShippingGettingCosts Insurance cost, as set by seller, if ShippingType = 1. Specify if InsuranceOption is optional or required. Must be greater than zero value if a value of Optional or Required is passed in InsuranceOption. Value specified should be the total cost of insuring the item. 0.0 SendInvoice No Determining Shipping Costs for a Listing http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ShippingGettingCosts This optional field allows a US or German seller to add specific payment methods that were not in the original item listing. The only valid values for this field are 'PayPal' for a US listing, or 'MoneyXferAcceptedInCheckout' (CIP+) for a DE listing. SendInvoice No If the PaymentMethods field is used and set to PayPal, the seller provides his/her PayPal email address in this field. SendInvoice No This field allows the seller to provide a message or instructions regarding checkout/payment or the return policy. 500 SendInvoice No Flag indicating whether or not the seller wishes to receive an email copy of the invoice sent to the buyer. true SendInvoice No This dollar value indicates the money due from the buyer upon delivery of the item. This field should only be specified in the SendInvoice request if 'COD' (cash-on-delivery) was the payment method selected by the buyer and it is included as the PaymentMethods value in the same request. SendInvoice No Other Shipping Features http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=CODInShippingDetails The seller's unique identifier for an item that is being tracked by this SKU. If OrderID or OrderLineItemID are not provided, both SKU (or ItemID) and corresponding TransactionID must be provided to uniquely identify a single line item order. For a multiple line item (Combined Payment) order, OrderID must be used. This field can only be used if the Item.InventoryTrackingMethod field (set with the AddFixedPriceItem or RelistFixedPriceItem calls) is set to SKU. 50 SendInvoice Conditionally A unique identifier for an eBay order line item. This field is created as soon as there is a commitment to buy from the seller, and its value is based upon the concatenation of ItemID and TransactionID, with a hyphen in between these two IDs. Unless the ItemID (or SKU) and corresponding TransactionID is used to identify a single line item order, or the OrderID is used to identify a single or multiple line item (Combined Payment) order, the OrderLineItemID must be specified. For a multiple line item (Combined Payment) order, OrderID should be used. If OrderLineItemID is specified, ItemID, TransactionID, and SKU are ignored if present in the same request. 50 (Note: ItemIDs and TransactionIDs usually consist of 9 to 12 digits.) SendInvoice Conditionally This field allows the seller to adjust the total cost of the order to account for an extra charge or to pass down a discount to the buyer. The currency used in this field must be the same currency of the listing site. A positive value in this field indicates that the amount is an extra charge being paid to the seller by the buyer, and a negative value indicates that the amount is a discount given to the buyer by the seller. SendInvoice Conditionally Returns the status of calling SendInvoice. Enables a seller to add custom Ask Seller a Question (ASQ) subjects to their Ask a Question page, or to reset any custom subjects to their default values. GetMessagePreferences Contains custom ASQ subjects or a flag to reset those subjects to their default values. SetMessagePreferences No Returns the success or failure of the SetMessagePreferencesRequest, and any applicable errors. Manages notification and alert preferences for applications and users. GetNotificationPreferences, GetNotificationsUsage Working with Platform Notifications http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=PlatformNotifications Specifies application-level event preferences that have been enabled, including the URL to which notifications should be delivered and whether notifications should be enabled or disabled (although the UserDeliveryPreferenceArray input property specifies specific notification subscriptions). SetNotificationPreferences No Specifies events and whether or not they are enabled. SetNotificationPreferences No Specifies user data for notification settings, such as mobile phone number. SetNotificationPreferences No Characteristics or details of an event such as type, name and value. Currently can only be set for wireless applications. SetNotificationPreferences No Specifies up to 25 ApplicationDeliveryPreferences.DeliveryURLDetails.DeliveryURLName to associate with a user token sent in a SetNotificationPreferences request. To specify multiple DeliveryURLNames, create separate instances of ApplicationDeliveryPreferences.DeliveryURLDetails.DeliveryURLName, and then enable up to 25 DeliveryURLNames by including them in comma-separated format in this field. SetNotificationPreferences No (out) Returns the success or failure of a SetNotificationPreferences request. Creates or modifies a promotional sale. Promotional sales enable sellers to apply discounts and/or free shipping across many listings.

Creates or modifies a promotional sale. Promotional sales enable sellers to apply discounts and/or free shipping across many listings.

SetPromotionalSaleListings, GetPromotionalSaleDetails Putting Store Items on Sale http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=PuttingItemsOnSale The seller must include this field and set it to 'Add' to create a new promotional sale, or set it to 'Update' to modify an existing promotional sale, or set it to 'Delete' to delete a promotional sale. SetPromotionalSale Yes This container must be included in each SetPromotionalSale call. The fields of this container that will be used will depend on whether the seller is adding a new promotional sale, updating an existing promotional sale, or deleting an existing promotional sale. SetPromotionalSale Yes Contains the ID and status of a promotional sale. The Promotional Price Display feature enables sellers to apply discounts and/or free shipping across many listings. Contains the status of a promotional sale. SetPromotionalSale Always Contains the ID of a promotional sale. SetPromotionalSale Always Defines the SetPromotionalSaleListings call request. SetPromotionalSale, GetPromotionalSaleDetails Putting Store Items on Sale http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=PuttingItemsOnSale The unique identifier of the seller's promotional sale. Based on the Action value, listings will either be added to or removed from the promotional sale. SetPromotionalSaleListings Yes This required field determines whether you are adding (specify 'Add') or removing (specify 'Delete) one or more listings from the promotional sale identified by the PromotionalSaleID value in the request. If you specify 'Delete', you must include one or more ItemID values under the PromotionalSaleItemIDArray container, and you cannot use the other filter options in the request. If you specify 'Add', you can add one or more listings using any of the filtering options in the request. Active auction listings that have one or more bids cannot be added to or removed from a promotional sale. SetPromotionalSaleListings Add, Delete Yes Container consisting of one or more ItemID values. Based on the Action value, the listings identified by these ItemID values are either added to or removed from the promotional sale. This container is required if listings are being removed (Action='Delete') from the promotional sale. SetPromotionalSaleListings Conditionally If a StoreCategoryID value is included in the call request, all active items in this store category are added to the promotional sale. This field cannot be used if the Action field is set to 'Delete'. SetPromotionalSaleListings No If a CategoryID value is included in the call request, all active items in this eBay category are added to the promotional sale. This field cannot be used if the Action field is set to 'Delete'. SetPromotionalSaleListings No If this field is included and set to 'true' in the call request, all fixed-price listings are added to the promotional sale. This field cannot be used if the Action field is set to 'Delete'. SetPromotionalSaleListings No If this field is included and set to 'true' in the call request, all store inventory items are added to the promotional sale. This field cannot be used if the Action field is set to 'Delete'. SetPromotionalSaleListings No If this field is included and set to 'true' in the call request, all auction listings are added to the promotional sale. This field cannot be used if the Action field is set to 'Delete'. SetPromotionalSaleListings No Contains the status of a promotional sale. Contains the status of a promotional sale. SetPromotionalSaleListings Always Enables Selling Manager subscribers to store standard feedback comments that can be left for their buyers. Selling Manager Pro subscribers can also specify what events, if any, will trigger an automated feedback to buyers.

Enables Selling Manager and Selling Manager Pro subscribers to store feedback comments for buyers and set automated feedback preferences (Selling Manager Pro subscribers only).

Revises or adds to the set of Selling Manager automation rules associated with a specific item.

Revises or adds to the Selling Manager automation rules associated with a specific template.

AddSellingManagerTemplate,GetSellingManagerTemplates,GetSellingManagerTemplateAutomationRule,DeleteSellingManagerTemplateAutomationRule Using Selling Manager Calls in the Trading API http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SellingManagerApps Selling Manager page on the eBay Site http://pages.ebay.com/selling_manager/ Selling Manager Pro page on the eBay Site http://pages.ebay.com/selling_manager_pro The ID of the Selling Manager template whose automation rules you want to change. You can obtain a SaleTemplateID by calling GetSellingManagerInventory. SetSellingManagerTemplateAutomationRule Yes The information for the automated listing rule to be associated with the template. SetSellingManagerTemplateAutomationRule No The information for the automated relisting rule to be associated with the template. SetSellingManagerTemplateAutomationRule No The information for the automated second chance offer rule to be associated with the template. SetSellingManagerTemplateAutomationRule No Contains the set of automation rules associated with the specified template. Contains the automated listing rule associated with this template. SetSellingManagerTemplateAutomationRule Conditionally Contains the automated relisting rule associated with this template. SetSellingManagerTemplateAutomationRule Conditionally Contains the automated second chance offer rule associated with this template. SetSellingManagerTemplateAutomationRule Conditionally Contains fees that may be incurred when items are listed using the automation rules (e.g., a scheduled listing fee). Use of an automation rule does not in itself have a fee, but use can result in a fee. SetSellingManagerTemplateAutomationRule Conditionally Enables a seller to define shipping cost discount profiles for things such as combined payments for shipping and handling costs. AddItem, GetItem, GetShippingDiscountProfiles, RelistItem, ReviseItem, VerifyAddItem Other Shipping Features http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ShippingDiscountProfiles The three-digit code of the currency to be used for shipping cost discounts and insurance for combined payment orders. A discount profile can only be associated with a listing if the CurrencyID value of the profile matches the Item.Currency value specified in a listing. Required if the user creates flat rate shipping discount profiles, a promotional discount, a packaging/handling cost profile based on a variable discount rule, or if the user defines shipping insurance range/fee pairs. Note: There is a currencyID attribute on many elements of SetShippingDiscountProfiles. To avoid an error, be sure to use the same CurrencyID value in each occurrence within the same request. SetShippingDiscountProfiles Conditionally This field is used to specify the number of days after the sale of an item in which the buyer or seller can combine multiple and mutual order line items into one Combined Payment order. In a Combined Payment order, the buyer makes one payment for all order line items, hence only unpaid order line items can be combined into a Combined Payment order. SetShippingDiscountProfiles Yes Indicates what action to take on the specified flat shipping discount, calculated shipping discount or promotional discount. If the action is Delete and if a flat rate or calculated shipping discount profile is specified, the discount profile identified by DiscountProfile.DiscountProfileID is deleted (see DiscountProfile.MappedDiscountProfileID for related details). SetShippingDiscountProfiles Yes Details of a shipping cost discount profile for flat rate shipping. If this is provided, CalculatedShippingDiscount and PromotionalShippingDiscountDetails should be omitted. SetShippingDiscountProfiles No Details of a shipping cost discount profile for calculated shipping. If this is provided, FlatShippingDiscount and PromotionalShippingDiscountDetails should be omitted. SetShippingDiscountProfiles No This container is used by the seller to specify/modify packaging and handling discounts that are applied for combined payment orders. SetShippingDiscountProfiles No The data for the promotional shipping discount. If this is provided, FlatShippingDiscount and CalculatedShippingDiscount should be omitted. SetShippingDiscountProfiles No Information establishing what fee to apply for domestic shipping insurance for combined payment depending on which range the order item-total price falls into. SetShippingDiscountProfiles No Information establishing what fee to apply for international shipping insurance for combined payment depending on which range the order item-total price falls into. SetShippingDiscountProfiles No The response to a call of SetShippingDiscountProfiles. Sets the configuration of the eBay store owned by the caller. GetStoreOptions, GetStore, GetStoreCustomPage, SetStoreCustomPage, SetStoreCategories, GetStoreCategoryUpdateStatus Editing the Store Settings http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=EditingStoreSettings Specifies the Store configuration that is being set for the user. SetStore Yes Returned after calling SetStoreRequest. This serves as confirmation that the Store configuration was successfully submitted. Changes the category structure of an eBay store. GetStore, GetStoreCategoryUpdateStatus, SetStore Managing eBay Stores http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ManagingeBayStores Specifies the type of action (Add, Move, Delete, or Rename) to carry out for the specified categories. SetStoreCategories Yes Items can only be contained within child categories. A parent category cannot contain items. If adding, moving, or deleting categories displaces items, you must specify a destination child category under which the displaced items will be moved. The destination category must have no child categories. SetStoreCategories Conditionally When adding or moving store categories, specifies the category under which the listed categories will be located. To add or move categories to the top level, set the value to -999. SetStoreCategories Conditionally Specifies the store categories on which to act. SetStoreCategories Yes Returns the status of the processing progress for changes to the category structure for a store. The task ID associated with the category structure change request. For a simple change, the SetStoreCategories call is processed synchronously. That is, simple changes are made immediately and then the response is returned. For synchronous processing, the task ID in the response is 0. If the category structure changes affect many listings, the changes will be processed asynchronously and the task ID will be a positive number. Use the non-zero task ID with GetStoreCategoryUpdateStatus to monitor the status of asynchronously processed changes. SetStoreCategories Always When a category structure change is processed synchronously, the status is returned as Complete or Failed. For asynchronously processed changes, the status is reported as Pending. Use GetStoreCategoryUpdateStatus to monitor the status of asynchronously processed changes. SetStoreCategories Always Contains data for store categories that you have created. SetStoreCategories Always Creates or updates a custom page on a user's eBay Store. GetStoreOptions, GetStore, SetStore, GetStoreCustomPage Managing Custom Pages http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ManagingCustomPages The custom page being submitted. SetStoreCustomPage Yes Returned after calling SetStoreCustomPageRequest. This serves as confirmation that the custom page was successfully submitted. The custom page that was submitted. SetStoreCustomPage Always Sets the preferences for a user's eBay Store. GetStore, GetStorePreferences, SetStore Managing eBay Stores http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ManagingeBayStores Specifies the store preferences. SetStorePreferences No Returned after calling SetStorePreferencesRequest. This serves as confirmation that the Store preferences were successfully submitted. Sets the tax table for a seller on a given site. GetTaxTable Enabling Multi-jurisdiction Sales Tax http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SalesTax Managing User Preferences http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SettingUserPreferences Enabling Multi-jurisdiction Sales Tax http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SalesTax A container of tax jurisdiction information unique to a user/site combination. SetTaxTable Yes Response to SetTaxTableRequest. Enables users to add, replace, and delete My eBay notes for items that are being tracked in the My eBay All Selling and All Buying areas. ID of the item to which the My eBay note will be attached. Notes can only be added to items that are currently being tracked in My eBay. 19 (Note: The eBay database specifies 38. ItemIDs are usually 9 to 12 digits) SetUserNotes Conditionally The seller must include this field and set it to 'AddOrUpdate' to add a new user note or update an existing user note, or set it to 'Delete' to delete a an existing user note. SetUserNotes Yes Text of the note. Maximum 250 characters. Required only if the Action is AddOrUpdate. This note text will completely replace any existing My eBay note for the specified item. 250 SetUserNotes Conditionally Unique identifier for the order line item (transaction) to which the My eBay note will be attached. Notes can only be added to order line items that are currently being tracked in My eBay. Buyers can view user notes made on order line items in the PrivateNotes field of the WonList container in GetMyeBayBuying, and sellers can view user notes made on order line items in the PrivateNotes field of the SoldList and DeletedFromSoldList containers in GetMyeBaySellinging. SetUserNotes No Container consisting of name-value pairs that identify (match) one variation within a fixed-price, multi-variation listing. The specified name-value pair(s) must exist in the listing specified by either the ItemID or SKU values specified in the request. If a specific order line item is targeted in the request with an ItemID/TransactionID pair or an OrderLineItemID value, any specified VariationSpecifics container is ignored by the call. SetUserNotes No SKU value of the item variation to which the My eBay note will be attached. Notes can only be added to items that are currently being tracked in My eBay. A SKU (stock keeping unit) value is defined by and used by the seller to identify a variation within a fixed-price, multi- variation listing. The SKU value is assigned to a variation of an item through the Variations.Variation.SKU element. This field can only be used if the Item.InventoryTrackingMethod field (set with the AddFixedPriceItem or RelistFixedPriceItem calls) is set to SKU. If a specific order line item is targeted in the request with an ItemID/TransactionID pair or an OrderLineItemID value, any specified SKU is ignored by the call. SetUserNotes No A unique identifier for an eBay order line item. This field is created as soon as there is a commitment to buy from the seller, and its value is based upon the concatenation of ItemID and TransactionID, with a hyphen in between these two IDs. OrderLineItemID can be used in the input instead of an ItemID/TransactionID pair to identify an order line item. Notes can only be added to order line items that are currently being tracked in My eBay. Buyers can view user notes made on order line items in the PrivateNotes field of the WonList container in GetMyeBayBuying, and sellers can view user notes made on order line items in the PrivateNotes field of the SoldList and DeletedFromSoldList containers in GetMyeBaySellinging. 50 (Note: ItemIDs and TransactionIDs usually consist of 9 to 12 digits.) SetUserNotes Conditionally Returns the status of the call. Defines the SetUserPreferences request container. GetUserPreferences Managing User Preferences http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ManagingUserPreferences Container consisting of the seller's preference for receiving contact information for unsuccessful bidders. This preference is only applicable for auction listings. SetUserPreferences No Container consisting of the seller's preference for allowing combined payment on multiple orders shared between the same seller and buyer. Note: Calculated and flat-rate shipping preferences are no longer set using this call. Instead, use the SetShippingDiscountProfiles call to set the shipping discounts for combined payment orders. Note: A seller's combined payment preferences can take up to 7 days to have any logical or functional effect on eBay. SetUserPreferences No This container should no longer be used as eBay Store Cross Promotions are no longer supported in the Trading API. This container will be removed from the Trading WSDL and API Call Reference docs in a future release. Container consisting of the seller's cross-promotion preferences. These preferences are only applicable for eBay Store owners. One or more preferences may be set or modified under this field. SetUserPreferences No Container consisting of the seller's payment preferences. One or more preferences may be set or modified under this field. Payment preferences specified in a SetUserPreferences call override the settings in My eBay payment preferences. SetUserPreferences No Container consisting of the seller's preferences for displaying items on a buyer's Favorite Sellers' Items page or Favorite Sellers' Items digest. One or more preferences may be set or modified under this field. SetUserPreferences No Container consisting of the seller's preferences for the end-of-auction email sent to the winning bidder. These preferences allow the seller to customize the Email that is sent to buyer at the end of the auction. One or more preferences may be set or modified under this field. These preferences are only applicable for auction listings. SetUserPreferences No Flag that controls whether the shipment's tracking number is sent by Email from the seller to the buyer. false SetUserPreferences No Flag that controls whether the buyer is required to provide a shipping phone number upon checkout. Some shipping carriers require the receiver's phone number. false SetUserPreferences No Container consisting of a seller's Unpaid Item Assistant preferences. The Unpaid Item Assistant automatically opens an Unpaid Item dispute on the behalf of the seller. One or more preferences may be set or modified under this field. SetUserPreferences No http://pages.ebay.com/sell/UPI/upiassistant/index.html Unpaid Item Assistant http://pages.ebay.com/sell/UPI/standardprocess/index.html Understanding the New Unpaid Item Process Container consisting of a seller's preference for sending a purchase reminder email to buyers. SetUserPreferences No A flag used to disable the use of a third-party application to handle the checkout flow for a seller. If set to true, Third-Party Checkout is disabled and any checkout flow initiated on the seller's application is redirected to the eBay checkout flow. false SetUserPreferences No Contains information about a seller's order cut off time preferences for same day shipping. If the seller specifies a value of <code>0</code> in Item.DispatchTimeMax to offer same day handling when listing an item, the seller's shipping time commitment depends on the order cut off time set for the listing site, as indicated by DispatchCutoffTimePreference.CutoffTime. Note: Same day handling is available on the eBay Sandbox for release 817. It will become available on the production site as of Seller Release 13.1. SetUserPreferences No Specifying Shipping Services http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=SameDayHandling details about dispatch cut off times Returned after a call to SetUserPreferences to indicate that the call succeeded. Uploads a picture for a listing and returns a URL for the picture. Introduction to Pictures in Item Listings http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=Pictures Working with Pictures in an Item Listing http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=PictureDetails Including Pictures in the Search Results Gallery http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=Gallery Describing Variations in a Listing http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=VariationPictures A name you provide for the picture. Returned as SiteHostedPictureDetails.PictureName in the call response. UploadSiteHostedPictures No Specifies the picture system version. Only version 2 is valid. Available to support future changes in the picture system version. 2 UploadSiteHostedPictures No The image sizes that will be generated. Standard Large UploadSiteHostedPictures No An optional reference ID to the binary attachment. The PictureData field does not contain the binary attachment. The binary attachment is image data, including headers, from a JPG, GIF, PNG, BMP, or TIF format image file. The binary attachment must be sent as a MIME attachment, in your POST request, after the XML input. Note: Not applicable for eBay Large Merchant Services. Use the ExternalPictureURL field instead. UploadSiteHostedPictures No When the My Picture Uploads feature is available (see the Trading API Release Notes), applications (including non-listing apps, such as photo-editors and digital-camera software) will be able to use the PictureUploadPolicy field to specify that an uploaded picture is available to a seller on the eBay site. When you use PictureUploadPolicy, you are specifying that the picture you uploaded (and its URL) is stored for 48 hours on the eBay site. (If, within 48 hours, the picture is associated with an item, then it persists on the eBay site for the same time length as other pictures uploaded using the UploadSiteHostedPictures call). As a result of the storage on the eBay site, the picture is available to the seller on the My Picture Uploads tab within the Sell Your Item (SYI) pages. A maximum of 25 URLs can be stored. UploadSiteHostedPictures No Include the URL for a picture that you want to include in your listing. You can only include one ExternalPictureURL field per call. Note: If a URI contains spaces, replace them with <code>%20</code>. For example, <code>http://example.com/my image.jpg</code> must be submitted as <code>http://example.com/my%20image.jpg</code> to replace the space in the image file name. This field allows the eBay server to retrieve a picture from a URL on an external web server. Once retrieved, the picture will be copied to eBay Picture Services (EPS), and retained for 90 days, plus the length of your listing duration. Note: The ExternalPictureURL field is required when using eBay Large Merchant Services. 1024 1 UploadSiteHostedPictures Conditionally 1 This is the type of watermark that should be applied to the pictures hosted by the eBay Picture Services. Please note that watermarks are applied only to pictures that are greater than an EPS configured size. The possible values are: None, Both, Icon, or SellerId. UploadSiteHostedPictures No The number of days to extend the expiration date for the specified image, after a listing has ended. This call is restricted to applications that have been granted permission to use it by eBay Developer Technical Support. This call is not needed for active listings - it is meant to be used only when a photo needs to be hosted longer than the normal listing duration. The maximum number of days allowed for this field is 30. 1 30 UploadSiteHostedPictures No Contains information about a picture upload (i.e., information about a picture upload containing a binary attachment of an image). Specifies the picture system version that was used to upload pictures. Only version 2 is valid. UploadSiteHostedPictures Always Contains information about an UploadSiteHostedPictures upload, including the URL of the uploaded picture. UploadSiteHostedPictures Always Validates the user response to a GetChallengeToken botblock challenge.

Validates the user response to a GetChallengeToken botblock challenge.

GetChallengeToken Botblock token that was returned by GetChallengeToken. ValidateChallengeInput Yes User response to a botblock challenge. ValidateChallengeInput Yes Whether the challenge token should remain valid for up to two minutes. false ValidateChallengeInput No Validate the user response to botblock challenge. Indicates whether the token is valid. ValidateChallengeInput Always Requests to enable a test user to sell items in the Sandbox environment. GetUser Value for the feedback score of a user. If no value is passed in the request, or if the value is zero, the feedback score is unchanged. This element is not intended for regularly testing feedback because the feedback value can change after the request. ValidateTestUserRegistration No 0 1000 Value for the date and time that a user's registration begins. ValidateTestUserRegistration No Indicates if a user subscribes to Seller's Assistant. You cannot request to subscribe a user to both Seller's Assistant and Seller's Assistant Pro. You cannot request to unsubscribe a user. ValidateTestUserRegistration No Indicates if a user subscribes to Seller's Assistant Pro. You cannot request to subscribe a user to both Seller's Assistant and Seller's Assistant Pro. You cannot request to unsubscribe a user. ValidateTestUserRegistration No Indicates if a user subscribes to Selling Manager. You cannot request to subscribe a user to both Selling Manager and Selling Manager Pro. You cannot request to unsubscribe a user. ValidateTestUserRegistration No Indicates if a user subscribes to Selling Manager Pro. You cannot request to subscribe a user to both Selling Manager and Selling Manager Pro. You cannot request to unsubscribe a user. ValidateTestUserRegistration No Returned after calling ValidateTestUserRegistrationRequest; confirms a successful call. Reports items that allegedly infringe your copyright, trademark, or other intellectual property rights. You can report one or more items at a time with this call. You must be a member of the Verified Rights Owner (VeRO) Program to use this call.

Reports items that allegedly infringe your copyright, trademark, or other intellectual property rights. You must be a member of the Verified Rights Owner (VeRO) Program to use this call.

GetVeROReasonCodeDetails, GetVeROReportStatus User ID of the VeRO member reporting the items. VeROReportItems Yes Container (packet) for items being reported. You can report the same item more than once in a packet if a different reason code is used each time. VeROReportItems No Contains a packet ID and status for the items reported by the VeRO Program member. A unique packet identifier for the items reported. VeROReportItems Conditionally The processing status of the packet. VeROReportItems Conditionally Enables a seller to test the definition of a new fixed-price listing by submitting the definition to eBay without creating a actual listing. AddFixedPriceItem, VerifyAddItem Listing an Item http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=ListingAnItem Introduction to Pictures in Item Listings http://developer.ebay.com/DevZone/XML/docs/WebHelp/index.htm?context=eBay_XML_API&topic=Pictures Root container holding all values that define a new fixed-price listing. VerifyAddFixedPriceItem Yes Returns the listing recommendations (if applicable), the estimated fees for the proposed new listing (except the Final Value Fee, which isn't calculated until the item has sold), and other details. Represents the item ID for the new fixed-price listing. VerifyAddFixedPriceItem does not actually list an item, so 0 is returned instead of a normal item ID. 19 (Note: The eBay database specifies 38. Currently, Item IDs are usually 9 to 12 digits) VerifyAddFixedPriceItem Always Item-level SKU for the new listing, if the seller specified tem.SKU in the request. Variation SKUs are not returned (see GetItem instead). AddFixedPriceItem Conditionally Child elements contain the estimated listing fees for the new item listing. The fees do not include the Final Value Fee (FVF), which cannot be determined until an item is sold. VerifyAddFixedPriceItem Alwa