List an item

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 allows a seller to create and publish a fixed-price listing. 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 multiple-variation listings and tracking inventory by a seller-defined SKU value. AddItem does not support Variations or the InventoryTrackingMethod field.

Defines and publishes a single or multiple-variation fixed-price listing.

AddItem, AddItems, VerifyAddFixedPriceItem List an item https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/list-item.html Create item listings https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/create-listing.html Add pictures https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/pictures.html Multiple-variation listings https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/variations.html This container is used to specify all of the values and settings that define a new fixed-price listing. AddFixedPriceItem Yes If the new listing is created successfully, the AddFixedPriceItem response includes the unique identifier of the new listing (ItemID) and the estimated values of any fees (such as insertion fee and any other listing upgrade fees) generated as a result of the listing being created. Other response fields include the the start and end times of the listing, and any other applicable fields such as the product SKU (if defined by seller), listing recommendations (if applicable), or other details. Unique identifier for the new fixed-price listing. This field is returned as long as the listing was successfully created. AddFixedPriceItem Always The SKU value for an item is returned if the seller specified a SKU value through the Item.SKU field in the request. In the case of a multiple-variation listing, variation-level SKU values are not returned in the response. To get this data, a GetItem call would have to be made by the seller. 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 included the Item.ScheduleTime field in the request and set a custom start time of the listing (in the future). AddFixedPriceItem Always Date and time when the new listing is scheduled to end based on the start time and the listing duration value that was set in the ListingDuration field at listing time. If the value of ListingDuration was set to <code>GTC</code> (Good 'Til Cancelled) this value will be set one month ahead of the start time, and this value will continue to be updated one month ahead each time the GTC listing needs to be renewed. Fixed-price listings get renewed automatically as long as there is still a quantity of <code>1</code> or above, or even if the quantity is <code>0</code>, but the 'out-of-stock control' feature is enabled. AddFixedPriceItem Conditionally This container is an array of fees associated with the creation of the listing. The fees in this container will not include any fees that are based on the purchase price (such as transaction fees) and only come into play when the listing has a sale. All listing fee types are returned, even if those fees are not applicable for the new listing and are '0.0'. Note: The currency used for all fees returned under the Fees container reflects the currency used for the listing site, and not necessarily in the seller's default/home currency. For example, if a Canadian seller is using the AddFixedPriceItem call to list an item on the eBay US site, the currency type shown for each fee will be <code>USD</code> and not <code>CAD</code>. eBay.com Fees http://pages.ebay.com/help/sell/fees.html AddFixedPriceItem Always Fees by marketplace https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/fees-by-marketplace.html The unique identifier of the primary category in which the item was listed. This field is only returned if the Item.CategoryMappingAllowed boolean field is set to <code>true</code> in the request (or omitted) and the Category ID passed in as the primary listing category was automatically mapped to a new Category ID by eBay. If the primary category ID passed in the request is still active/valid, this field is not returned. 10 AddFixedPriceItem Conditionally Unique identifier of the secondary category in which the item was listed. This field is only returned if the Item.CategoryMappingAllowed boolean field is set to <code>true</code> in the request (or omitted) and the Category ID passed in as the secondary listing category was automatically mapped to a new Category ID by eBay. If the secondary category ID passed in the request is still active/valid, this field is not returned. 10 AddFixedPriceItem Conditionally This container is an array of one or more listing fee/upgrade discount types being offered by eBay to the seller. AddFixedPriceItem Conditionally This container holds an array of one or more products in the eBay product catalog that appear to match the product being listed, just based on the information in the listing. This container will not be returned if no similar products were found in the eBay product catalog. AddFixedPriceItem Conditionally Base request type for the AddItem call, which is used to create a fixed-price, auction, or classified ad listing. The AddItem call does not support multiple-variation listings, so the AddFixedPriceItem call must be used to create multiple-variation listings.

Creates a fixed-price, auction, or classified ad listing.

AddFixedPriceItem, AddItems, VerifyAddItem List an item https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/list-item.html Create item listings https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/create-listing.html Add pictures https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/pictures.html This container is used to specify all of the values and settings that define a new listing. AddItem Yes If the new listing is created successfully, the AddItem response includes the unique identifier of the new listing (ItemID) and the estimated values of any fees (such as insertion fee and any other listing upgrade fees) generated as a result of the listing being created. Other response fields include the the start and end times of the listing, and any other applicable fields such as the product SKU (if defined by seller), listing recommendations (if applicable), or other details. Unique identifier for the new listing. This field is returned as long as the listing was successfully created. AddItem Always 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 included the Item.ScheduleTime field in the request and set a custom start time of the listing (in the future). AddItem Always Date and time when the new listing is scheduled to end based on the start time and the listing duration value that was set in the ListingDuration field at listing time. If the value of ListingDuration was set to <code>GTC</code> (Good 'Til Cancelled) this value will be set one month ahead of the start time, and this value will continue to be updated one month ahead each time the GTC listing needs to be renewed. Fixed-price listings get renewed automatically as long as there is still a quantity of <code>1</code> or above, or even if the quantity is <code>0</code>, but the 'out-of-stock control' feature is enabled. Note that <code>GTC</code> is not a supported listing duration for auction listings, but is the only supported listing duration for fixed-price listings except for a few motor vehicle categories on eBay Motors US, eBay UK, and eBay Italy AddItem Always This container is an array of fees associated with the creation of the listing. The fees in this container will not include any fees that are based on the purchase price (such as transaction fees) and only come into play when the listing has a sale. All listing fee types are returned, even if those fees are not applicable for the new listing and are '0.0'. Note: The currency used for all fees returned under the Fees container reflects the currency used for the listing site, and not necessarily in the seller's default/home currency. For example, if a Canadian seller is using the AddItem call to list an item on the eBay US site, the currency type shown for each fee will be <code>USD</code> and not <code>CAD</code>. AddItem Always eBay.com Selling Fees https://www.ebay.com/help/selling/fees-credits-invoices/selling-fees?id=4822 Fees by marketplace https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/fees-by-marketplace.html The unique identifier of the primary category in which the item was listed. This field is only returned if the Item.CategoryMappingAllowed boolean field is set to <code>true</code> in the request (or omitted) and the Category ID passed in as the primary listing category was automatically mapped to a new Category ID by eBay. If the primary category ID passed in the request is still active/valid, this field is not returned. 10 AddItem Conditionally Unique identifier of the secondary category in which the item was listed. This field is only returned if the Item.CategoryMappingAllowed boolean field is set to <code>true</code> in the request (or omitted) and the Category ID passed in as the secondary listing category was automatically mapped to a new Category ID by eBay. If the secondary category ID passed in the request is still active/valid, this field is not returned. 10 AddItem Conditionally This container is an array of one or more listing fee/upgrade discount types being offered by eBay to the seller. AddItem Conditionally This container holds an array of one or more products in the eBay product catalog that appear to match the product being listed, just based on the information in the listing. This container will not be returned if no similar products were found in the eBay product catalog. AddItem Conditionally Base request type for the AddItems call, which is used to create one to five fixed-price, auction, or classified ad listings. The AddItems call does not support multiple-variation listings, so multiple-variation listings cannot be created with this call. AddItem, VerifyAddItem List an item https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/list-item.html Create item listings https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/create-listing.html Add pictures https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/pictures.html An AddItemRequestContainer container is required for each listing that will be created with the AddItems request. Up to five of these 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 was 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 Unique identifier for the listing that is being discussed between the two order partners. AddMemberMessageAAQToPartner Yes This container holds the message, and includes the subject, message body, and other details related to the message. AddMemberMessageAAQToPartner Yes This type defines the response to the AddMemberMessageAAQToPartner call. There are no call-specific fields in this response. The base request of the AddMemberMessageRTQ call that enables a seller to reply to a question about an active item listing.

Enables a seller to reply to a question about an active item listing.

AddMemberMessagesAAQToBidder, AddMemberMessageAAQToPartner The unique identifier of the listing about which the question was asked. This field is not required if the request includes a RecipientID value in the MemberMessage container, and the bidder/potential buyer and seller do not have more than one listing in common between one another. AddMemberMessageRTQ No This container is used by the seller to answer the question from the bidder/potential buyer. This container includes the recipient ID of the bidder/potential buyer, the message subject, the message body (where the question is answered), and other values related to the message. AddMemberMessageRTQ Yes This type defines the response to the AddMemberMessageRTQ call. There are no call-specific fields in this response. The base request of the AddMemberMessagesAAQToBidder call, which allows a seller to send up to 10 messages to bidders/potential buyers regarding an active listing. These potential buyers may include those who have made a Best Offer on a listing.

Enables a seller to send up to 10 messages to bidders/potential buyers regarding an active listing.

AddMemberMessageAAQToPartner, AddMemberMessageRTQ An AddMemberMessagesAAQToBidderRequestContainer container is required for each message being sent to unique bidders/potential buyers. A seller can send up to 10 messages to unique bidders/potential buyers in one AddMemberMessagesAAQToBidder call. 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 The AddOrder call can be used by a seller to combine two or more unpaid, single line item orders from the same buyer into one 'Combined Invoice' order with multiple line items. Once multiple line items are combined into one order, the buyer can make one single payment for multiple line item order. If possible and agreed to, the seller can then ship multiple line items in the same shipping package, saving on shipping costs, and possibly passing that savings down to the buyer through Combined Shipping Discount rules set up in My eBay.

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.

https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manage-fulfill-orders.html Manage and fulfill orders https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manage-fulfill-combine-invoices.html Combined invoice The root container of the AddOrder request. In this call, the seller identifies two or more unpaid 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 This type defines the response of an AddOrder call. If the multiple line items are successfully combined into a single order, this response includes the unique identifier of this 'Combined Invoice' order (automatically generated by eBay), and a timestamp indicating when the new order was created. The unique identifier of the successfully-created 'Combined Invoice' order. This value is only created and returned if the AddOrder call is successful in creating the new order. This value can be used as an input filter in GetOrders calls to retrieve the 'Combined Invoice' order. Note: This unique identifier is not the same as the OrderID that is generated after payment. 40 AddOrder Always https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manage-fulfill-combine-invoices.html Combined Invoice Timestamp that indicates the date and time that the 'Combined Invoice' order was created. AddOrder Always https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manage-fulfill-combine-invoices.html Combined Invoice Used by the seller of an auction listing to provide a Second Chance Offer to one of that auction item's non-winning bidders. A Second Chance Offer is used by sellers whenever the seller was unable to complete the sale with the winning bidder because the bidder didn't pay, or if the auction listing ended without the Reserve Price being met, or if that seller has multiple identical items for sale and wants to give other bidders a chance to purchase the item. To get information on the bidders for a recently-ended auction listing, the seller can use the GetAllBidders call and pass the corresponding ItemID value into the call request. For more information on the specifics of Second Chance Offers, see the <a href="https://pages.ebay.com/help/sell/second_chance_offer.html" target="_blank">Making a Second Chance Offer</a> help page. VerifyAddSecondChanceItem Second chance offers https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/second-chance.html This field is used to specify the bidder that is being offered the Second Chance Offer. The eBay User ID of the bidder is used in this field. Specify only one RecipientBidderUserID per call. If multiple users are specified, only the last one specified receives the offer. User ID values will be returned in the Offer.User.UserID field of the GetAllBidders call response. Note: Effective September 26, 2025, both usernames and public user IDs will be accepted in this field. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. AddSecondChanceItem Yes The amount the offer recipient must pay to purchase the item as a Second Chance Offer. This field should only be used 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. The price offered to the Second Chance Offer recipient is generally the highest bid that the user made on the original listing. AddSecondChanceItem No This enumeration value indicates the length of time (in days) that the Second Chance Offer will be available to the recipient. Upon receiving the Second Chance Offer, the recipient bidder will have this many days to accept the offer before the offer expires. One of the values in SecondChanceOfferDurationCodeType must be used. AddSecondChanceItem Yes This field is used to identify the original auction listing through its unique identifier (Item ID). Upon a successful call, the Second Chance Offer will be identified by a new ItemID in the response. AddSecondChanceItem Yes This optional field is used to provide a message to the recipient of the Second Chance Offer. This message cannot contain HTML, asterisks, or quotes. The content in this field will be included in the Second Chance Offer email that is sent to the recipient. 1000 AddSecondChanceItem No Type defining the response container of an AddSecondChanceItem call. This response container consists of the ItemID of the listing in which a Second Chance Offer is being offered, as well as the start and end time that the Second Chance Offer is available to the recipient (identified through the RecipientBidderUserID in the request). This field contains the Item ID for the Second Chance Offer that was just created with the AddSecondChanceItem call. Note that this Item ID will be different from the Item ID in the original auction listing that was passed in the request. AddSecondChanceItem Always This timestamp indicates the date and time when the Second Chance Offer became available to the recipient. AddSecondChanceItem Always This timestamp indicates the date and time when the Second Chance Offer listing will expire, at which time the recipient will no longer be able to purchase the item. AddSecondChanceItem Always The base request of the AddToItemDescription call, which is used to add additional text to an active listing's item description. Upon a successful call, the text supplied in this call will be inserted into the active listing, with a horizontal rule separating the original item description and the additional text that was added with this call.

Adds additional text to an active listing's item description.

Revise a listing https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/revise-listing.html ReviseItem, ReviseFixedPriceItem This field is used to identify the active listing that will be updated with additional text in the item description field. The Item ID is a unique identifier for a listing. AddToItemDescription Yes This field is used to specify the text that will be appended to the end of the active listing's item description. The text provided in this field must abide by the same rules/restrictions applicable to the original item description supplied at listing time. For more information on these rules and restrictions, see the <a href="https://developer.ebay.com/Devzone/XML/docs/Reference/ebay/types/ItemType.html#Description">Description field of ItemType</a>. AddToItemDescription Yes This type defines the response of the AddToItemDescription call. There are no call-specific fields in this response. The seller should look for an Ack value of <code>true</code> in the response, that will indicate that the additional text in the item description was added successfully. Adds one or more order line items to the eBay user's Watch List. An auction item or a single-variation, fixed-price listing is identified with an ItemID value. To add a specific item variation to the Watch List from within a multi-variation, fixed-price listing, the user will use the VariationKey container instead. The unique identifier of the single-variation listing that is to be added to the eBay user's Watch List. The item must be a currently active item, and the total number of items in the user's Watch List (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 was not successfully added to the Watch List. The user must use either one or more ItemID values or one or more VariationKey containers, but the user may not use both of these entities in the same call. AddToWatchList Conditionally This container is used to specify one or more item variations in a multi-variation, fixed-price listing that you want to add to the Watch List. The listing is identified through the ItemID value and each item variation existing within that listing is identified through a VariationSpecifics.NameValueList container. The user must use either one or more ItemID values or one or more VariationKey containers, but the user may not use both of these entities in the same call. AddToWatchList Conditionally This type defines the response of the AddToWatchList call. Along with data indicating the success or failure of adding one or more items to a user's Watch List, this response also includes the number of items currently in the user's Watch List and the maximum number of items allowed in the Watch List. This integer value indicates the total number of items in the user's Watch List (after those specified in the call request have been successfully added). AddToWatchList Always This integer value indicates the maximum number of items allowed in a user's Watch List. The maximum number of items that can be added to a Watch List is 400, but this can vary by eBay marketplace. AddToWatchList Always Enables a seller to perform various tasks with a single or multiple line item order. Tasks available with this call include marking the order as paid, marking the order as shipped, providing shipment tracking details to the buyer, and leaving feedback for the buyer. Unique identifier for an eBay listing. An ItemID value can be paired up with a corresponding TransactionID value in a CompleteSale request to identify a single order line item. Alternatively, the OrderLineItemID value for the order line item can be used. Unless an OrderLineItemID value is used to identify a single order line item, or the OrderID value is used to identify a single or multiple line item order, the ItemID/TransactionID pair must be specified. To perform an action on an entire multiple line item order, the OrderID field must be used. If an OrderID or OrderLineItemID value is specified, an ItemID/TransactionID pair will be ignored (if present in the same request). CompleteSale Conditionally Unique identifier for a sales transaction. A TransactionID identifier is created once there is a commitment to buy (bidder wins the auction, buyer clicks buy button, or buyer purchases item through PlaceOffer call). The TransactionID can be paired up with the corresponding ItemID value in a CompleteSale request to identify a single order line item. Alternatively, the OrderLineItemID value for the order line item can be used. Unless an OrderLineItemID value is used to identify a single order line item, or the OrderID value is used to identify a single or multiple line item order, the ItemID/TransactionID pair must be specified. To perform an action on an entire multiple line item order, the OrderID field must be used. If an OrderID or OrderLineItemID value is specified, an ItemID/TransactionID pair will be ignored (if present in the same request). The TransactionID value for auction listings is always <code>0</code> since there can be only one winning bidder/one sale for an auction listing. Note: Historically, TransactionID values have been '0' for auction listings, and some developers may have built logic around this. However, non-zero TransactionID values for auction listings started being used for some eBay marketplaces beginning in July 2024, and all eBay marketplaces are expected to start using non-zero TransactionID values for auction listings in the near future. If necessary, developers should update code to handle non-zero transaction IDs for auction transactions. 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. Note: Feedback entries are submitted at the order line item level, so either an OrderLineItemID value or an ItemID/TransactionID pair should be specified to identify the order line item (and not an OrderLineItemID value). To leave Feedback for all line items in a multiple line item order, the seller would need a separate CompleteSale request for each order line item. CompleteSale No The seller includes and sets this field to true if the order or order line item 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 or order line item are marked (or remain) as 'Not Shipped' in eBay's system. If this field is not included, the shipped status of the order or order line item remain unchanged in My eBay. If shipment tracking information is provided for an order or order line item through the Shipment container in the same request, the Shipped status is set to <code>true</code> automatically, and the Shipped field is not necessary. CompleteSale No The seller includes and sets this field to <code>true</code> to mark an unpaid order as paid. If the call is successful, the order line item(s) are marked as 'Paid' in eBay's system. Note: The seller is not allowed to set this field to <code>false</code>. CompleteSale No Note: DO NOT USE THIS FIELD. Previously, this field's only purpose was to classify the order to be updated as a Half.com order. However, since the Half.com site has been shut down, this field is no longer applicable. 1027 NoOp 1033 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 order line item as shipped and the Shipped field is not necessary. If you supply ShipmentTrackingNumber, you must also supply ShippingCarrierUsed; otherwise you will get an error. To modify the shipping tracking number and/or shipping carrier, supply the new number in the ShipmentTrackingNumber field 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 95 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 for an eBay order. This field can be used to make an 'order-level' update. If an order has multiple line items, and the CompleteSale call is being used to update the status of, or provide feedback for a single line item within the order, the OrderLineItemID field or ItemID/TransactionID pair must be used to identify this order line item instead of the OrderID field. If the order only has one line item, it the OrderID field can be used to make any updates with the CompleteSale call. OrderID overrides an OrderLineItemID or ItemID/TransactionID pair if these fields are also specified in the same request. Note: Note that the unique identifier of a 'non-immediate payment' order will change as it goes from an unpaid order to a paid order. Due to this scenario, all calls that accept Order ID values as request filters/parameters, including the CompleteSale call, will support the identifiers for both unpaid and paid orders. 40 CompleteSale No A unique identifier for an eBay order line item. OrderLineItemID values are returned (at the order line item level) in Trading API's order management calls. This identifier is created once there is a commitment to buy (bidder wins the auction, buyer clicks buy button, or buyer purchases item through PlaceOffer call). An OrderLineItemID value can be used in a CompleteSale request to identify a line item within an order. Alternatively, an ItemID/TransactionID pair can also be used to identify a line item. Unless an ItemID/TransactionID pair is used to identify an order line item, or an OrderID value is used to identify an order, the OrderLineItemID must be specified. If OrderLineItemID is specified, the ItemID/TransactionID pair are ignored if present in the same request. CompleteSale No This type defines the response of the CompleteSale call. There are no call-specific fields in this response, but the seller should look for an Ack value of <code>true</code> in the response, as this value will indicate that the action(s) in the CompleteSale call were successful. If any other Ack value besides <code>true</code> is returned, the seller should look for any returned error messages or warnings. Returns the ID of a user who has gone through an application's consent flow process for obtaining an authorization token. Working with token/authentication calls https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/token-auth-calls.html 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. Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. ConfirmIdentity Always Removes selected messages for a given user. Contains a list of up to 10 MessageID values. DeleteMyMessages No The response to DeleteMyMessages. If the request is successful, DeleteMyMessages has an empty payload. Ends the specified fixed-price listing before the date and time at which it would normally end (per the listing duration). EndItem, EndItems End a listing early https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/end-early.html Unique identifier of the listing that you want to end. In the EndFixedPriceItem request, either ItemID or SKU value is required. If both are passed in and they don't refer to the same listing, eBay ignores SKU and considers only the ItemID. EndFixedPriceItem Conditionally The seller's reason for ending the listing early is input into this required field. The seller is not allowed to use the <code>ProductDeleted</code> value, as this ending reason can only be used internally by eBay to administratively end a listing due to the associated Catalog product being removed from the eBay Catalog. ProductDeleted EndFixedPriceItem Yes The seller-defined SKU (stock keeping unit) value of the item in the listing being ended. The SKU field can only be used to end a listing if that listing was created or relisted with an AddFixedPriceItem or RelistFixedPriceItem call, and the Item.InventoryTrackingMethod was included in the call and set to <code>SKU</code>. 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. 50 EndFixedPriceItem Conditionally Acknowledgement that includes SKU, as well as the date and time that the listing ended due to the call to EndFixedPriceItem. Timestamp that indicates the date and time (GMT) that the specified listing was ended. EndFixedPriceItem Always If a SKU (stock-keeping unit) exists for the item in the listing, it is returned in the response. 50 EndFixedPriceItem Conditionally Ends the specified item listing before the date and time at which it would normally end per the listing duration. EndFixedPriceItem, EndItems End a listing early https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/end-early.html Unique item ID that identifies the listing that you want to end. EndItem Yes The seller's reason for ending the listing early is input into this required field. The seller is not allowed to use the <code>ProductDeleted</code> value, as this ending reason can only be used internally by eBay to administratively end a listing due to the associated Catalog product being removed from the eBay Catalog. EndItem Yes ProductDeleted This type includes the acknowledgement of the date and time when the eBay listing was ended due to the call to EndItem. This timestamp indicates the date and time (returned in GMT) when the specified eBay listing was ended. EndItem Always The EndItems call is used to end up to 10 specified eBay listings before the date and time at which those listings would normally end per the listing duration. EndItem, EndFixedPriceItem End a listing early https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/end-early.html An EndItemRequestContainer container is required for each eBay listing that the seller plans to end through the EndItems call. Up to 10 eBay listings can be ended with one EndItems call. 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 Retrieves an authentication token for a user. Working with token/authentication calls https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/token-auth-calls.html 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 Working with token/authentication calls https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/token-auth-calls.html 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. Account Information https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/user-mgmt-account-info.htmll Testing Applications https://developer.ebay.com/develop/tools/sandbox Specifies the report format in which to return account entries. LastInvoice GetAccount Conditionally Since <code>SpecifiedInvoice</code> is no longer supported, this field is no longer applicable and should not be used. If this field is included, it will be ignored. This field is used to retrieve all account entries dating back to the timestamp passed into this BeginDate field up until the timestamp passed into the EndDate field. The BeginDate value can not be set back any further than four months into the past. The allowed date formats are YYYY-MM-DD and YYYY-MM-DD HH:mm:ss The BeginDate value must be less than or equal to the EndDate value. The user might use the same values in both fields if that user wanted to retrieve all account entries from a specific day (if YYYY-MM-DD format used) or wanted to retrieve a specific account entry (if YYYY-MM-DD HH:mm:ss format used). This field is only applicable if the AccountHistorySelection value is set to 'BetweenSpecifiedDates'; otherwise, this field will be ignored. fiedDates' is used, both the BeginDate and EndDate must be included. GetAccount Conditionally This field is used to retrieve all account entries dating up to the timestamp passed into this EndDate field dating back to the timestamp passed into the BeginDate field. The EndDate value can not be set for a future date. The allowed date formats are YYYY-MM-DD and YYYY-MM-DD HH:mm:ss The EndDate value must be more than or equal to the BeginDate value. The user might use the same values in both fields if that user wanted to retrieve all account entries from a specific day (if YYYY-MM-DD format used) or wanted to retrieve a specific account entry (if YYYY-MM-DD HH:mm:ss format used). This field is only applicable if the AccountHistorySelection value is set to 'BetweenSpecifiedDates'; otherwise, this field will be ignored. If 'BetweenSpecifiedDates' is used, both the BeginDate and EndDate must be included. GetAccount Conditionally This container is used to control how many account entries are returned on each page of data in the response. PaginationType is used by numerous Trading API calls, and the default and maximum values for the EntriesPerPage field differs with each call. For the GetAccount call, the default value is 500 (account entries) per page, and maximum allowed value is 2000 (account entries) per page. GetAccount No By default, the current balance of the user's account will not be returned in the call response. To retrieve the current balance of their account, the user should include the ExcludeBalance flag in the request and set its value to 'false'. The current balance on the account will be shown in the AccountSummary.CurrentBalance field in the call 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 Include this field and set it to <code>true</code> to retrieve the total net amount of all charges/fees that have been deducted from seller payouts instead of being invoiced to the seller. The total net amount of any seller credits related to these fees is also shown. These fees and credit amounts will be shown in the AccountSummary.NettedTransactionSummary container in the response. 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 The unique identifier of an eBay order. This field must be included if the value of the AccountHistorySelection filter is set to <code>OrderId</code>. A user can filter by order ID to see if there are specific account entries related to a specific eBay order. It is possible that no account entries will be found directly related to the specified order ID, and if this is the case, no AccountEntries container will be returned, and the ack value will still be <code>Success</code>. Note: Note that the unique identifier of a 'non-immediate payment' order will change as it goes from an unpaid order to a paid order. Due to this scenario, all calls that accept Order ID values as request filters/parameters, including the GetAccount call, will support the identifiers for both unpaid and paid orders. Sellers can check to see if an order has been paid by looking for a value of 'Complete' in the CheckoutStatus.Status field in the response of GetOrders call, or in the Status.CompleteStatus field in the response of GetItemTransactions or GetSellerTransactions call. Sellers should not fulfill orders until buyer has made payment. GetAccount Conditionally Returns information about an eBay seller's own account. Specifies the seller's unique account number. GetAccount Always This enumeration value indicates the current status of the seller's account for the fee netting mechanism. If the <code>Enabled</code> value is returned, the seller may include the IncludeNettedEntries field in the request to retrieve the total net amount of all charges/fees that have been deducted from seller payouts instead of being invoiced to the seller. The total net amount of any seller credits related to these fees is also shown in the AccountSummary.NettedTransactionSummary container in the response. 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 This container holds an array of account entries. The account entries that are returned are dependent on the selection that the user made in the AccountHistorySelection field in the call request. Each AccountEntry container consists of one credit, one debit, or one administrative action on the account. It is possible that no AccountEntry containers will be returned if no account entries exist since the last invoice (if <code>LastInvoice</code> value is used), between the specified dates (if <code>BetweenSpecifiedDates</code> value is used), or no entries exist for an order (if <code>OrderId</code> value is used). GetAccount Conditionally This container shows the total number of account entries and the total number of account entry pages that exist based on the filters used in the GetAccount call request. The total number of account entry pages is partly controlled by the Pagination.EntriesPerPage value that is set in the request. GetAccount Always If this boolean value is returned as 'true', there are more account entries to view on one or more pages of data. To view additional entries, the user would have to make additional GetAccount calls and increment the value of the Pagination.PageNumber field by '1' to view additional pages of account entries. GetAccount Conditionally This integer value indicates the number of account entries that are being returned per virtual page of data. This value will be the same value passed into the Pagination.EntriesPerPage field in the request. GetAccount Always This integer value indicates the current page number of account entries that is currently being shown. This value will be the same value passed into the Pagination.PageNumber field in the request. 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. 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 This is the base request type for the GetAllBidders call, which is used to retrieve bidders from an active or recently-ended auction listing.

This call is used to retrieve bidders from an active or recently-ended auction listing.

Second change offers https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/second-chance.html This is the unique identifier of the auction listing for which bidders are being retrieved. This auction listing can be active or recently ended. However, to retrieve bidders for an active auction listing, the only CallMode enumeration value that can be used is <code>ViewAll</code>. GetAllBidders Yes The enumeration value that is passed into this field will control the set of bidders that will be retrieved in the response. To retrieve bidders from a recently-ended auction listing, any of the three values can be used. To retrieve bidders for an active auction listing, only the <code>ViewAll</code> enumeration value can be used. These values are discussed in GetAllBiddersModeCodeType. EndedListing GetAllBidders No The user must include this field and set its value to <code>true</code> if the user wishes to retrieve the BiddingSummary container for each bidder. The BiddingSummary container consists of more detailed bidding information on each bidder. GetAllBidders Conditionally Includes detailed bidding data for the auction listing that was specified in the request. Unless the listing is private, the actual eBay user IDs of all bidders are returned if the listing's seller makes this API call. If a bidder makes this API call, only that bidder's eBay user ID is returned, and the rest of the bidder's user IDs are anonymized. Anonymous user information https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/user-mgmt-anonymous-info.htmll This container consists of an array of bids made on the specified auction listing. Each OfferType object represents the data for one bid. GetAllBidders Always The eBay user ID for the user with the winning bid (if auction has ended) or current highest bid (if auction is still active). The seller should take note of or save this User ID as this user may be a a Second Chance Offer candidate. Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetAllBidders Always This is the dollar amount of the winning bid (if auction has ended) or dollar amount of the current highest bid (if auction is still active). GetAllBidders Always This enumeration value indicates the listing status of the specified listing. GetAllBidders Always This is the base request type of the GetBestOffers call. Depending on the input parameters that are used, this call can be used by a seller to retrieve all active Best Offers, all Best Offers on a specific listing, a specific Best Offer for a specific listing, or Best Offers in a specific state. Note: The Best Offer feature is now available for auction listings on the following sites: US, Canada, UK, Germany, Australia, France, Italy, and Spain. However, sellers must choose between offering Best Offer or Buy It Now on an auction listing, as both features cannot be enabled on the same auction listing.

This call can be used by a seller to retrieve all active Best Offers, all Best Offers on a specific listing, a specific Best Offer for a specific listing, or Best Offers in a specific state.

DetailLevel Best Offer https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/best-offers.html User information https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/user-mgmt-user-info.htmll The unique identifier of an eBay listing. If an ItemID is used by itself in the call request, all Best Offers in all states are retrieved for this listing. However, the seller can also combine ItemID and a BestOfferStatus value if that seller only wants to see Best Offers in a specific state. If a BestOfferID field is included in the call request, any ItemID value will be ignored since eBay will only search for and return the Best Offer identified in the BestOfferID field. GetBestOffers No The unique identifier of a Best Offer. An identifier for a Best Offer is automatically created by eBay once a prospective buyer makes a Best Offer on a Best Offer-enabled listing. If a BestOfferID value is supplied in the call request, any ItemID or BestOfferStatus values will be ignored. Only the Best Offer identified by the BestOfferID value will be returned. GetBestOffers No This field can be used if the seller wants to retrieve Best Offers in a specific state. The typical use case for this field is when the seller wants to retrieve Best Offers in all states for a specific listing. In fact, the All value can only be used if an ItemID value is also supplied in the call request. If a BestOfferID field is included in the call request, any BestOfferStatus value will be ignored since eBay will only search for and return the Best Offer identified in the BestOfferID field. Active GetBestOffers All, Active No This container can be used if the seller is expecting that the GetBestOffers call will retrieve a large number of results, so that seller wishes to view just a subset (one page of multiple pages) of those results at a time. See this container's child fields for more information on how pagination is used. 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 <code>ReturnAll</code> detail level is used. Only returned if Best Offers have been made. GetBestOffers

DetailLevel: none, ReturnAll

Conditionally This container consists of several details about the listing for which a Best Offer has been made, including the Item ID, the current price of the item (not the Best Offer price), and the time that the listing is scheduled to end. 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 This integer value indicates the current page number of Best Offers that is currently being shown. This value will be the same value passed into the Pagination.PageNumber field in the request. 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 that the user is currently bidding on, and the ones they have won or purchased. GetMyeBayBuying Retrieves all items that 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 <code>true</code>, only active items are returned and the EndTimeFrom and EndTimeTo filters are ignored. If <code>false</code> (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 <code>YYYY-MM-DD HH:MM:SS</code>, and in GMT. This field is ignored if ActiveItemsOnly is set to <code>true</code>. 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 <code>YYYY-MM-DD HH:MM:SS</code>, and in GMT. This field is ignored if ActiveItemsOnly is set to <code>true</code>. Note that for GTC items, whose end times automatically increment by 30 days every 30 days, an EndTimeTo value within the first 30 days of a listing will refer to the listing's initial end time. Note: Starting July 1, 2019, the Good 'Til Cancelled renewal schedule will be modified from every 30 days to once per calendar month. For example, if a GTC listing is created July 5, the next monthly renewal date will be August 5. If a GTC listing is created on the 31st of the month, but the following month only has 30 days, the renewal will happen on the 30th in the following month. Finally, if a GTC listing is created on January 29-31, the renewal will happen on February 28th (or 29th during a 'Leap Year'). See the <a href="https://pages.ebay.com/seller-center/seller-updates/2019-spring/marketplace-updates.html#good-til-cancelled" target="_blank">Good 'Til Cancelled listings update</a> in the Spring 2019 Seller Updates for more information about this change. GetBidderList Conditionally The unique identifier of an eBay user. This field is generally not required unless there are multiple User IDs tied to the requester credentials that are specified through the RequesterCredentials header. If there are multiple User IDs tied to the requester credentials, this field allows you to specify the User ID for which you wish to retrieves bids and purchases. Note: Effective September 26, 2025, both usernames and public user IDs will be accepted in this field. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetBidderList Conditionally You can control some of the fields returned in the response by specifying one of two values in the GranularityLevel field: <code>Fine</code> or <code>Medium</code>. <code>Fine</code> returns more fields than the default, while setting this field to <code>Medium</code> 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 Returns information about the features that are applicable to different categories, such as listing durations, shipping term requirements, and Best Offer support. DetailLevel Categories https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/categories.html 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. GetCategoryFeatures No This field is used if the user wants to control the maximum depth of the category hierarchy to retrieve, or in other words, how many levels of eBay categories that are returned in the response. If this field is omitted, and no CategoryID is specified, eBay feature metadata for every eBay category from the root on down will be returned. If this field is omitted, but a CategoryID is specified, the specified category and all of its children (down to the leaf categories) are returned. If the CategoryID field is not used, but the LevelLimit field is used and set to <code>1</code>, eBay feature metadata is only returned for the top-level categories (also known as L1 categories). GetCategoryFeatures No You must set DetailLevel to <code>ReturnAll</code> 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 <code>ReturnAll</code>, 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. ItemSpecificsEnabled GetCategoryFeatures No All feature metadata returned if no FeatureID values are used 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 Listing Designer templates that are available for use by the seller. Note: As of May 31, 2020, sellers are no longer able to use Listing Designer templates when they create or revise listings. Existing listings that are already using a Listing Designer template will remain unchanged. The GetDescriptionTemplates call will eventually get deprecated and decommissioned, and more information will be provided on timing at a later date. The GetDescriptionTemplates call will still retrieve Listing Designer template data, but none of retrieved templates will be usable to create or revise a listing. This is the base request type for the GetDescriptionTemplates call. This call retrieves detailed information on the Listing Designer templates that are available for use by the seller.

This call retrieves detailed information on the Listing Designer templates that are available for use by the seller.

Using Description Templates https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide-landing.html A CategoryID value can be specified if the seller would like to only see the Listing Designer templates that are available for that eBay category. This field will be ignored if the MotorVehicles boolean field is also included in the call request and set to <code>true</code>. 10 GetDescriptionTemplates No This dateTime filter can be included and used if the user only wants to check for recently-added Listing Designer templates. If this filter is used, only the Listing Designer templates that have been added/modified after the specified timestamp will be returned in the response. Typically, you will pass in the timestamp value that was returned the last time you refreshed the list of Listing Designer templates. GetDescriptionTemplates No This boolean field should be included and set to <code>true</code> if the user would only like to see the Listing Designer templates that are available for motor vehicle categories. This field will override any CategoryID value that is specified in the call request. Note: Motor vehicle-related Listing Designer templates are only available for eBay Motors on the US and Canada (English) marketplaces. To retrieve eBay US Motors Listing Designer templates, the SITEID HTTP header value must be set to <code>100</code>, which is the identifier of the eBay US Motors vertical (ebay.com/motors). false GetDescriptionTemplates No Retrieves detailed information on Listing Designer templates that are available for use by the seller. Note: As of May 31, 2020, sellers are no longer able to use Listing Designer templates when they create or revise listings. Existing listings that are already using a Listing Designer template will remain unchanged. The GetDescriptionTemplates call will eventually get deprecated and decommissioned, and more information will be provided on timing at a later date. The GetDescriptionTemplates call will still retrieve Listing Designer template data, but none of retrieved templates will be usable to create or revise a listing. This is the base response type for the GetDescriptionTemplates call. This call retrieves the Listing Designer templates that are available for use by the seller. The user has the option of retrieving all available Listing Designer templates for all categories, for all motor vehicle categories, or for a specific eBay category. Note: As of May 31, 2020, sellers are no longer able to use Listing Designer templates when they create or revise listings. Existing listings that are already using a Listing Designer template will remain unchanged. The GetDescriptionTemplates call will eventually get deprecated and decommissioned, and more information will be provided on timing at a later date. The GetDescriptionTemplates call will still retrieve Listing Designer template data, but none of retrieved templates will be usable to create or revise a listing. A DescriptionTemplate container is retrieved for each available Listing Designer template. Each DescriptionTemplate container includes the unique identifier of the template, the Listing Designer Theme Group that it belongs to, the CDATA representation of the Listing Designer template, and the URL to an image that serves as an example of the Listing Designer template. GetDescriptionTemplates Always This integer value indicates the total number of Listing Designer Layout templates that were retrieved. This field is always returned, even if it is <code>0</code> GetDescriptionTemplates Always The unique identifier of a Listing Designer Layout template that is now obsolete. An ObsoleteLayoutID field is returned for each obsolete Listing Designer Layout template. GetDescriptionTemplates Conditionally The unique identifier of a Listing Designer Theme template that is now obsolete. An ObsoleteThemeID field is returned for each obsolete Listing Designer Theme template. GetDescriptionTemplates Conditionally A ThemeGroup container is retrieved for each available Listing Designer Theme Group. Each ThemeGroup container includes the unique identifier of the Theme Group, the Theme Group name, and all of the Listing Designer Theme template that belong to that Theme Group. GetDescriptionTemplates Conditionally This integer value indicates the total number of Listing Designer Theme templates that were retrieved. This field is always returned, even if it is <code>0</code> GetDescriptionTemplates Always Retrieves one, many, or all Feedback records for a specific eBay user. There is a filter option in the call request to limit Feedback records to those that are received, or to those that are left for other buyers, as well as a filter option to limit Feedback records to those that are received as a buyer or seller. DetailLevel Second change offers https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/feedback.html The user's eBay User ID is specified in this field. If this field is used, all retrieved Feedback data will be for this eBay user. Specifies the user whose feedback data is to be returned. If this field is omitted in the call request, all retrieved Feedback records will be for the eBay user making the call. Note: Effective September 26, 2025, both usernames and public user IDs will be accepted in this field. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetFeedback No The unique identifier of a Feedback record. This field is used if the user wants to retrieve a specific Feedback record. If FeedbackID is specified in the call request, all other input fields are ignored. GetFeedback No Unique identifier for an eBay listing. A listing can have multiple order line items, but only one ItemID. If ItemID is specified in the GetFeedback request, the returned Feedback record(s) are restricted to the specified ItemID. The maximum number of Feedback records that can be returned is 100. GetFeedback No Unique identifier for an eBay order line item. 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. The TransactionID value for auction listings is always <code>0</code> since there can be only one winning bidder/one sale for an auction listing. Note: Historically, TransactionID values have been '0' for auction listings, and some developers may have built logic around this. However, non-zero TransactionID values for auction listings started being used for some eBay marketplaces beginning in July 2024, and all eBay marketplaces are expected to start using non-zero TransactionID values for auction listings in the near future. If necessary, developers should update code to handle non-zero transaction IDs for auction transactions. GetFeedback No This field is used to retrieve Feedback records of a specific type (Positive, Negative, or Neutral) in FeedbackDetailArray. You can include one or two CommentType fields in the request. If no CommentType value is specified, Feedback records of all types are returned. GetFeedback No This field is used to restrict retrieved Feedback records to those that the user left for other buyers, Feedback records received as a seller, Feedback records received as a buyer, or Feedback records received as a buyer and seller. The default value is FeedbackReceived, so if the FeedbackType field is omitted in the request, all Feedback records received by the user as a buyer and seller are returned in the response. "Feedback Left" data will not be returned in the call response. FeedbackReceived 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. 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. 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 FeedbackDetail container returned for each Feedback record. Only populated with data when a detail level of <code>ReturnAll</code> is specified in the request. Not returned if you specify a FeedbackID in the request. GetFeedback

DetailLevel: ReturnAll

Conditionally Indicates the total number of Feedback records returned in the the response. 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, including the total number of Feedback entries and the total number of pages required to show all of these Feedback entries. The total number of pages is dependent on the Pagination.EntriesPerPage value (if set). The EntriesPerPage value defaults to <code>25</code> if the Pagination.EntriesPerPage field is not used. If the call request returns no Feedback entries because there are none, or because the DetailLevel field was not included and set to <code>ReturnAll</code>, the PaginationResult.TotalNumberOfPages and PaginationResult.TotalNumberOfEntries fields are still returned, but with values of <code>0</code>. GetFeedback

DetailLevel: none, ReturnAll

Always Indicates the number of Feedback records that are set to be returned per page of data (i.e., per call). The EntriesPerPage value defaults to <code>25</code> if the Pagination.EntriesPerPage field is not set in the request. This field is always returned even if the response is not showing any Feedback entries. GetFeedback

DetailLevel: none, ReturnAll

Always Indicates the page of data that is currently displaying. The page number to display is set in the Pagination.PageNumber field in the request. If this field is omitted, the PageNumber value defaults to <code>1</code> (first page of Feedback entries). If the integer value input into the Pagination.PageNumber field in the request is higher than the total number of available pages, the call fails with an error. This field is always returned even if the response is not showing any Feedback entries. GetFeedback

DetailLevel: none, ReturnAll

Always The GetItem call returns listing data such as title, description, price information, user information, and so on, for the specified ItemID. DetailLevel Retrieve items https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/retrieve-items.html Add pictures https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/pictures.html This field is used to identify the eBay listing by Item ID value. 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. GetItem Conditionally The seller can include this field and set its value to <code>true</code> if that seller wants to see how many prospective bidders/buyers currently have the item added to their Watch Lists. The Watch count is returned in the WatchCount field in the response. This field will only be returnd to the seller of the item. false GetItem No If this field is included and set to <code>true</code>, the call response includes the ItemSpecifics container if Item Specifics are defined for the listing. An Item Specific is any aspect that helps define/classify the item. Many eBay categories mandate including specific Item Specifics, so it is always a good idea to make a call to the <a href="https://developer.ebay.com/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory" target="_blank">getItemAspectsForCategory</a> method of the Taxonomy API to see what Item Specifics are required and which ones are recommended. Including this field and setting it to <code>true</code> will also return the UnitInfo container if applicable. The UnitInfo container will provide information about the weight, volume or other quantity measurement of a listed item. The European Union requires listings for certain types of products to include the price per unit so buyers can accurately compare prices. eBay uses the UnitType and UnitQuantity values and the item's listed price to calculate and display the per-unit price on eBay EU sites. GetItem No false Item specifics https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/item-specifics.html The seller will include this field and set its value to <code>true</code> if the seller wishes to view the defined sales tax rates for the various jurisdictions in the country (generally, states and provinces). Information for each defined sales tax rate will be returned in the TaxTable container in the response. Even if this field is included and set to <code>true</code>, no TaxTable container will be returned If no sales tax rates are defined for any tax jurisdiction in the seller's sales tax table. Sales tax tables are only available for eBay US and Canada marketplaces. Sales tax rates can be added/modified in My eBay, through the SetTaxTable and GetTaxTable calls of the Trading API, or through the Sales Tax calls of the Account API. false 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 Conditionally 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 Conditionally A unique identifier for an order line item. 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. The TransactionID value for auction listings is always <code>0</code> since there can be only one winning bidder/one sale for an auction listing. Note: Historically, TransactionID values have been '0' for auction listings, and some developers may have built logic around this. However, non-zero TransactionID values for auction listings started being used for some eBay marketplaces beginning in July 2024, and all eBay marketplaces are expected to start using non-zero TransactionID values for auction listings in the near future. If necessary, developers should update code to handle non-zero transaction IDs for auction transactions. GetItem Conditionally This field is used to specify whether or not to retrieve Parts Compatiblity information for a motor part or accessory listing. If this field is included and set to <code>true</code>, the Item.ItemCompatibilityList container will be returned if a Parts Compatibility list exists for the listing. A Parts Compatibility list is a list of motor vehicles that are compatible with the listed motor part or accesory item. If a Parts Compatibility list does not exist for the listing, this field will have no effect if it is included, regardless of its value (<code>true</code> or <code>false</code>). If this field is included and set to <code>false</code> or omitted, but a Parts Compatibility list does exist for the listing, the Item.ItemCompatibilityList container will not be returned, but the Item.ItemCompatibilityCount field will be returned, and this field will simply indicate the quantity of motor vehicles that are compatible with the the listed motor part or accesory item. Parts Compatibility lists are only applicable to motor parts and accessory categories on the sites that support eBay Motors - US, CA, UK, and DE. false GetItem No ItemCompatibilityCount #Response.Item.ItemCompatibilityCount ItemCompatibilityList #Response.Item.ItemCompatibilityList Parts and accessories https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-motors-parts-accessories.html#search This type is used to display detailed information about the listing that was retrieved. This container consists of detailed information about the retrieved listing. The amount of information that is returned is partially controlled by the filters that are set in the call request. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always This is the base request type of the GetItemShipping call. This call takes an ItemID value for an item that has yet to be shipped, and then returns estimated shipping costs for every shipping service that the seller has offered with the listing. This call will also return PickUpInStoreDetails.EligibleForPickupDropOff and PickUpInStoreDetails.EligibleForPickupInStore flags if the item is available for buyer pick-up through the In-Store Pickup or Click and Collect features.

This call takes an ItemID value for an item that has yet to be shipped, and then returns estimated shipping costs for every shipping service that the seller has offered with the listing.

Shipping costs https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-costs.html The unique identifier of the eBay listing for which to retrieve estimated shipping costs for all offered shipping service options. The ItemID value passed into this field should be for an listing that offers at least one calculated shipping service option, and for an item that has yet to be shipped. GetItemShipping Yes This field is used to specify the quantity of the item. The QuantitySold value defaults to <code>1</code> if not specified. If a value greater than <code>1</code> is specified in this field, the shipping service costs returned in the response will reflect the expense to ship multiple quantity of an item. 1 Quantity available in the listing GetItemShipping No The destination postal code (or zip code for US) is supplied in this field. GetItemShipping requires the destination of the shipment. Some countries will require both the DestinationPostalCode and the DestinationCountryCode, and some countries will accept either one or the other. GetItemShipping Conditionally The destination country code is supplied in this field. GetItemShipping requires the destination of the shipment. Some countries will require both the DestinationPostalCode and the DestinationCountryCode, and some countries will accept either one or the other. Two-digit country codes can be found in <a href="types/CountryCodeType.html">CountryCodeType</a>. US GetItemShipping Conditionally This is the base response type of the GetItemShipping call. This call takes an ItemID value for an item that has yet to be shipped, and then returns estimated shipping costs for every shipping service that the seller has offered with the listing. This call will also return the PickUpInStoreDetails.EligibleForPickupInStore flag if the item is available for buyer pick-up through the In-Store Pickup feature. This container will be returned if at least one domestic or international shipping service option is available for the item. A ShippingServiceOptions (for domestic shipping) and/or an InternationalShippingServiceOptions container (for international shipping) is returned for each available calculated shipping service option. These shipping service option containers consists of estimated shipping cost and estimated shipping times. 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. GetItemShipping Always This container is only returned in GetItemShipping if the In-Store Pickup feature is enabled for the listing. In-Store Pickup as a fulfillment method is only available to a limited number of large retail merchants in the US, Canada, UK, Germany, and Australia marketplaces. The In-Store Pickup feature can only be applied to multiple-quantity, fixed-price listings, and the merchant must have quantity of the item available in a store that is near the prospective buyer, in order for In-Store Pickup to be an available fulfillment option for that buyer. GetItemShipping Conditionally This call retrieves details on one or more order line items for a specified eBay listing. Auctions and single-quantity, fixed-price listings can only have one order line item, but a multiple-quantity and/or multiple-variation, fixed-priced listing can have numerous order line items. To find one or more order line items for an eBay listing, an ItemID value can be passed in. If a user wanted to retrieve a specific order line item, an ItemID value and a an TransactionID value can be passed in, or an OrderLineItemID value can be passed in instead of an ItemID/TransactionID pair. The NumberOfDays or the ModTimeFrom and ModTimeTo date range filters can be used to retrieve order line items generated (or last modified) within a specific range of time. The maximum date range that can be set is 30 days, and the ModTimeFrom date value cannot be set any further back than 90 days in the past. If no date range filters are used, all order line items (associated with the specified listing) generated (or last modified) in the last 30 days are retrieved. Date ranges are generally only used for multiple-quantity or multiple-variation, fixed-price listings that can have multiple order line items. There are also pagination filters available that allow the user to control how many and which order line items are returned on each page of a results set. DetailLevel Manage and fulfill orders https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manage-fulfill-orders.html Unique identifier for an eBay listing. A listing can have multiple order line items, but only one ItemID. When you use ItemID alone, eBay returns all order line items that are associated with the ItemID. If you pair ItemID with a specific TransactionID, data on a specific order line item is returned. An OrderLineItemID value can be used instead of an ItemID/TransactionID pair to identify an order line item, and if an OrderLineItemID is specified in the request, any ItemID/TransactionID pair specified in the same request is 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 instead. GetItemTransactions Conditionally The ModTimeFrom and ModTimeTo fields are used to retrieve order line items that were created or modified within a specified date range. The ModTimeFrom field is the starting date range. All of the listing's order line items that were generated or modified within this date range are returned in the output. The maximum date range that may be specified is 30 days. This value cannot be set back more than 90 days in the past, as this call cannot retrieve sales older than 90 days old. The maximum date range that may be specified is 30 days. This field is not applicable (and is ignored) if the user is looking for a specific order line item by either using an ItemID/TransactionID pair, or an OrderLineItemID value. Note: Please note that for a multiple line item order, all line items of that order that meet the filter criteria may be returned in the responses, even the line item(s) that were not actually modified. In other words, if any part of the order was modified, all line items of that order may be returned. GetItemTransactions No The ModTimeFrom and ModTimeTo fields are used to retrieve order line items that were created or modified within a specified date range. The ModTimeTo field is the ending date range. All eBay order line items that were generated (or 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 after the date specified with the ModTimeFrom value (if ModTimeFrom value is more than 30 days in the past). This field is not applicable (and is ignored) if the user is looking for a specific order line item by either using an ItemID/TransactionID pair, or an OrderLineItemID value. Note: Please note that for a multiple line item order, all line items of that order that meet the filter criteria may be returned in the responses, even the line item(s) that were not actually modified. In other words, if any part of the order was modified, all line items of that order may be returned. GetItemTransactions No Include a TransactionID field in the request if you want to retrieve the data for a specific order line item for the listing specified in the ItemID field. This field is really only applicable for a multiple-quantity or multiple-variation, fixed-price listing that may have multiple sales. An auction listing or a single-quantity, fixed-price listing will only result in one order line item, so this field is not needed in these two cases. If an OrderLineItemID value is used instead to identify an order line item, this field is ignored. If this field is used, any specified date filter is ignored. The TransactionID value for auction listings is always <code>0</code> since there can be only one winning bidder/one sale for an auction listing. Note: Historically, TransactionID values have been '0' for auction listings, and some developers may have built logic around this. However, non-zero TransactionID values for auction listings started being used for some eBay marketplaces beginning in July 2024, and all eBay marketplaces are expected to start using non-zero TransactionID values for auction listings in the near future. If necessary, developers should update code to handle non-zero transaction IDs for auction transactions. GetItemTransactions No This container controls how many order line items should be returned per page of data, as well as which page of data to return (if there are multiple pages of order line items). 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 This field is included and set to <code>true</code> if the user wants to view 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. See the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/selling-fees?id=4822" target="_blank">Selling fees</a> help page for more information about how Final Value Fees are calculated. false GetItemTransactions No This field is included and set to <code>true</code> if the user wants to view order-level details, including the unique identifier of the order and the status of the order. The order-level details will be shown in the ContainingOrder container in the response. false GetItemTransactions No Note: This field is should no longer be used, as its purpose in the past was to give the user the ability to retrieve only eBay marketplace order line items or only Half.com listings, and since the Half.com site no longer exists, this field is no longer relevant. 1027 NoOp 1033 This date range 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 date range filters. This field is not applicable if a specific order line item is specified either through an ItemIDTransactionID pair or an OrderLineItemID value. 30 1 30 GetItemTransactions No If this field is included in the request and set to <code>true</code>, details on all variations defined in the specified multiple-variation listing are returned, including variations that have no sales. If this field is not included in the request or set to <code>false</code>, 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 identifier is created once there is a commitment to buy (bidder wins the auction, buyer clicks buy button, or buyer purchases item through PlaceOffer call). If you want to retrieve data on a specific order line item, you can use an OrderLineItemID value in the request instead of an ItemID/TransactionID pair. If an OrderLineItemID is provided, any specified date range filter is ignored. GetItemTransactions No Returns an array of order line item 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, FixedPriceTransaction, CheckoutBuyerRequestsTotal, ItemMarkedShipped, and ItemMarkedPaid. 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 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 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. Note: The GetItemTransactions call does not support <a href ="https://www.ebay.com/sellercenter/ebay-for-business/multi-user-account-access" target="_blank" >Team Access (formerly multi-user account access)</a>. Transactions are only returned for the user that makes the call. You cannot use GetItemTransactions to return transactions for another user. The call succeeds but returns an empty <code><TransactionArray/></code>. GetItemTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Conditionally This is the base request type of the GetItemsAwaitingFeedback call. This call retrieves all completed order line items for which the user (buyer or seller) still needs to leave Feedback for their order partner.

This call retrieves all completed order line items for which the user (buyer or seller) still needs to leave Feedback for their order partner.

This field allows the user to control how the order line items are returned in the response. If this field is not used, order line items are returned based on end time (from most recent to oldest). Valid values for this field are: <ul> <li><code>EndTime</code></li> <li><code>EndTimeDescending</code> (default value)</li> <li><code>FeedbackLeft</code></li> <li><code>FeedbackLeftDescending</code></li> <li><code>FeedbackReceived</code></li> <li><code>FeedbackReceivedDescending</code></li> <li><code>Title</code></li> <li><code>TitleDescending</code></li> <li><code>UserID</code></li> <li><code>UserIDDescending</code></li> </ul> Reference the <a href="types/ItemSortTypeCodeType.html">ItemSortTypeCodeType</a> definition for more information on these sort values. EndTimeDescending GetItemsAwaitingFeedback No This container can be used if the user only wants to see a subset of order line item results. In this container, the user will specify the number of order line items to return per page of data, and will specify the specific page of data they want to view with each call. With the GetItemsAwaitingFeedback call, the maximum allowed value for EntriesPerPage is 200. GetItemsAwaitingFeedback No This is the base response type of the GetItemsAwaitingFeedback call. This call retrieves all completed order line items for which the user (buyer or seller) still needs to leave Feedback for their order partner. This container consists of one or more order line items that are awaiting Feedback from the user that made the call. Each order line item is returned in its own TransactionArray.Transaction container. This container will not be returned if no order line items are awaiting Feedback from the user who made the call. GetItemsAwaitingFeedback Always Retrieves a list of the messages buyers have posted about your active item listings. GetMyMessages The unique identifier of the eBay listing for which you wish to retrieve member messages. For Ask Seller Question messages, the ItemID and/or a date range (specified with StartCreationTime and EndCreationTime fields), are required, or the call will fail. GetMemberMessages Conditionally This required field indicates the type of member message to retrieve. Only the following two enumeration values are allowed. The call will fail if this field is not included in the request. GetMemberMessages AskSellerQuestion, All Yes This field allows you to retrieve only unanswered member messages or answered member messages. If this field is omitted, both answered and unanswered member messages are retrieved. GetMemberMessages No If included in the request and set to <code>true</code>, only public messages (viewable in the Item listing) are returned. If omitted or set to <code>false</code> 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 Contact eBay Member (CEM) messages, StartCreationTime and EndCreationTime must be provided. For Ask Seller a Question (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 Contact eBay Member (CEM) messages, StartCreationTime and EndCreationTime must be provided. For Ask Seller a Question (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. Note: Effective September 26, 2025, both usernames and public user IDs will be accepted in this field. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetMemberMessages No Retrieves a list of the messages buyers have posted about your active item listings. 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 field. SetMessagePreferences The eBay user ID of the seller to retrieve ASQ subjects for. A user can retrieve their own ASQ subjects or those of another eBay user with a seller account. Note: Effective September 26, 2025, both usernames and public user IDs will be accepted in this field. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetMessagePreferences Yes This field must be included and set to <code>true</code> to retrieve the ASQ subjects for the specified eBay user. GetMessagePreferences Yes 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 GetMemberMessages This container can be used to retrieve one or more specific messages identified with their unique MessageID values. Up to 10 MessageID values can be specified with one call. GetMyMessages Conditionally A unique identifier for a My Messages folder. If a FolderID value 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 value for EntriesPerPage with GetMyMessages is 25. GetMyMessages No If this field is included in the request and set to <code>true</code>, 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 Message IDs. Always/Conditionally returned logic assumes a detail level of ReturnMessages. GetMyMessages

DetailLevel: ReturnSummary

Conditionally This container consists of an array of one or more messages that match the search criteria in the call request. GetMyMessages

DetailLevel: ReturnHeaders, ReturnMessages

Always Retrieves information regarding a user's buying activity, such as items they are watching, bidding on, have won, did not win, and have made Best Offers on. DetailLevel Include this container and set the WatchList.Include field to <code>true</code> to return the list of items on the eBay user's Watch List. The user also has the option of using pagination and sorting for the list of watched items that will be returned. GetMyeBayBuying No Include this container and set the BidList.Include field to <code>true</code> to return the list of auction items on which the eBay user has bid. The user also has the option of using pagination and sorting for the list of auction items that will be returned. GetMyeBayBuying No Include this container and set the BestOfferList.Include field to <code>true</code> to return the list of items on which the eBay user has made a Best Offer. The user also has the option of using pagination and sorting for the list of items that will be returned. GetMyeBayBuying No Include this container and set the WonList.Include field to <code>true</code> to return the list of auction items on which the eBay user has bid on and won. The user also has the option of using pagination and sorting for the list of auction items that will be returned. GetMyeBayBuying No Include this container and set the LostList.Include field to <code>true</code> to return the list of auction items on which the eBay user has bid on and lost. The user also has the option of using pagination and sorting for the list of auction items that will be returned. GetMyeBayBuying No Include this container and set the FavoriteSearches.Include field to <code>true</code> to return the list of the eBay user's saved searches. GetMyeBayBuying No Include this container and set the FavoriteSellers.Include field to <code>true</code> to return the list of the eBay user's saved sellers. GetMyeBayBuying No Include this container and set the SecondChanceOffer.Include field to <code>true</code> to return any Second Chance Offers that the eBay user has received. GetMyeBayBuying No Include this container and set the DeletedFromWonList.Include field to <code>true</code> to return the list of auction items on which the eBay user has bid on and won, but has deleted from their My eBay page. The user also has the option of using pagination and sorting for the list of auction items that will be returned. GetMyeBayBuying No Include this container and set the DeletedFromLostList.Include field to <code>true</code> to return the list of auction items on which the eBay user has bid on and lost, and has deleted from their My eBay page. The user also has the option of using pagination and sorting for the list of auction items that will be returned. GetMyeBayBuying No Include this container and set the BuyingSummary.Include field to <code>true</code> to return the BuyingSummary container in the response. The BuyingSummary container consists of buying/bidding activity counts and values. GetMyeBayBuying No Include this container and set the UserDefinedLists.Include field to <code>true</code> to return one or more user-defined lists. User-defined lists are lists created by the user in My eBay and consists of a combination of items, saved sellers, and/or saved searches. GetMyeBayBuying No If this field is included and set to <code>true</code>, the Variations node (and all variation data) is omitted for all multiple-variation listings in the response. If this field is omitted or set to <code>false</code>, the Variations node is returned for all multiple-variation listings in the response. GetMyeBayBuying No false Returns information regarding a user's buying activity, such as items they are watching, bidding on, have won, did not win, and have made Best Offers on. This container consists of buying/bidding activity counts and values. For this container to be returned, the user must include the BuyingSummary.Include field in the request and set its value to <code>true</code>. GetMyeBayBuying

DetailLevel: ReturnAll

Conditionally This container consists of the items on the eBay user's Watch List. This container will be returned if the eBay user has one or more items on their Watch List. This container will not be returned in the response (even if there are items on the Watch List) if the DetailLevel value is set to <code>ReturnSummary</code> and the WatchList.Include field is omitted or set to <code>false</code>. GetMyeBayBuying

DetailLevel: ReturnAll

Conditionally This container consists of the auction items on which the eBay user has bid. This container will be returned if the eBay user has bid on one or more auction items. This container will not be returned in the response (even if there are items on the Bid List) if the DetailLevel value is set to <code>ReturnSummary</code> and the BidList.Include field is omitted or set to <code>false</code>. GetMyeBayBuying

DetailLevel: ReturnAll

Conditionally This container consists of the items on which the eBay user has made Best Offers. This container will be returned if the eBay user has made one or more Best Offers. This container will not be returned in the response (even if user has made Best Offers) if the DetailLevel value is set to <code>ReturnSummary</code> and the BestOfferList.Include field is omitted or set to <code>false</code>. GetMyeBayBuying

DetailLevel: ReturnAll

Conditionally This container consists of the auction items on which the eBay user has won. This container will be returned if the eBay user has won one or more auction items. This container will not be returned in the response (even if there are items on the Won List) if the DetailLevel value is set to <code>ReturnSummary</code> and the WonList.Include field is omitted or set to <code>false</code>. GetMyeBayBuying

DetailLevel: ReturnAll

Conditionally This container consists of the auction items on which the eBay user has bid on but lost. This container will be returned if the eBay user has lost one or more auction items. This container will not be returned in the response (even if the buyer has lost one or more auction items) if the DetailLevel value is set to <code>ReturnSummary</code> and the LostList.Include field is omitted or set to <code>false</code>. GetMyeBayBuying

DetailLevel: ReturnAll

Conditionally This container consists of the eBay user's saved searches. This container will be returned if the eBay user has one or more saved searches. This container will not be returned in the response (even if the user has saved searches) if the DetailLevel value is set to <code>ReturnSummary</code> and the FavoriteSearches.Include field is omitted or set to <code>false</code>. This container consists of the search name, search query, and other search elements. The user can copy and paste the URL in the SearchQuery field into a browser to view the search results again. GetMyeBayBuying

DetailLevel: ReturnAll

Conditionally This container consists of the eBay user's saved sellers. This container will be returned if the eBay user has one or more saved sellers. This container will not be returned in the response (even if the user has saved sellers) if the DetailLevel value is set to <code>ReturnSummary</code> and the FavoriteSellers.Include field is omitted or set to <code>false</code>. This container consists of the saved sellers' user IDs and eBay Store names (if applicable). GetMyeBayBuying

DetailLevel: ReturnAll

Conditionally This container consists of the items on which the eBay user has received a Second Chance Offer. This container will be returned if the eBay user has made one or more Second Chance Offers. This container will not be returned in the response (even if user has received Second Chance Offers) if the DetailLevel value is set to <code>ReturnSummary</code> and the SecondChanceOffer.Include field is omitted or set to <code>false</code>. GetMyeBayBuying

DetailLevel: ReturnAll

Conditionally This container consists of the auction items on which the eBay user has won but deleted from their My eBay page. This container will be returned if the eBay user has won one or more auction items but have deleted these items from My eBay. This container will not be returned in the response (even if they have won and then deleted one or more items) if the DetailLevel value is set to <code>ReturnSummary</code> and the DeletedFromWonList.Include field is omitted or set to <code>false</code>. GetMyeBayBuying

DetailLevel: ReturnAll

Conditionally This container consists of the auction items on which the eBay user has lost and then deleted from their My eBay page. This container will be returned if the eBay user has lost one or more auction items and then deleted those items from My eBay. This container will not be returned in the response (even if they have lost and then deleted one or more items) if the DetailLevel value is set to <code>ReturnSummary</code> and the DeletedFromLostList.Include field is omitted or set to <code>false</code>. GetMyeBayBuying

DetailLevel: ReturnAll

Conditionally This container consists of data for a user-defined list that was created by the user in My eBay. User-defined lists consists of a combination of items, saved sellers, and/or saved searches. This container will not be returned in the response (even if one or more user-defined lists exist) if the DetailLevel value is set to <code>ReturnSummary</code> and the UserDefinedList.Include field is omitted or set to <code>false</code>. GetMyeBayBuying Conditionally Retrieves information regarding the user's selling activity, such as items that the user is currently selling (the Active list), auction listings that have bids, sold items, and unsold items. DetailLevel GetMyeBaySelling https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/my-ebay-selling.html eBay Selling Page (US) https://www.ebay.com/help/selling Include this container and set the ScheduledList.Include field to <code>true</code> to return the list of items that are scheduled to become active listings on eBay.com at a future date/time. The user also has the option of using pagination and sorting for the list of Scheduled listings that will be returned. GetMyeBaySelling No Include this container and set the ActiveList.Include field to <code>true</code> to return the list of active listings on eBay.com. The user also has the option of using pagination and sorting for the list of active listings that will be returned. GetMyeBaySelling No Include this container and set the SoldList.Include field to <code>true</code> to return the list of sold order line items. The user also has the option of using pagination and sorting for the list of sold items that will be returned. GetMyeBaySelling No Include this container and set the UnsoldList.Include field to <code>true</code> to return the listings that have ended without a purchase. The user also has the option of using pagination and sorting for the list of unsold items that will be returned. GetMyeBaySelling No Include this container and set the SellingSummary.Include field to <code>true</code> to return the SellingSummary container in the response. The SellingSummary container consists of selling activity counts and values. GetMyeBaySelling No If this field is included and set to <code>true</code>, the Variations node (and all variation data) is omitted for all multiple-variation listings in the response. If this field is omitted or set to <code>false</code>, the Variations node is returned for all multiple-variation listings in the response. 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. This container consists of seller activity counts and values. For this container to be returned, the user must include the SellingSummary.Include field in the request and set its value to <code>true</code>. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally This container consists of the items that are scheduled to become active at a future date/time. This container will be returned if the eBay user has one or more listings scheduled to become active at a future date/time. This container will not be returned in the response (even if there are listings scheduled to become active) if the DetailLevel value is set to <code>ReturnSummary</code> and the ScheduledList.Include field is omitted or set to <code>false</code>. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally This container consists of active listings. This container will be returned if the eBay user has one or more active listings on eBay.com. This container will not be returned in the response (even if there are one or more active listings) if the DetailLevel value is set to <code>ReturnSummary</code> and the ActiveList.Include field is omitted or set to <code>false</code>. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally This container consists of order line items that have been sold. This container will be returned if the eBay user has one or more listings that have had recent sales. This container will not be returned in the response (even if there are one or more sales) if the DetailLevel value is set to <code>ReturnSummary</code> and the SoldList.Include field is omitted or set to <code>false</code>. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally This container consists of listings that have ended without sales. This container will be returned if the eBay user has one or more listings that have ended without sales. This container will not be returned in the response (even if there are one or more listings that ended without sales) if the DetailLevel value is set to <code>ReturnSummary</code> and the UnsoldList.Include field is omitted or set to <code>false</code>. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally This container consists of seller activity counts and values. This container is always returned if there has been recent sell activity. GetMyeBaySelling

DetailLevel: none, ReturnAll

Always 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. Platform Notifications Guide https://developer.ebay.com/api-docs/static/platform-notifications-landing.html Specifies the type of preferences to retrieve. For example, preferences can be associated with a user, with an application, or with events. Application 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. Platform Notifications Guide https://developer.ebay.com/api-docs/static/platform-notifications-landing.html 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. GetNotificationsUsage Yes 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. GetNotificationsUsage Always Returns the end date and time for the notification information that is returned by this call. GetNotificationsUsage Always List of notification objects representing the notifications sent to an application for the given time period. GetNotificationsUsage Always 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 the orders for which the authenticated user is a participant, either as the buyer or the seller. The call returns all the orders that meet the request criteria. Orders older than 90 days old will not be returned. DetailLevel This container is used if the user wants to retrieve one or more specific orders in which they are involved as either the seller or buyer. If one or more order IDs are specified in this container, any order role, order status, or date range filters are ignored if specified in the request. Note: The identifier for an order will change as it goes from unpaid to paid status, and both values are supported in OrderID fields. GetOrders Conditionally The CreateTimeFrom and CreateTimeTo fields specify a date range for retrieving orders that were created during this time period. 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. This value cannot be set back more than 90 days in the past, as this call cannot retrieve sales older than 90 days old. Note: Unless one or more OrderID values are used, one of the three available date range filters must be used. GetOrders Conditionally The CreateTimeFrom and CreateTimeTo fields specify a date range for retrieving orders that were created during this time period. 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 multiple 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. Note: Unless one or more OrderID values are used, one of the three available date range filters must be used. GetOrders Conditionally This filter is used to toggle between retrieving orders based on the role of the user (seller or buyer). The order role defaults to <code>Seller</code> if this field is not used. If this field is used with a date filter, returned orders must satisfy both the date range and the OrderRole value. Seller GetOrders Conditionally The field is used to retrieve eBay orders that are in a specific state. If this field is used with a date filter, only orders that satisfy both the date range and the OrderStatus value are retrieved. If one or more OrderID values are specified through the OrderIDArray container, the OrderStatus field should not be used, and it is ignored if it is used. If an OrderStatus value is not used and no OrderID values are specified, orders in all states are returned. GetOrders Active, All, Cancelled, Completed, Inactive No All Use this field if you wish to only retrieve orders spawned from a specific listing type such as auction or fixed price. See <a href="https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/types/ListingTypeCodeType.html" target="_blank">ListingTypeCodeType</a> for supported values. GetOrders 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 orders. Use the Pagination filters to control the maximum number of orders to retrieve per page (i.e., per call), and the page number to retrieve. GetOrders No The ModTimeFrom and ModTimeTo fields specify a date range for retrieving existing orders that have been modified within this time period (for example, <code>Incomplete</code> status to <code>Pending</code> status or <code>Pending</code> status to <code>Complete</code> 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. Unlike the CreateTimeFrom/CreateTimeTo filters, which may cover a maximum period of 90 days, the maximum date range that may be specified with the ModTimeFrom and ModTimeTo fields is only 30 days. This value cannot be set back more than 90 days in the past, as this call cannot retrieve sales older than 90 days old. 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. Note: Unless one or more OrderID values are used, one of the three available date range filters must be used. 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, <code>Incomplete</code> status to <code>Pending</code> status or <code>Pending</code> status to <code>Complete</code> 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. Unlike the CreateTimeFrom/CreateTimeTo filters, which may cover a maximum period of 90 days, 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. Note: Unless one or more OrderID values are used, one of the three available date range filters must be used. GetOrders Conditionally This filter specifies the number of days (24-hour periods) in the past to search for orders. All eBay orders that were created within this period are returned in the output. This field cannot be used in conjunction with the CreateTimeFrom/CreateTimeTo or ModTimeFrom/ModTimeTo date filters. Note: This date filter only allows you to retrieve orders created within the last 30 days. So, if you wish to retrieve orders created and/or modified more than 30 days in the past, the CreateTimeFrom/CreateTimeTo or ModTimeFrom/ModTimeTo date filters should be used instead. Note: Unless one or more OrderID values are used, one of the three available date range filters must be used. 1 30 GetOrders Conditionally This field is included and set to <code>true</code> if the user wants to view 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. See the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/selling-fees?id=4822" target="_blank">Selling fees</a> help page for more information about how Final Value Fees are calculated. false GetOrders Conditionally This filter controls whether orders are retrieved in ascending order (oldest to newest according to modification date) or descending order (newest to oldest according to modification date). The default is <code>Ascending</code>, so the user will need to include this field and set it to <code>Descending</code> if the user wishes to view the most recent orders first in the retrieved output. Ascending GetOrders No 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. Note: The GetOrders call does not support <a href ="https://www.ebay.com/sellercenter/ebay-for-business/multi-user-account-access" target="_blank" >Team Access (formerly multi-user account access)</a>. Transactions are only returned for the user that makes the call. You cannot use GetOrders to return transactions for another user. The call succeeds but returns an empty <code><OrderArray/></code>. 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 call is used by a seller to retrieve changes to their own listings that have occurred within the last 48 hours, including price changes, available quantity, and other revisions to listing. One of the available date range filters must be used with this call. DetailLevel Track listing changes https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/track-listing-changes.html 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 corresponding 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 https://developer.ebay.com/support/kb-article?KBid=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 corresponding 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 https://developer.ebay.com/support/kb-article?KBid=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 corresponding 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 https://developer.ebay.com/support/kb-article?KBid=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 If true, response includes only items that have been modified within the ModTime range. If false, response includes all items. GetSellerEvents No The seller can include this field and set its value to <code>true</code> if that seller wants to see how many prospective bidders/buyers currently have an item added to their Watch Lists. The Watch count is returned in the WatchCount field for each item in the response. GetSellerEvents No Specifies whether to force the response to include variation specifics for multiple-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 is set to true. Note: 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 StartTimeFrom, EndTimeFrom, or ModTimeFrom filters. false GetSellerEvents No Specifies whether to force the response to hide variation details for multiple-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 Returns the items in an ItemArrayType object for the a seller events that have occurred and that meet any filters specified. There can be 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 StartTimeFrom, EndTimeFrom, or ModTimeFrom 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 https://developer.ebay.com/support/kb-article?KBid=222 GetSellerEvents

DetailLevel: none, ReturnAll

Always This call is used to retrieve an array of listings for the seller. The seller must be associated with the user/application token being used to make the call. This call requires that either the 'Start Time' or 'End Time' date range filters be used. The date range specified by either of these filters can not exceed 120 days or an error will occur. This call also requires that pagination be used. DetailLevel, GranularityLevel GetItem Browse a seller's items https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/browse-seller.html 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 This field can be used to control the order in which returned listings are sorted (based on the listings' actual/scheduled end dates). Valid values are as follows: <ul> <li><code>1</code> (descending order)</li> <li><code>2</code> (ascending order)</li> </ul> 2 (Ascending) 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 This container controls the maximum number of listings that can appear on one page of the result set, as well as the page number of the result to return. The GetSellerList call requires that the EntriesPerPage value be set. The PageNumber field is not required but will default to <code>1</code> if not included. GetSellerList Yes This field allows the user to control the amount of data that is returned in the response. See the <a href="#GranularityLevel">Granularity Level</a> table on this page for a list of the fields that are returned for each granularity level. Either GranularityLevel or DetailLevel can be used in a GetSellerList call, but not both. If both are specified, DetailLevel is ignored. If neither are used, the response fields will be the ones shown for 'Coarse' granularity. Yes Coarse GetSellerList No This container can be used to specify one or multiple SKUs, and only listings associated with these SKUs are retrieved. Note that all other request criteria are also considered when one or more SKU values are specified. Note: Listings with matching SKUs are returned regardless of their Item.InventoryTrackingMethod setting. GetSellerList No This field may be included and set to <code>true</code> if the seller wishes to see the number of eBay users that are watching each listing. false GetSellerList No This boolean field can be included and set to <code>true</code> if the seller would like to retrieve any listings that were administratively ended by eBay due to a listing policy violation. false GetSellerList No If you specify a CategoryID value, the response will only contain listings in the category you specify. GetSellerList No If this field is included and set to <code>true</code>, the Variations node is returned for all multi-variation listings in the response. Note: If the seller has many multiple-variation listings, that seller may not want to include variations in the GetSellerList response. Or, a seller can include variations data, but possibly limit the response by specifying shorter date ranges with the date range filters, or by reducing the number of listings returned per results (decreasing the Pagination.EntriesPerPage value). GetSellerList No This is the base response type of the GetSellerList call. The GetSellerList response includes an array of one or more listings that matched the input criteria, as well as pagination data. This container shows the total number or pages in the result set, as well as the total number of listings that match the current input criteria. GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Always This field's value is returned as <code>true</code> if there are more pages in the current result set to view, or <code>false</code> if the current page being viewed is the last (or only) page of the result set. If there are more listings to view in the result set, additional GetSellerList calls can be made but with changes to the Pagination values in the request. For example, if the Pagination.PageNumber value in the request for the last call was <code>1</code>, you can make another GetSellerList call, keeping everything the same except changing the value of the Pagination.PageNumber field from <code>1</code> to <code>2</code>. GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Always This container is an array of one or more listings that match the input criteria. If none of the seller's listings match the input criteria, this container is returned as an empty tag. GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Always This value reflects the value that was set in the Pagination.EntriesPerPage field in the request. This is the maximum number of listings that may be returned per page of the result set. Note that this value is only the maximum threshold and does not necessarily reflect the number of listings appearing on the current page of data. GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Always This value indicates the current page of data in the result set that is being displayed. This value reflects the value specified in the Pagination.PageNumber field in the request. Note that page number defaults to <code>1</code> if the Pagination.PageNumber field was not included in the request. GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Always This value indicates the total number of listings being shown on the current page of the results set. GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Always This container consists of detailed information about the seller and the seller's account. This container is only returned if the GranularityLevel field is included in the request and set to <code>Fine</code>. GetSellerList

GranularityLevel: Fine

Conditionally Retrieves a seller's order line item information. To retrieve order line items for another seller, the GetItemTransactions) call should be used. This call cannot retrieve sales older than 90 days old. If one or more SKU values or the date range filters (ModTimeFrom/ModTimeTo or NumberOfDays) are not used, the GetItemTransactions) call will retrieve order line items created (or modified) within the last 30 days.

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

DetailLevel GetOrders Manage and fulfill orders https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manage-fulfill-orders.html The ModTimeFrom and ModTimeTo fields are used to retrieve order line items that were created or modified within a specified date range. The ModTimeFrom field is the starting date range. All of the seller's order line items that were created or modified within this date range are returned in the output. The maximum date range that may be specified is 30 days. This value cannot be set back more than 90 days in the past, as this call cannot retrieve sales older than 90 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). Note: Please note that for a multiple line item order, all line items of that order that meet the filter criteria may be returned in the responses, even the line item(s) that were not actually modified. In other words, if any part of the order was modified, all line items of that order may be returned. GetSellerTransactions No The ModTimeFrom and ModTimeTo fields are used to retrieve order line items that were created or modified within a specified date range. The ModTimeTo field is the ending date range. All of the seller's order line items that were created or 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). Note: Please note that for a multiple line item order, all line items of that order that meet the filter criteria may be returned in the responses, even the line item(s) that were not actually modified. In other words, if any part of the order was modified, all line items of that order may be returned. GetSellerTransactions No If many order line items are available to retrieve, you may need to call GetSellerTransactions multiple times to retrieve all the data. Each result set is returned as a page of order line items. Use the Pagination filters to control the maximum number of order line items to retrieve per page (i.e., per call), and the page number to retrieve. GetSellerTransactions No This field is included and set to <code>true</code> if the user wants to view 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. See the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/selling-fees?id=4822" target="_blank">Selling fees</a> help page for more information about how Final Value Fees are calculated. false GetSellerTransactions No This field is included and set to <code>true</code> if the user wants to view order-level details, including the unique identifier of the order and the status of the order. The order-level details will be shown in the ContainingOrder container in the response. false GetSellerTransactions No This container is used to search for order line items generated from one or more product SKU values. The response will only include order line items for the seller's product(s) that are represented by the specified SKU value(s). If a user wants to retrieve order line items based on SKUs, the InventoryTrackingMethod must be set to <code>SKU</code>. The InventoryTrackingMethod value can be set when the seller lists the item through an AddFixedPriceItem call, or it can be set by including the InventoryTrackingMethod field in a GetSellerTransactions call and setting its value to <code>SKU</code>. Note: SKU values must be defined for products in listings for this container to be applicable. GetSellerTransactions No Note: This field should no longer be used since its sole purpose was to allow the seller to filter between eBay orders and Half.com orders, and the Half.com site no longer exists. 1027 NoOp 1033 This field is used to specify how many days (24-hour periods) back in the past you wish to retrieve order line items. All order line items created (or last modified) within this period are retrieved. This value can be set between 1 (day) and 30 (days), and defaults to 30 (days) if omitted from the call. If the NumberOfDays filter is used, ModTimeFrom and ModTimeTo date range filters are ignored (if included in the same request). 1 30 30 GetSellerTransactions No This filter is used if the seller wishes to set/change the inventory tracking method. When creating a listing with the AddFixedPriceItem call (or relisting with RelistFixedPriceItem call), sellers can decide whether to track their inventory by Item ID (generated by eBay at listing time) or by seller-defined SKU value. This field is needed (and its value must be set to <code>SKU</code>) if the seller wishes to retrieve order line items based on specified SKU values (specified through SKUArray container) and the current inventory tracking method is set to Item ID. A seller can use a GetItem call for a listing (and look for the Item.InventoryTrackingMethod in the response) to see which inventory tracking method is used for the listing/product. GetSellerTransactions Conditionally If this field is included in the call request and set to <code>true</code>, taxpayer identification information for the buyer is returned under the BuyerTaxIdentifier container. Codice Fiscale is only applicable to buyers on the Italy and Spain sites. It is required that buyers on the Italy site provide their Codice Fiscale ID before buying an item, and sellers on the Spain site have the option of requiring buyers on the Spain site to provide their taxpayer ID. 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). This call 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 <code>true</code> if there are additional pages or order line items to <code>view</code>, or <code>false</code> 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 <code>1</code> 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 retrieved 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 Retrieves a session ID that identifies a user and your application when you make a FetchToken request. ConfirmIdentity, FetchToken, GetTokenStatus, RevokeToken Working with token/authentication calls https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/token-auth-calls.html Setting Up the Application to Receive Tokens https://developer.ebay.com/Devzone/xml/docs/HowTo/Tokens/GettingTokens.html#step1 The eBay Registered URL must be specified in this field. An eBay Registered URL is created and associated with a developer's Sandbox or Production key set by logging into the user's developer account on developer.ebay.com and going to the User Tokens page. The RuName value passed in this field must match the one specified for the specific Sandbox or Production key set being used to make the GetSessionID call. For more information on adding and registering your RuName, see the <a href="../../HowTo/Tokens/GettingTokens.html#step1">Setting Up an Application to Receive Tokens</a> tutorial. GetSessionID Yes The base response of the GetSessionID call. This response will include the generated SessionID value, 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 value is valid for five minutes after it is retrieved. GetSessionID Always This call retrieves all shipping discount profiles currently defined by the user, along with other Combined Invoice-related details such as packaging and handling costs. SetShippingDiscountProfiles Shipping information https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-info.html https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manage-fulfill-combine-invoices.html Combined invoice The base response of the GetShippingDiscountProfiles call. The three-digit code of the currency to be used for shipping cost discounts. 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 https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manage-fulfill-combine-invoices.html Combined Invoice This container consists of one or more flat-rate shipping discount rules that are set up for a seller's account. This container is returned as an empty element if no flat-rate shipping discount rules are currently set for the seller's account. GetShippingDiscountProfiles Always This container consists of one or more calculated shipping discount rules that are set up for a seller's account. This container is returned as an empty element if no calculated shipping discount rules are currently set for the seller's account. GetShippingDiscountProfiles Always This field indicates whether or not a seller has set up a promotional shipping discount rule in the seller's account. Only one promotional shipping discount may be defined for a seller's account at any given time. This field is returned whether <code>false</code> or <code>true</code>. If <code>true</code>, details of the rule can be found in the PromotionalShippingDiscountDetails container. GetShippingDiscountProfiles Always This container consists of the handling discount applicable to a calculated shipping discount rule that is set up for a seller's account. This container is not returned if no calculated shipping discount rules are currently set for the seller's account. GetShippingDiscountProfiles Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manage-fulfill-combine-invoices.html Combined Invoice This container consists of information related to the promotional shipping discount rule that is set up for a seller's account. This container is not returned if no promotional shipping discount rule is set up for the seller's account. 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 Invoice order. In a Combined Invoice order, the buyer makes one payment for all order line items, hence only unpaid order line items can be combined into a Combined Invoice order. GetShippingDiscountProfiles Always This call is used to retrieve information on a seller's eBay Store, including detailed information on all customized Store categories that the seller has set up. Include this field and set its value to <code>true</code> if you wish to restrict the call response to only the store category hierarchy data. false GetStore No The unique identifier of an eBay Store category. This field is used if the user wants to isolate the category hierarchy data to one particular eBay category (and its subcategories if applicable). The LevelLimit value will determine how many additional levels of categories are returned. GetStore No This field allows the seller to limit the number of levels of eBay Store categories that are returned. To return only top-level eBay Store categories, the user can include this field and set its value to <code>1</code> (and not use a RootCategoryID value). To retrieve a specific eBay Store Category and that category's child categories, the user could specify the unique eBay Store Category ID in the RootCategoryID field and then set the LevelLimit value to <code>2</code>. If LevelLimit is omitted, the complete eBay Store Category hierarchy is returned, or all of specified store category's child categories. eBay Stores support only three levels of store categories. GetStore No The eBay user ID of the eBay seller that owns the eBay Store to be retrieved. This field is only needed if the user wants to view the eBay Store information owned by a different seller (than the seller associated with the authenticated user token). If this field is omitted, the eBay Store information for the seller associated with the authenticated user token is returned. Note: Effective September 26, 2025, both usernames and public user IDs will be accepted in this field. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetStore No The base response type of the GetStore call. This response consists of the data describing a seller's eBay store, and includes the eBay Store name, the description of the store, the URL to the eBay Store, and eBay Store Category hierarchy. This container consists of detailed information on the seller's eBay Store. GetStore Always This call is used to retrieve the status of an eBay Store Category hierarchy change that was made with a SetStoreCategories call. SetStoreCategories Open and manage an eBay store https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-store.html The unique identifier of an eBay Store Category hierarchy change task. A TaskID value is returned in the response of a successful SetStoreCategories call. Note: Depending on the breadth of changes being made to an eBay Store Category hierarchy, it is is possible that the SetStoreCategories call will complete the task simultaneously with the call response. A seller will know if an eBay Store Category hierarchy task was completed simultaneously if the TaskID value is returned as <code>0</code>, and the Status field is returned with a value of <code>Complete</code>. If the task was not completely simultaneously, the TaskID value will be a positive integer, and the Status field will show a value of <code>InProgress</code> or <code>Pending</code>. GetStoreCategoryUpdateStatus Yes The base response of a GetStoreCategoryUpdateStatus call. The response includes the status of an eBay Store Category hierarchy change that was made with a SetStoreCategories call. The enumeration value indicates the status of an update to the eBay Store Category hierarchy. GetStoreCategoryUpdateStatus Always The base request type of the GetTaxTable call, which retrieves information on the seller's Sales Tax Table. This information includes all of the site's tax jurisdictions, a boolean field to indicate if sales tax is applied to shipping and handling charges, and the sales tax rate for each jurisdiction (if a sales tax rate is set for that jurisdiction). Sales tax tables are only supported on the eBay US and Candada marketplaces.

This call is used to retrieve information on the seller's Sales Tax Table.

SetTaxTable DetailLevel Multi-jurisdiction sales tax https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/taxes.html The base response of the GetTaxTable call. 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. Returned as an empty container if no Sales Tax Table information exists for the seller's account and no DetailLevel is used. If DetailLevel is not specified, information is only returned for the jurisdictions for which the user provided tax information. If DetailLevel is set to 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 This call is used to get the current status of a user token. There are no call-specific fields in the request payload. The base response of the GetTokenStatus call. This call retrieves the status of a user token. This container value indicates the status and expiration date of a user token. If a user token was revoked, the date/time of the revocation is also returned under this container. 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 value that identifies a current or past common order, not all data (like email addresses) will be returned in the response. DetailLevel User information https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/user-mgmt-user-info.htmll Specify the ItemID value 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. GetUser Conditionally Specify the user whose data you want returned by the call. If not specified, eBay returns data pertaining to the requesting user (as specified with the eBayAuthToken value). Note: Effective September 26, 2025, both usernames and public user IDs will be accepted in this field. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetUser No If the IncludeFeatureEligibility flag is included and set to 'true', the call response will include a QualifiesForSelling flag which indicates if the eBay user is eligible to sell on eBay, and a IncludeFeatureEligibility container which indicates which selling features are available to the user. GetUser No Base response of the GetUser call. This response includes detailed information about the user, including Feedback data, eBay registration date, selling feature eligibility, valid subsriptions, etc. This container consists of detailed information about the user specified in the call request (through the UserID field) or the eBay user account that is tied to the eBayAuthToken value that is passed in the call request. Some sensitive data will be masked/omitted if the returned eBay user is not the person making the GetUser call. More information on another eBay user will be revealed to the person making the call if that person has an order relationship for an eBay listing specified in the ItemID field of the call request. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Always This call is used to retrieve contact information for a specified eBay user, given that a bidding relationship (as either a buyer or seller) exists between the caller and the user. A unique identifier for the eBay listing that the caller and order partner have in common. GetUserContactDetails Yes An eBay user ID that uniquely identifies a given user for whom the caller is seeking information. Either a seller's or bidder's/buyer's user ID can be specified here, as long as an bidding/order relationship exists between the requester and the user specified by this field. That is, a bidder must be bidding on the seller's active auction item, or a prospective buyer has proposed a Best Offer on a listing. Note: Effective September 26, 2025, both usernames and public user IDs will be accepted in this field. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetUserContactDetails Yes An eBay user ID that uniquely identifies the person who is making the call. Either a seller's or bidder's/buyer's user ID can be specified here, as long as a bidding/order relationship exists between the requester and the user for whom information is being requested. Note: Effective September 26, 2025, both usernames and public user IDs will be accepted in this field. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. 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 the given user whose information is given in the call response. Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. 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 Retrieves the specified user preferences for the authenticated caller. SetUserPreferences User preferences https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/user-mgmt-prefs.html If included and set to <code>true</code>, the seller's preference for receiving contact information for unsuccessful bidders is returned in the response. false GetUserPreferences No If included and set to <code>true</code>, the seller's combined invoice preferences are returned in the response. These preferences are used to allow Combined Invoice orders. false GetUserPreferences No https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manage-fulfill-combine-invoices.html Combined invoice If included and set to <code>true</code>, the seller's payment preferences are returned in the response. false GetUserPreferences No If included and set to <code>true</code>, 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 <code>true</code>, the seller's favorite item preferences are returned in the response. false GetUserPreferences No If included and set to <code>true</code>, 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 <code>true</code>, 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 <code>true</code>, 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 <code>true</code>, the seller's Unpaid Item preferences are returned in the response. The Unpaid Item preferences can be used to automatically cancel an unpaid order and relist the item on the behalf of the seller. Note: To return the list of buyers excluded from the Unpaid Item preferences, the ShowUnpaidItemAssistanceExclusionList field must also be included and set to <code>true</code> in the request. Excluded buyers can be viewed in the UnpaidItemAssistancePreferences.ExcludedUser field. false GetUserPreferences Conditionally If included and set to <code>true</code>, 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 <code>true</code>, the list of eBay user IDs on the Unpaid Item preferences Excluded User list is returned through the UnpaidItemAssistancePreferences.ExcludedUser field in the response. For excluded users, an Unpaid Item is not automatically cancelled. The Excluded User list is managed through the SetUserPreferences call. Note: To return the list of buyers excluded from the Unpaid Item preferences, 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 <code>true</code>, 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 <code>true</code>, the SellerReturnPreferences container is returned in the response and indicates whether or not the seller has opted in to eBay Managed Returns. eBay Managed Returns are currently only available on the US, UK, DE, AU, and CA (English and French) sites. false GetUserPreferences No If this flag is included and set to <code>true</code>, the seller's preference for offering the Global Shipping Program to international buyers will be returned in OfferGlobalShippingProgramPreference. false GetUserPreferences No If included and set to <code>true</code>, the seller's same-day handling cutoff time is returned in DispatchCutoffTimePreference.CutoffTime. Note: For sellers opted in to the feature that supports different order cutoff times for each business day, the order cutoff time returned in the response may not be accurate. In order for the seller to confirm the actual order cutoff time for same-day handling, that seller should view Shipping Preferences in My eBay. false GetUserPreferences No Same day handling https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-handling-same-day.html details about dispatch cut off times If included and set to <code>true</code>, the GlobalShippingProgramListingPreference field is returned. A returned value of <code>true</code> indicates that the seller's new listings will enable the Global Shipping Program by default. false GetUserPreferences No If included and set to <code>true</code>, the OverrideGSPServiceWithIntlServicePreference field is returned. A returned value of <code>true</code> indicates that for the seller's listings that specify an international shipping service for any Global Shipping-eligible country, the specified service will take precedence and be the listing's default international shipping option for buyers in that country, rather than the Global Shipping Program. A returned value of <code>false</code> indicates that the Global Shipping program will take precedence over any international shipping service as the default option in Global Shipping-eligible listings for shipping to any Global Shipping-eligible country. false GetUserPreferences No If included and set to <code>true</code>, the PickupDropoffSellerPreference field is returned. A returned value of <code>true</code> indicates that the seller's new listings will by default be eligible to be evaluated for the Click and Collect feature. With the Click and Collect feature, a buyer can purchase certain items on eBay and collect them at a local store. Buyers are notified by eBay once their items are available. The Click and Collect feature is only available to large merchants on the eBay UK (site ID 3), eBay Australia (Site ID 15), and eBay Germany (Site ID 77) sites. Note: The Click and Collect program no longer allows sellers to set the Click and Collect preference at the listing level. false GetUserPreferences No If included and set to <code>true</code>, the seller's preferences related to the Out-of-Stock feature will be returned. This feature is set using the <a href="SetUserPreferences.html#Request.OutOfStockControlPreference">SetUserPreferences</a> call. false GetUserPreferences No Out-of-Stock control https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/out-of-stock.html Note: Do not use this boolean field. The opt-in and listing preference for eBayPlus has been disabled. eBay determines which listings qualify for eBay Plus based on whether the buyer has an active eBay Plus subscription and whether the listing meets the program's requirements. If used, the ListingPreference and OptInStatus fields are returned as false. See <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-plus.html" target="_blank">eBay Plus</a> for listing requirements. eBay Plus is a premium account option for buyers, which provides benefits such as fast free domestic shipping and free returns on selected items. eBay determines which listings qualify for eBay Plus based on whether the buyer has an active eBay Plus subscription and whether the listing meets the program's requirements. See <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-plus.html" target="_blank">eBay Plus</a> for listing requirements. The eBayPLUSPreference container is returned in the response with information about each country where the seller is eligible to offer eBay Plus on listings (one eBayPLUSPreference container per country). Note: Currently, eBay Plus is available only to buyers in Germany and Australia. The seller has no control/responsibility over setting the eBay Plus feature for a listing. Instead, eBay will evaluate/determine whether a listing is eligible for eBay Plus. false GetUserPreferences No more details eBay Plus https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-plus.html 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 <code>true</code> in the request. This preference is only applicable for auction listings. GetUserPreferences Conditionally Container consisting of the seller's Combined Invoice preferences. These preferences are used to allow Combined Invoice orders. This container is returned when ShowCombinedPaymentPreferences is included and set to <code>true</code> in the request. GetUserPreferences Conditionally Combined invoice https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manage-fulfill-combine-invoices.html Container consisting of the seller's payment preferences. This container is returned when ShowSellerPaymentPreferences is included and set to <code>true</code> 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 <code>true</code> 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 <code>true</code> 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 shipment tracking number. This container is returned when ShowEmailShipmentTrackingNumberPreference is included and set to <code>true</code> 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 <code>true</code> in the request. GetUserPreferences Conditionally Container consisting of a seller's Unpaid Item preferences. The Unpaid Item preferences can be used to automatically cancel an unpaid order and relist the item on the behalf of the seller. This container is returned if ShowUnpaidItemAssistancePreference is included and set to <code>true</code> in the request. Note: To return the list of buyers excluded from the Unpaid Item preferences, the ShowUnpaidItemAssistanceExclusionList field must also be included and set to <code>true</code> 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 <a href="http://cgi5.ebay.com/ws/eBayISAPI.dll?ExcludeShippingList" target="_blank">Exclude shipping locations</a> 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 <code>true</code> 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 <code>true</code> in the request. GetUserPreferences Conditionally Parent response container consisting of high-level information for all Business Policies defined for the user's account. This container is returned if ShowSellerProfilePreferences is included and set to <code>true</code> in the GetUserPreferences request (and one or more Business Policies are defined for the user's account). GetUserPreferences Conditionally Container consisting of the OptedIn flag that indicates whether or not the seller has opted in to eBay Managed Returns. This container is only returned if ShowSellerReturnPreferences is included and set to <code>true</code> 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 <code>true</code>. GetUserPreferences Conditionally Contains information about a seller's order cutoff time preferences for same-day shipping. If the seller specifies a value of '0' in Item.DispatchTimeMax to offer same-day handling when listing an item, the seller's shipping time commitment depends on the order cutoff time set for the listing site, as indicated by DispatchCutoffTimePreference.CutoffTime. Returned when ShowDispatchCutoffTimePreferences is included and set to <code>true</code>. Note: For sellers opted in to the feature that supports different order cutoff times for each business day, the order cutoff time returned in this container may not be accurate. In order for the seller to confirm the actual order cutoff time for same-day handling, that seller should view Shipping Preferences in My eBay. Same day handling https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-handling-same-day.html GetUserPreferences Conditionally If the ShowGlobalShippingProgramListingPreference field is submitted and set to <code>true</code>, this flag is returned. A returned value of <code>true</code> indicates that the seller's new listings will enable the Global Shipping Program by default. GetUserPreferences Conditionally If the ShowOverrideGSPServiceWithIntlServicePreference field is submitted and set to <code>true</code>, this flag is returned. A returned value of <code>true</code> indicates that for the seller's listings that specify an international shipping service for any Global Shipping-eligible country, the specified service will take precedence and be the listing's default international shipping option for buyers in that country, rather than the Global Shipping Program. A returned value of <code>false</code> indicates that the Global Shipping program will take precedence over any international shipping service as the default option in Global Shipping-eligible listings for shipping to any Global Shipping-eligible country. GetUserPreferences Conditionally This boolean field is returned if the ShowPickupDropoffPreferences field is included and set to <code>true</code> in the request. This field will be returned as <code>true</code> if the seller has enabled the Click and Collect feature at the account level. All of the seller's new listings will by default be eligible to be evaluated for the Click and Collect feature. With the Click and Collect feature, a buyer can purchase certain items on eBay and collect them at a local store. Buyers are notified by eBay once their items are available. The Click and Collect feature is only available to large merchants on the eBay UK (site ID 3), eBay Australia (Site ID 15), and eBay Germany (Site ID 77) sites. Note: The Click and Collect program no longer allows sellers to set the Click and Collect preference at the listing level. GetUserPreferences Conditionally This boolean field is returned if the ShowOutOfStockControlPreference field is included and set to <code>true</code> in the request. This field will be returned as <code>true</code> if the seller has set <a href="SetUserPreferences.html#Request.OutOfStockControlPreference">SetUserPreferences.OutOfStockControlPreference</a> to <code>true</code>. Out-of-Stock control https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/out-of-stock.html GetUserPreferences Conditionally Note: Sellers have no practical control over eBay Plus eligibility. eBay determines which listings qualify for eBay Plus based on whether the buyer has an active eBay Plus subscription and whether the listing meets the program's requirements. See <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-plus.html" target="_blank">eBay Plus</a> for listing requirements. Contains information about each country where the seller is eligible to offer eBay Plus on listings (one eBayPLUSPreference container per country). eBay Plus is a premium buyer program offering fast, free domestic shipping and free returns on eligible items. eBay Plus is a premium account option for buyers, which provides benefits such as fast and free domestic shipping, and free returns on selected items. Note: Currently, eBay Plus is available only to buyers in Germany and Australia. The seller has no control/responsibility over setting the eBay Plus feature for a listing. Instead, eBay will evaluate/determine whether a listing is eligible for eBay Plus. more details eBay Plus https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-plus.html GetUserPreferences Conditionally This is the base request type for the GeteBayDetails call. This call retrieves the latest eBay feature-related metadata values that are supported when listing items. This metadata includes country codes, currency codes, Item Specifics thresholds, supported Return Policy values, available shipping carriers and shipping service options, and more. This call may be used to keep metadata up-to-date in your applications. In some cases, the data returned in the response will vary according to the eBay site that you use for the request.

This call retrieves the latest eBay feature-related metadata values that are supported when listing items.

One or more DetailName fields may be used to control the the type of metadata that is returned in the response. If no DetailName fields are used, all metadata will be returned in the response. It is a good idea to familiarize yourself with the metadata that can be returned with GeteBayDetails by reading through the enumeration values in <a href="types/DetailNameCodeType.html">DetailNameCodeType</a>. 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. Note: This container is only returned if CountryDetails is included as a DetailName filter in the request, or if no DetailName filters are used 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 Although the supported payment methods for the specified eBay site are returned, it is recommended that the seller use GetCategoryFeatures instead, and pass in PaymentMethods as a FeatureID value in the request. Note: This container is only returned if PaymentOptionDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. 613 613 Avoid Category.PaymentMethod GeteBayDetails Conditionally Lists the cities and other domestic regions for the specified site's country. Note: This container is only returned if RegionDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. GeteBayDetails Conditionally Lists the worldwide regions that can be set as shipping locations from the specified eBay site. 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 that tax jurisdictions are only applicable to the following eBay sites: eBay US (Site ID 0), eBay Canada (Site ID 2), eBay Canada (French) (Site ID 210), and eBay India (Site ID 203). An empty response will be returned for any other Site ID that is passed in the HTTP header. 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 Lists the site's maximum thresholds for specifying 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 worldwide regions and individual countries that can be set as shipping locations from the specified eBay site. Note: This container is only returned if RegionOfOriginDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. 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 supported values that may be used for return policies on the specified eBay site, such as the return period, supported restocking fees, and refund options. 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. Note: This container has been staged for deprecation. Although domestic return policy metadata is still getting returned at the moment, it is recommended that users start making plans to use the GetCategoryFeatures call instead to retrieve category-level, domestic return policy metadata. GeteBayDetails Conditionally 1077 Avoid 1147 GetCategoryFeatures 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 Lists the threshold values that can be passed in through the BuyerRequirementDetails container in the Add/Revise/Relist API calls. Buyer Requirements allow the seller to block buyers who have unpaid item defects, policy violations, low Feedback scores, and/or other undesirable qualities/statistics. Buyer Requirements are set at the seller's account level, but by using a BuyerRequirementDetails container in an Add/Revise/Relist API call, the values in that container will override values set at the account level. Note: This container is only returned if BuyerRequirementDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. GeteBayDetails Conditionally Details the listing features available for the eBay 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 multiple-variation listings (for example, the maximum number of variations per listing). Use GetCategoryFeatures to determine which categories on a site support variations. 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 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. Note: This container is only returned if ExcludeShippingLocationDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. 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 The ProductDetails.ProductIdentifierUnavailableText field contains the actual text that should be passed into the relevant product identification fields (EAN, ISBN, UPC, MPN/Brand) if eBay is prompting/expecting one of these fields in the call request, but the identifiers do not exist/apply for the product. The text will vary based on the listing site. This text should only be used if no product ID exists for the product. If a product identifier value does actually exist for a product, but the seller passes in 'Does not apply' text, that listing may get penalized in search. Note: This container is only returned if ProductDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. GeteBayDetails Conditionally Enables a buyer and seller to leave Feedback for their order partner at the conclusion of a successful order. GetItemsAwaitingFeedback Feedback https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/feedback.html Seller ratings https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/feedback-seller-ratings.html Unique identifier for an eBay 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 comment 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. LeaveFeedback Conditionally Textual comment that explains, clarifies, or justifies the feedback score specified in CommentType. 500 LeaveFeedback Yes Score for the Feedback being left. May be Positive, Neutral, or Negative. Note: Sellers can not leave neutral or negative feedback for buyers. In addition, buyers can not leave neutral or negative feedback within 7 days from the completion of the order for active Power Sellers who have been on eBay for 12 months. LeaveFeedback Withdrawn, IndependentlyWithdrawn Yes Unique identifier for an eBay order line item. 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. The TransactionID value for auction listings is always <code>0</code> since there can be only one winning bidder/one sale for an auction listing. Note: Historically, TransactionID values have been '0' for auction listings, and some developers may have built logic around this. However, non-zero TransactionID values for auction listings started being used for some eBay marketplaces beginning in July 2024, and all eBay marketplaces are expected to start using non-zero TransactionID values for auction listings in the near future. If necessary, developers should update code to handle non-zero transaction IDs for auction transactions. LeaveFeedback Conditionally Specifies the recipient user about whom the Feedback is being left. Note: Effective September 26, 2025, both usernames and public user IDs will be accepted in this field. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. 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.). Seller ratings https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/feedback-seller-ratings.html LeaveFeedback No OrderLineItemID is a unique identifier for an eBay order line item. 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 This field or the ItemDeliveredWithinEDD field should be included if it is the buyer leaving feedback for the seller. This field will inform eBay about whether or not the buyer received the order line item within the estimated delivery date, which is established once a buyer purchases or commits to buy an item. LeaveFeedback No BuyerIndicatedItemArrivedWithinEDDRange, BuyerIndicatedItemNotArrivedWithinEDDRange This field or the ItemArrivedWithinEDDType field should be included if it is the buyer leaving feedback for the seller. This field will inform eBay about whether or not the buyer received the order line item within the estimated delivery date window, which is established once a buyer purchases or commits to buy an item. The value of this field is set to <code>true</code> if the item did arrive within the estimated delivery date, or <code>false</code> if the item arrived past the estimated delivery date. LeaveFeedback Conditionally Base response for the LeaveFeedback call. The response includes a FeedbackID value, which is automatically generated by eBay if the caller is successfully at submitting the Feedback entry. The unique identifier of the Feedback entry that has been submitted by the caller. LeaveFeedback Always Enables the authenticated user to to make a bid on an auction item, propose a Best Offer, or purchase a fixed-price/Buy It Now item. Note that this call cannot be used to purchase items that require immediate payment. Best Offer https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/best-offers.html API License Agreement https://developer.ebay.com/products/license eBay User Agreement https://pages.ebay.com/help/policies/user-agreement.html PlaceOffer API License Agreement Addendum https://developer.ebay.com/cms/files/placeoffer_api_license_addendum_uv_0.pdf API Logo Usage Requirements https://www.ebay.com/help/policies/member-behavior-policies/ebays-intellectual-property-policy?id=4261 Filing a Support Ticket https://developer.ebay.com/my/support/tickets eBay Partner Network https://www.ebaypartnernetwork.com/ This container specifies the type of offer being made for the listing specified in the ItemID field. The Offer.Action is used to set the action that is being taken on the listing. PlaceOffer Yes Unique identifier that identifies the listing for which the action is being submitted. For a multiple-variation listing, you must also identify the specific variation within that listing using the VariationSpecifics container. PlaceOffer Yes If a warning message is generated when the call is made, this BlockOnWarning will block the bid/buy action if set to <code>true</code>. If BlockOnWarning is <code>false</code> or omitted, the bid/buy action is allowed, regardless of whether or not a warning message occurs. False PlaceOffer No Container for affiliate-related tags, which enable the tracking of user activity. If you include the AffiliateTrackingDetails container 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. eBay Partner Network https://partnernetwork.ebay.com PlaceOffer No This container is used to identify a specific variation within a multiple-variation listing identified by the ItemID value. This container is required when attempting to perform an action on a multiple-variation listing. PlaceOffer Conditionally The PlaceOffer response notifies you about the success and result of the call. This container indicates the current bidding/purchase state of the order line item regarding the offer extended using PlaceOffer. The fields that are returned under this container will depend on the attempted action and the results of that action. PlaceOffer Always Unique identifier for an eBay order line item. 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. The TransactionID value for auction listings is always <code>0</code> since there can be only one winning bidder/one sale for an auction listing. Note: Historically, TransactionID values have been '0' for auction listings, and some developers may have built logic around this. However, non-zero TransactionID values for auction listings started being used for some eBay marketplaces beginning in July 2024, and all eBay marketplaces are expected to start using non-zero TransactionID values for auction listings in the near future. If necessary, developers should update code to handle non-zero transaction IDs for auction transactions. 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. 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. PlaceOffer Conditionally Enables a seller to relist a fixed-price listing that has recently ended on a specified eBay site. A seller has to up to 90 days to relist an ended listing. When an item is relisted, it will receive a new ItemID value, but this item will remain on other users' Watch Lists after it is relisted. The seller has the opportunity to make changes to the listing through the Item container, and the seller can also use one or more DeletedField tags to remove an optional field/setting from the listing. RelistItem, VerifyRelistItem Relisting Items https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/relist-item.html Relisting items (eBay Help page) https://pages.ebay.com/help/sell/relist.html The Item container is used to configure the item that will be relisted. If the seller plans to relist the item with no changes, the only field under the Item container that is required is the ItemID field. In the ItemID field, the seller specifies the item that will be relisted. If the seller wishes to change anything else for the listing, the seller should include this field in the call request and give it a new value. If the seller wants to delete one or more optional settings in the listing, the seller should use the DeletedField tag. RelistFixedPriceItem Yes Specifies the name of the field to delete from a listing. See <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/relist-item.html" target="_blank">Relist Items</a> 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). Some data (such as Variation nodes within Variations) can't be deleted by using a DeletedField tag. See the relevant field descriptions for how to delete such data. Case-sensitivity must be taken into account when using a DeletedField tag to delete a field. The value passed into a DeletedField tag must either match the case of the schema element names in the full field path (Item.PictureDetails.PictureURL), or the initial letter of each schema element name in the full field path must be lowercase (item.pictureDetails.pictureURL). Do not change the case of letters in the middle of a field name. For example, item.picturedetails.pictureURL is not allowed. To delete a listing enhancement like 'BoldTitle', specify the value you are deleting; for example, Item.ListingEnhancement[BoldTitle]. RelistFixedPriceItem Conditionally The base response type for the RelistFixedPriceItem call. The response includes the Item ID for the relisted item, the SKU value for the item (if any), listing recommendations (if applicable), the estimated fees for the relisted item (except the transaction fees, which aren't calculated until the item has sold), the start and end times of the listing, and other details. The unique identifier for the relisted item. Note that the ItemID value changes when a listing is relisted, so this will not be the same ItemID value that was passed in the call request. RelistFixedPriceItem Always The seller-defined SKU value for the new listing (if a SKU value exists for the item). Note that variation-level SKU values will not be returned if a multiple-variation listing was relisted. The seller would have to make a GetItem call to get variation-level SKU values. RelistFixedPriceItem Conditionally This container is an array of fees associated with the relisted item. The fees in this container will not include any fees that are based on the purchase price (such as transaction fees) and only come into play when the listing has a sale. All listing fee types are returned, even if those fees are not applicable for the relisted item and are '0.0'. Note: The currency used for all fees returned under the Fees container reflects the currency used for the listing site, and not necessarily in the seller's default/home currency. For example, if a Canadian seller is using the RelistFixedPriceItem call to relist an item on the eBay US site, the currency type shown for each fee will be <code>USD</code> and not <code>CAD</code>. RelistFixedPriceItem Always eBay.com Selling Fees https://www.ebay.com/help/selling/fees-credits-invoices/selling-fees?id=4822 Fees by marketplace https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/fees-by-marketplace.html This timestamp indicates the date and time when the relisted item became active on the eBay site. RelistFixedPriceItem Always Date and time when the relisted item is scheduled to end based on the start time and the listing duration value that was set in the ListingDuration field. If the value of ListingDuration was set to <code>GTC</code> (Good 'Til Cancelled), this value will be set one month ahead of the start time and will be updated if the GTC listing is still alive. GTC listings are automatically renewed each month according to the calendar day. RelistFixedPriceItem Always Unique identifier of the primary eBay category in which the item was relisted. This field is only returned if the Item.CategoryMappingAllowed field was included and set to <code>true</code> in the request and the category ID passed in the Item.PrimaryCategory field was mapped to a new category ID by eBay. If the primary category has not changed or it has expired with no replacement, this field is not returned. 10 RelistFixedPriceItem Conditionally Unique identifier of the secondary eBay category (if one was used) in which the item was relisted. This field is only returned if the Item.CategoryMappingAllowed field was included and set to <code>true</code> in the request and the category ID passed in the Item.SecondaryCategory field was mapped to a new category ID by eBay. If the secondary category has not changed or it has expired with no replacement, this field is not returned. 10 RelistFixedPriceItem Conditionally This field is returned if an eBay special offer or promotion is applicable to the listing. RelistFixedPriceItem Conditionally Provides a list of products recommended by eBay which match the item information provided by the seller. RelistFixedPriceItem Conditionally Enables a seller to relist a listing that has recently ended on a specified eBay site. A seller has to up to 90 days to relist an ended listing. When an item is relisted, it will receive a new ItemID value, but this item will remain on other users' Watch Lists after it is relisted. The seller has the opportunity to make changes to the listing through the Item container, and the seller can also use one or more DeletedField tags to remove an optional field/setting from the listing. RelistFixedPriceItem, VerifyRelistItem Relist Items https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/relist-item.html https://developer.ebay.com/support/kb-article?KBid=1542 Best practices for relisting items Relisting items (eBay Help page) https://pages.ebay.com/help/sell/relist.html The Item container is used to configure the item that will be relisted. If the seller plans to relist the item with no changes, the only field under the Item container that is required is the ItemID field. In the ItemID field, the seller specifies the item that will be relisted. If the seller wishes to change anything else for the listing, the seller should include this field in the call request and give it a new value. If the seller wants to delete one or more optional settings in the listing, the seller should use the DeletedField tag. RelistItem Yes Specifies the name of the field to delete from a listing. See <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/relist-item.html" target="_blank">Relist Items</a> 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). Case-sensitivity must be taken into account when using a DeletedField tag to delete a field. The value passed into a DeletedField tag must either match the case of the schema element names in the full field path (Item.PictureDetails.PictureURL), or the initial letter of each schema element name in the full field path must be lowercase (item.pictureDetails.pictureURL). Do not change the case of letters in the middle of a field name. For example, item.picturedetails.pictureURL is not allowed. To delete a listing enhancement like 'BoldTitle', specify the value you are deleting; for example, Item.ListingEnhancement[BoldTitle]. RelistItem Conditionally The base response type for the RelistItem call. The response includes the Item ID for the relisted item, the SKU value for the item (if any), listing recommendations (if applicable), the estimated fees for the relisted item (except the transaction fees, which aren't calculated until the item has sold), the start and end times of the listing, and other details. The unique identifier for the relisted item. Note that the ItemID value changes when a listing is relisted, so this will not be the same ItemID value that was passed in the call request. RelistItem Always This container is an array of fees associated with the relisted item. The fees in this container will not include any fees that are based on the purchase price (such as transaction fees) and only come into play when the listing has a sale. All listing fee types are returned, even if those fees are not applicable for the relisted item and are '0.0'. Note: The currency used for all fees returned under the Fees container reflects the currency used for the listing site, and not necessarily in the seller's default/home currency. For example, if a Canadian seller is using the RelistItem call to relist an item on the eBay US site, the currency type shown for each fee will be <code>USD</code> and not <code>CAD</code>. RelistItem Always eBay.com Selling Fees https://www.ebay.com/help/selling/fees-credits-invoices/selling-fees?id=4822 Fees by marketplace https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/fees-by-marketplace.html This timestamp indicates the date and time when the relisted item became active on the eBay site. RelistItem Always This timestamp indicates the date and time when the relisted item is scheduled to end on the eBay site. This date/time is calculated by using the StartTime and the listing duration. GTC listings are automatically renewed each month according to the calendar day. RelistItem Always Unique identifier of the primary eBay category in which the item was relisted. This field is only returned if the Item.CategoryMappingAllowed field was included and set to <code>true</code> in the request and the category ID passed in the Item.PrimaryCategory field was mapped to a new category ID by eBay. If the primary category has not changed or it has expired with no replacement, this field is not returned. 10 RelistItem Conditionally Unique identifier of the secondary eBay category (if one was used) in which the item was relisted. This field is only returned if the Item.CategoryMappingAllowed field was included and set to <code>true</code> in the request and the category ID passed in the Item.SecondaryCategory field was mapped to a new category ID by eBay. If the secondary category has not changed or it has expired with no replacement, this field is not returned. 10 RelistItem Conditionally This field is returned if an eBay special offer or promotion is applicable to the listing. RelistItem Conditionally Provides a list of products recommended by eBay which match the item information provided by the seller. RelistItem Conditionally The call enables a user to remove one or more items from their Watch List. A user can view the items that they are currently watching by calling GetMyeBayBuying. The user has the option of removing one or more single-variation listings, one or more product variations within a multiple-variation listing, or removing all items from the Watch List. GetMyeBayBuying The unique identifier of the item to be removed from the user's Watch List. Multiple ItemID fields can be specified in the same request, but note that the RemoveAllItems field or VariationKey container cannot be specified if one or more ItemID fields are used. RemoveFromWatchList Conditionally If this field is included and set to <code>true</code>, then all the items in the user's Watch List are removed. Note that if the RemoveAllItems field is specified, one or more ItemID fields or the VariationKey cannot be used. RemoveFromWatchList Conditionally This container is used if the user want to remove one or more product variations (within a multiple-variation listing) from the Watch List. Note that if the VariationKey container is used, one or more ItemID fields or the RemoveAllItems field cannot be used. RemoveFromWatchList Conditionally The base response type for the RemoveFromWatchList call. The response includes the current count of items on the user's Watch List, as well as the maximum amount of items that can be on the user's Watch List at one time. The current number of items in the user's Watch List (considering that the items specified in the call request were successfully removed). RemoveFromWatchList Always This integer value indicates the maximum number of items allowed in a user's Watch List. The maximum number of items that can be added to a Watch List is 400, but this can vary by eBay marketplace. RemoveFromWatchList Always This call enables the seller to accept or decline a buyer's Best Offer on an item, or make a counter offer to the buyer's Best Offer. A seller can decline multiple Best Offers with one call, but the seller cannot accept or counter offer multiple Best Offers with one call. Best Offers are not applicable to auction listings. Note: Historically, the Best Offer feature has not been available for auction listings, but beginning with Version 1027, sellers in the US, UK, and DE sites are able to offer the Best Offer feature in auction listings. The seller can offer Buy It Now or Best Offer in an auction listing, but not both. GetBestOffers Best Offer https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/best-offers.html The unique identifier of the listing to which the seller is responding to a Best Offer. RespondToBestOffer Yes The unique identifier of a buyer's Best Offer for the order line item. This ID is created once the buyer makes a Best Offer. It is possible that a seller will get multiple Best Offers for an order line item, and if that seller would like to decline multiple/all of the Best Offers with one RespondToBestOffer call, the seller would pass in each of these identifiers in a separate BestOfferID field. However, the seller can only accept or counter offer one Best Offer at a time. RespondToBestOffer Yes The enumeration value that the seller passes in to this field will control whether the seller accepts or make a counter offer to a single buyer's Best Offer, or declines one or more buyers' Best Offers. A seller can decline multiple Best Offers with one call, but the seller cannot accept or counter offer multiple Best Offers with one call. RespondToBestOffer Yes This optional text field allows the seller to provide more details to the buyer about the action being taken against the buyer's Best Offer. 250 RespondToBestOffer Conditionally The seller inserts counter offer price into this field. This field is conditionally required and only applicable when the Action value is set to <code>Counter</code>, The counter offer price cannot exceed the Buy It Now price for a single quantity item. However, the dollar value in this field may exceed the Buy It Now price if the buyer is requesting or the seller is offering multiple quantity of the item (in a multiple-quantity listing). The quantity of the item must be specified in the CounterOfferQuantity field if the seller is making a counter offer. RespondToBestOffer Conditionally The seller inserts the quantity of items in the counter offer into this field. This field is conditionally required and only applicable when the Action value is set to <code>Counter</code>, The counter offer price must be specified in the CounterOfferPrice field if the seller is making a counter offer. This price should reflect the quantity of items in the counter offer. So, if the seller's counter offer 'unit' price is 15 dollars, and the item quantity is '2', the dollar value passed into the CounterOfferPrice field would be <code>30.0</code>. RespondToBestOffer Conditionally This is the base response type for the RespondToBestOffer call. Along with the standard output fields for Trading API calls, this type contains a RespondToBestOffer container that indicates whether or not the action specified in the call request (accept, decline, or counter offer) was successful. The BestOffer.CallStatus value returned in this container will indicate whether or not the action specified in the call request (accept, decline, or counter offer) was successful. The accept and counter offer actions can only be applied toward a single Best Offer. However, multiple Best Offers on a listing can be declined with one call. All Best Offers must be successfully declined with the RespondToBestOffer call for the BestOffer.CallStatus value to be <code>Success</code>. RespondToBestOffer Always Enables a seller 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 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 level, so a Feedback comment for each order 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 the eBay listing to which the user will be responding to Feedback. A listing can have multiple order line items, but only one ItemID value. 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. RespondToFeedback Conditionally Unique identifier for an eBay order line item. 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. The TransactionID value for auction listings is always <code>0</code> since there can be only one winning bidder/one sale for an auction listing. Note: Historically, TransactionID values have been '0' for auction listings, and some developers may have built logic around this. However, non-zero TransactionID values for auction listings started being used for some eBay marketplaces beginning in July 2024, and all eBay marketplaces are expected to start using non-zero TransactionID values for auction listings in the near future. If necessary, developers should update code to handle non-zero transaction IDs for auction transactions. RespondToFeedback No The eBay user ID of the caller's order partner. The caller is either replying to or following up on this user's Feedback comment. Note: Effective September 26, 2025, both usernames and public user IDs will be accepted in this field. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. 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. 500 RespondToFeedback Yes OrderLineItemID is a unique identifier for an eBay order line item. 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. RespondToFeedback Conditionally Base response for the RespondToFeedback. This response will indicate 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. This response has no call-specific output fields. Enables a seller to revise a fixed-price listing on a specified eBay site. To revise an active listing, the seller specifies the ItemID value for the listing. The seller makes one or multiple changes to the listing through the Item container, and the seller can also use one or more DeletedField tags to remove an optional field/setting from the listing. ReviseItem Revise a listing https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/revise-listing.html The Item container is used to make changes to the active listing. The seller must pass in the ItemID value for the listing that is being revised. For anything else that the seller wishes to change, such as quantity or price, the seller should include this field in the call request and give it a new value. If the seller wants to delete one or more optional settings in the listing, the seller should use the DeletedField tag. 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. Some data (such as Variation nodes within the Variations container) can't be deleted by using DeletedField. See the relevant field descriptions for how to delete such data. Use values that match the case of the schema element names (Item.PictureDetails.PictureURL) or make the initial letter of each field name lowercase (item.pictureDetails.pictureURL). However, do not change the case of letters in the middle of a field name. For example, item.picturedetails.pictureUrl 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 The base response type for the ReviseFixedPriceItem call. The response includes the Item ID for the revised item, the SKU value for the item (if any), listing recommendations (if applicable), the estimated fees for the revised item (except the transaction fees, which aren't calculated until the item has sold), the start and end times of the listing, and other details. The unique identifier for the revised listing. Note that the ItemID value does not change when a listing is revised, so this will be the same ItemID value that was passed in the call request. ReviseFixedPriceItem Always The seller-defined SKU value for the revised listing (if a SKU value exists for the item). Note that variation-level SKU values will not be returned if a multiple-variation listing was revised. The seller would have to make a GetItem call to get variation-level SKU values. ReviseFixedPriceItem Conditionally This timestamp indicates the date and time when the listing was created on the eBay site. This value doesn't change when a listing is revised. ReviseFixedPriceItem Always Date and time when the revised listing is scheduled to end based on the listing's start time and the listing duration value that was set for the listing. If the listing duration is 'GTC' (Good 'Til Cancelled), this value will be updated to one month in the future if the listing is automatically renewed after one month. GTC listings are automatically renewed each month according to the calendar day if quantity still exists for the item. ReviseFixedPriceItem Always This container is an array of fees associated with the revised listing. The fees in this container will not include any fees that are based on the purchase price (such as transaction fees) and only come into play when the listing has a sale. All listing fee types are returned, even if those fees are not applicable for the revised listing and are '0.0'. Note: The currency used for all fees returned under the Fees container reflects the currency used for the listing site, and not necessarily in the seller's default/home currency. For example, if a Canadian seller is using the ReviseFixedPriceItem call to relist an item on the eBay US site, the currency type shown for each fee will be <code>USD</code> and not <code>CAD</code>. ReviseFixedPriceItem Always eBay.com Fees http://pages.ebay.com/help/sell/fees.html Fees by marketplace https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/fees-by-marketplace.html Unique identifier of the primary eBay category for the revised listing. This field is returned if the primary category was changed with the revision, and the primary category can only be changed if a fixed-price listing has no sales, and the listing does not end within 12 hours. This field can also be returned if the Item.CategoryMappingAllowed field was included and set to <code>true</code> in the request and the category ID passed in the Item.PrimaryCategory field was mapped to a new category ID by eBay. If the primary category has not changed or it has expired with no replacement, this field is not returned. 10 ReviseFixedPriceItem Conditionally Unique identifier of the secondary eBay category for the revised listing. This field is returned if the secondary category was changed with the revision, and the secondary category can only be changed if a fixed-price listing has no sales, and the listing does not end within 12 hours. This field can also be returned if the Item.CategoryMappingAllowed field was included and set to <code>true</code> in the request and the category ID passed in the Item.PrimaryCategory field was mapped to a new category ID by eBay. If the primary category has not changed or it has expired with no replacement, this field is not returned. 10 ReviseFixedPriceItem Conditionally This field is returned if an eBay special offer or promotion is applicable to the listing. ReviseFixedPriceItem Conditionally Provides a list of products recommended by eBay which match the item information provided by the seller. ReviseFixedPriceItem Conditionally Enables a seller to change the price and/or quantity of one to four active, fixed-price listings. The fixed-price listing to modify is identified with the ItemID of the listing and/or the SKU value of the item (if a seller-defined SKU value exists for the listing). If the seller is modifying one or more variations within a multiple-variation listing, the ItemID and SKU fields in the InventoryStatus container become required, with the ItemID value identifying the listing, and the SKU value identifying the specific product variation within that multiple-variation listing. Each variation within a multiple-variation listing requires a seller-defined SKU value. Whether updating the price and/or quantity of a single-variation listing or a specific variation within a multiple-variation listing, the limit of items or item variations that can be modified with one call is four.

Enables a seller to change the price and/or quantity of one or more fixed-price listings (single-variation or multiple-variation).

ReviseItem Revise a listing https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/revise-listing.html One InventoryStatus container is required for each item or item variation that is being revised. Whether updating the price and/or quantity of a single-variation listing or a specific variation within a multiple-variation listing, the limit of items or item variations that can be modified with one call is four. ReviseInventoryStatus Yes 4 The base response type for the ReviseInventoryStatus call. The response includes a Fees container and an InventoryStatus container for each item and/or item variation that was revised. One InventoryStatus container is returned for each item or item variation that was revised. Whether updating the price and/or quantity of a single-variation listing or a specific variation within a multiple-variation listing, the limit of items or item variations that can be modified with one call is four. Note that the SKU field is returned as an empty tag if it is not defined for a single-variation listing. StartTime, EndTime ReviseInventoryStatus Always 4 A Fees container is returned for each fixed-price listing that was modified with the ReviseInventoryStatus call. This container consists of the estimated listing fees for the revised listing, and the listing is identified in the ItemID field. Each type of fee is returned even if it is not applicable (has a value of <code>0.0</code>. The transaction fees are not in this container, as these values cannot be determined until a sale is made. Note that these fees are at the listing level, so if multiple variations within a multiple-variation listing were modified, the fees in this container would be cumulative totals, and would not single out the fees associated with each modified item variation. Please note that since fees are returned at the listing level, it is possible that the response will include one Fees container and four InventoryStatus containers if you made revisions to four different item variations within the same multiple-variation listing. ReviseInventoryStatus 4 Always eBay.com Fees http://pages.ebay.com/help/sell/fees.html Fees by marketplace https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/fees-by-marketplace.html Fees and credits https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manage-fulfill-complete-sale-fees.html Final Value Fees http://pages.ebay.com/help/sell/fvf.html Enables a seller to revise a listing on a specified eBay site. To revise an active listing, the seller specifies the ItemID value for the listing. The seller makes one or multiple changes to the listing through the Item container, and the seller can also use one or more DeletedField tags to remove an optional field/setting from the listing. After a multiple-quantity, fixed-price listing has one or more sales, or less than 12 hours remain before the listing is scheduled to end, you can not edit the values in the Listing Title, Primary Category, Secondary Category, Listing Duration, and Listing Type fields for that listing. The same applies to an auction listing that has at least one bid. To revise a multiple-variation, fixed-price listing, the ReviseFixedPriceItem call should be used instead, as the ReviseItem call does not support variation-level edits. ReviseFixedPriceItem, ReviseInventoryStatus Revise a listing https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/revise-listing.html The Item container is used to make changes to the active listing. The seller must pass in the ItemID value for the listing that is being revised. For anything else that the seller wishes to change, such as quantity or price, the seller should include this field in the call request and give it a new value. If the seller wants to delete one or more optional settings in the listing, the seller should use the DeletedField tag. ReviseItem 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. Use values that match the case of the schema element names (Item.PictureDetails.PictureURL) or make the initial letter of each field name lowercase (item.pictureDetails.pictureURL). However, do not change the case of letters in the middle of a field name. For example, item.picturedetails.pictureURL 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 No When the VerifyOnly is included and set as <code>true</code>, the active listing is not actually revised, but the same response is returned and the seller gets to see the expected fees based on the changes made, and can also view any listing recommendations if the Item.IncludeRecommedations boolean field is included and set to <code>true</code>. ReviseItem No The base response type for the ReviseItem call. The response includes the Item ID for the revised item, the SKU value for the item (if any), listing recommendations (if applicable), the estimated fees for the revised item (except the transaction fees, which aren't calculated until the item has sold), the start and end times of the listing, and other details. The unique identifier for the revised listing. Note that the ItemID value does not change when a listing is revised, so this will be the same ItemID value that was passed in the call request. ReviseItem Always This timestamp indicates the date and time when the listing was created on the eBay site. This value doesn't change when a listing is revised. ReviseItem Always Date and time when the revised listing is scheduled to end based on the listing's start time and the listing duration value that was set for the listing. If the listing duration is 'GTC' (Good 'Til Cancelled), this value will be updated to one month in the future if the listing is automatically renewed after one month. GTC listings are automatically renewed each month according to the calendar day if quantity still exists for the item. Note: GTC is not applicable to auction listings. ReviseItem Always This container is an array of fees associated with the revised listing. The fees in this container will not include any fees that are based on the purchase price (such as transaction fees) and only come into play when the listing has a sale. All listing fee types are returned, even if those fees are not applicable for the revised listing and are '0.0'. Note: The currency used for all fees returned under the Fees container reflects the currency used for the listing site, and not necessarily in the seller's default/home currency. For example, if a Canadian seller is using the ReviseItem call to relist an item on the eBay US site, the currency type shown for each fee will be <code>USD</code> and not <code>CAD</code>. ReviseItem Always eBay.com Fees http://pages.ebay.com/help/sell/fees.html Fees by marketplace https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/fees-by-marketplace.html Unique identifier of the primary eBay category for the revised listing. This field is returned if the primary category was changed with the revision, and the primary category can only be changed if a fixed-price listing has no sales/auction listing has no bids, and the listing does not end within 12 hours. This field can also be returned if the Item.CategoryMappingAllowed field was included and set to <code>true</code> in the request and the category ID passed in the Item.PrimaryCategory field was mapped to a new category ID by eBay. If the primary category has not changed or it has expired with no replacement, this field is not returned. 10 ReviseItem Conditionally Unique identifier of the secondary eBay category for the revised listing. This field is returned if the secondary category was changed with the revision, and the secondary category can only be changed if a fixed-price listing has no sales/auction listing has no bids, and the listing does not end within 12 hours. This field can also be returned if the Item.CategoryMappingAllowed field was included and set to <code>true</code> in the request and the category ID passed in the Item.PrimaryCategory field was mapped to a new category ID by eBay. If the primary category has not changed or it has expired with no replacement, this field is not returned. 10 ReviseItem Conditionally This field is returned if the VerifyOnly field was included in the call request and set to <code>true</code>. If the listing was revised in 'Verify Only' mode, the active listing is not actually revised, but the same response is returned and the seller gets to see the expected fees based on the changes made, and can also view any listing recommendations if the Item.IncludeRecommedations boolean input field was included and set to <code>true</code>. ReviseItem Conditionally This field is returned if an eBay special offer or promotion is applicable to the listing. ReviseItem Conditionally Provides a list of products recommended by eBay which match the item information provided by the seller. ReviseItem Conditionally This call can be used to mark one or more messages as 'Read', to flag one or more messages, and/or to move one or more messages to another My Messages folder. Any of these actions can be applied on up to 10 messages with one call. GetMyMessages This container is used to specify up to 10 messages (specified with their MessageID values) on which to perform on or more actions. At least one MessageID value must be included in the request. MessageID values can be retrieved with the GetMyMessages call with the DetailLevel value set to <code>ReturnHeaders</code>. Note: Messages in the Sent folder of My Messages cannot be moved, marked as read, or flagged. ReviseMyMessages Yes This boolean field is used to change the 'Read' status of the message(s) in the MessageIDs container. Including this field and setting its value to <code>true</code> will mark all messages in the MessageIDs container as 'Read'. Conversely, including this field and setting its value to <code>false</code> will mark all messages in the MessageIDs container as 'Unread'. The 'Read' status of a message can be retrieved by looking at the Message.Read boolean field of the GetMyMessages call response. In each ReviseMyMessages call, at least one of the following fields must be specified in the request: Read, Flagged, and FolderID. Note: Messages in the Sent folder of My Messages cannot be moved, marked as read, or flagged. ReviseMyMessages Conditionally This boolean field is used to change the 'Flagged' status of the message(s) in the MessageIDs container. Including this field and setting its value to <code>true</code> will flag all messages in the MessageIDs container. Conversely, including this field and setting its value to <code>false</code> will unflag all messages in the MessageIDs container. The 'Flagged' status of a message can be retrieved by looking at the Message.Flagged boolean field of the GetMyMessages call response. In each ReviseMyMessages call, at least one of the following fields must be specified in the request: Read, Flagged, and FolderID. Note: Messages in the Sent folder of My Messages cannot be moved, marked as read, or flagged. ReviseMyMessages Conditionally A unique identifier of My Messages folder. A FolderID value is supplied if the user want to move the message(s) in the MessageIDs container to a different folder. FolderID values can be retrieved with the GetMyMessages call with the DetailLevel value set to <code>ReturnSummary</code>. In each ReviseMyMessages call, at least one of the following fields must be specified in the request: Read, Flagged, and FolderID. Note: Messages in the Sent folder of My Messages cannot be moved, marked as read, or flagged. ReviseMyMessages Conditionally The response of a ReviseMyMessages call only includes the standard response fields for Trading API calls, such as the Ack field (to indicate the success or failure of the call), the timestamp, and an Errors container (if there were any errors and/or warnings). This call can be used to add, remove, or rename a custom folder in My eBay Messages. Note that the Inbox and Sent folders cannot be removed or renamed in My eBay Messages. A user can have up to 10 custom folders in My eBay Messages, and it is possible to add, remove, or rename up to 10 custom folders with one ReviseMyMessagesFolders call GetMyMessages This required field is used to indicate the type of operation to perform (add, remove, or rename a folder). See the enumeration descriptions below for more information on the usage, requirements, and limitations on each operation. ReviseMyMessagesFolders Yes The eBay-generated unique identifier for a custom folder in My eBay Messages. The FolderID value is required for the 'Rename' and 'Remove' operations, but not for the 'Display' (add) operation. FolderID values can be retrieved by calling GetMyMessages with a DetailLevel value set to <code>ReturnSummary</code>, or the FolderID value for a My eBay Messages folder can be seen at the end of the browser's URL field when you navigate to that folder in My eBay Messages. Note: If multiple folders will be renamed with one call, the user must pay close attention to the order of the FolderID and FolderName fields, as eBay will process these requests in order according to the placement of the the FolderID and FolderName fields. So, the existing folder identified by the first FolderID field in the request payload will get renamed to the folder name passed into the first FolderName field in the request payload, and so on. 10 ReviseMyMessagesFolders Conditionally The user-specified name of the My eBay Messages folder. The FolderName value is required for the 'Display' (add) and 'Rename' operations, but not for the 'Remove' operation. In a 'Display' (add) operation, the name passed into the FolderName field is the name of the new folder. In a 'Rename' operation, the name passed into the FolderName field will be the new name of the existing folder that is specified through the corresponding FolderID field. FolderName values can be retrieved by calling GetMyMessages with a DetailLevel value set to <code>ReturnSummary</code>, or the FolderName value for a My eBay Messages folder can be seen when you navigate to My eBay Messages. Note: If multiple folders will be renamed with one call, the user must pay close attention to the order of the FolderID and FolderName fields, as eBay will process these requests in order according to the placement of the the FolderID and FolderName fields. So, the existing folder identified by the first FolderID field in the request payload will get renamed to the folder name passed into the first FolderName field in the request payload, and so on. 15 10 ReviseMyMessagesFolders Conditionally The response of a ReviseMyMessagesFolders call only includes the standard response fields for Trading API calls, such as the Ack field (to indicate the success or failure of the call), the timestamp, and an Errors container (if there were any errors and/or warnings). Revokes a token before it would otherwise expire. Cancels notification subscriptions for the user/application if set to true. Default value is false. RevokeToken No The response of a RevokeToken call only includes the standard response fields for Trading API calls, such as the Ack field (to indicate the success or failure of the call), the timestamp, and an Errors container (if there were any errors and/or warnings). This call enables a seller to send an order invoice to a buyer. Optionally, and when applicable, this call can also be used to update the shipping service options available for shipment, to provide payment or checkout instructions to the buyer, to make a cost adjustment for the order/order line item, or to provide one or more offline payment methods (for orders where offline payment is an option). Unique identifier of the eBay listing. Unless OrderID or OrderLineItemID is provided in the request, the ItemID value (or SKU value) is conditionally required and must be paired with the corresponding TransactionID value to identify an order line item. For a multiple line item order, OrderID should be used. SendInvoice Conditionally Unique identifier for an eBay sales transaction. This identifier is created once there is a commitment from a buyer to purchase an item. Since an auction listing can only have one sales transaction during the duration of the listing, the TransactionID value for auction listings is always <code>0</code>. Note: Historically, TransactionID values have been '0' for auction listings, and some developers may have built logic around this. However, non-zero TransactionID values for auction listings started being used for some eBay marketplaces beginning in July 2024, and all eBay marketplaces are expected to start using non-zero TransactionID values for auction listings in the near future. If necessary, developers should update code to handle non-zero transaction IDs for auction transactions. Unless OrderID or OrderLineItemID is provided in the request, the TransactionID value is required and must be paired with the corresponding ItemID value to identify an order line item. For a multiple line item order, OrderID should be used. SendInvoice Conditionally A unique identifier that identifies a single line item or multiple line item order. Unless the ItemID value (or SKU value) and corresponding TransactionID value, or the OrderLineItemID value is provided in the request to identify a single line item order, the OrderID value must be specified. If OrderID value is specified, OrderLineItemID, ItemID, TransactionID, and SKU fields are ignored if present in the same request. Note: Note that the unique identifier of a 'non-immediate payment' order will change as it goes from an unpaid order to a paid order. Due to this scenario, all Trading API calls that accept Order ID values as filters in the request payload will support the identifiers for both unpaid and paid orders. Sellers can check to see if an order has been paid by looking for a value of <code>Complete</code> in the CheckoutStatus.Status field in the response of GetOrders call, or in the Status.CompleteStatus field in the response of GetItemTransactions or GetSellerTransactions call. Sellers should not fulfill orders until buyer has made payment. 40 SendInvoice Conditionally If the buyer has an international shipping address, use this container to offer up to four international shipping service options (or five if one of the shipping service options is Global Shipping Program or eBay International Shipping). If one or more international shipping service options are offered through this container, the (domestic) ShippingServiceOptions container should not be included in the same request. SendInvoice No If the buyer has a domestic shipping address, use this container to offer up to four domestic shipping service options. If one or more domestic shipping service options are offered through this container, the InternationalShippingServiceOptions container should not be included in the same request. SendInvoice No This container is used if the seller wishes to apply sales tax to the order if the buyer lives in a state/jurisdiction where sales tax is not already collected automatically by eBay and remitted to the tax authority. The amount of sales tax applied to the 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 and handling. Note: Buyers in all 50 US states and DC are automatically charged sales tax for eBay purchases, and eBay collects and remits this sales tax to the proper taxing authority on the buyer's behalf. Because of this, if a sales tax percentage rate is applied to a listing by a seller in one of these states, this field will be ignored during the checkout process. Currently, sales tax percentage rates can only be specified by sellers in Canada and 5 US territories, including American Samoa (AS), Guam (GU), Northern Mariana Islands (MP), Palau (PW), and Virgin Islands (VI). SendInvoice No This field should only be used if the seller needs to add one or more offline payment options for an order that requires/supports offline payment. A seller should not submit any online payment methods here since eBay now controls the available online payment options that are available to buyers, and not the seller. SendInvoice No This field allows the seller to provide a message or instructions regarding checkout/payment, or the return policy. 500 SendInvoice No This field is included and set to <code>true</code> if the seller wishes to receive an email copy of the invoice sent to the buyer. true SendInvoice No 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 order, OrderID must be used. This field should only be used if the Item.InventoryTrackingMethod field (set with the AddFixedPriceItem or RelistFixedPriceItem calls) is set to <code>SKU</code>. 50 SendInvoice Conditionally A unique identifier for an eBay order line item. This identifier is created as soon as there is a commitment to buy (bidder wins the auction, buyer clicks buy button, or buyer purchases item through PlaceOffer call). 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 order, the OrderLineItemID must be specified. For a multiple line item order, OrderID should be used. If OrderLineItemID is specified, ItemID, TransactionID, and SKU are ignored if present in the same request. 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 The response of a SendInvoice call only includes the standard response fields for Trading API calls, such as the Ack field (to indicate the success or failure of the call), the timestamp, and an Errors container (if there were any errors and/or warnings). 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 This container can be used to set customized ASQ subjects, or it can be used to reset the ASQ subjects to the eBay defaults. Up to nine customized ASQ subjects can be set. SetMessagePreferences Yes The response of a SetMessagePreferences call only includes the standard response fields for Trading API calls, such as the Ack field (to indicate the success or failure of the call), the timestamp, and an Errors container (if there were any errors and/or warnings). Manages notification and alert preferences for applications and users. GetNotificationPreferences Platform Notifications Guide https://developer.ebay.com/api-docs/static/platform-notifications-landing.html 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 The response of a SetNotificationPreferences call only includes the standard response fields for Trading API calls, such as the Ack field (to indicate the success or failure of the call), the timestamp, and an Errors container (if there were any errors and/or warnings). This call enables a seller to create and manage shipping discounts rules. These are the same shipping discount rules that can be created or managed in My eBay Shipping Preferences. The types of shipping discount rules that can be created and managed with this call include flat-rate shipping rules, calculated shipping rules, and promotional shipping rules. This call can also be used by sellers to set whether or not they allow buyers to combine separate line items into one Combined Invoice order, and how many days they allow buyers to perform that action. A seller can only create, update, or delete one discount rule type with each call. The action to take (either <code>Add</code>, <code>Update</code>, or <code>Delete</code>) is set and controlled with the ModifyActionCode field. GetShippingDiscountProfiles Shipping discount profiles https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-discount-profiles.html The three-digit code of the currency to be used for shipping discounts on Combined Invoice 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. This field is required if the user is adding or updating one or more shipping discount profiles. Note that There is a currencyID attribute on all SetShippingDiscountProfiles elements involving money. To avoid a call error, be sure to use the same currency type in these attributes as what is set for the CurrencyID field. SetShippingDiscountProfiles Conditionally This field is used to specify the number of days after the purchase of an item that the buyer or seller can combine multiple and mutual order line items into one Combined Invoice order. In a Combined Invoice order, the buyer makes one payment for all order line items, hence only unpaid order line items can be combined into a Combined Invoice order. SetShippingDiscountProfiles Yes This field is used to set which action is being taken (<code>Add</code>, <code>Update</code>, or <code>Delete</code>) in the call. If you are adding a shipping discount rule, you will have to supply a name for that shipping discount profile. If you want to update or delete a shipping discount profile, you'll have to provide the unique identifier of this rule through the corresponding containers. The unique identifiers of these rules can be retrieved with the GetShippingDiscountRules call, or the seller can view these identifiers in My eBay Shipping Preferences. SetShippingDiscountProfiles Yes This container allows you to create, update, or delete a flat-rate shipping discount profile. SetShippingDiscountProfiles No This container allows you to create, update, or delete a calculated shipping discount profile. SetShippingDiscountProfiles No This container allows you to create, update, or delete a calculated handling discount profile. SetShippingDiscountProfiles No This container allows you to create, update, or delete a promotional shipping discount profile. SetShippingDiscountProfiles No The response of a SetShippingDiscountProfiles call only includes the standard response fields for Trading API calls, such as the Ack field (to indicate the success or failure of the call), the timestamp, and an Errors container (if there were any errors and/or warnings). This call allows you to set or modify the category structure of an eBay Store. Sellers must have an eBay Store subscription in order to use this call. Manage store categories https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/store-categories.html Specifies the type of action (Add, Move, Delete, or Rename) to carry out for the specified eBay Store 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 Base response of the SetStoreCategories call. Returns the status of the eBay Store category changes. 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 an eBay Store category structure change is processed synchronously, the status is returned as 'Complete' or 'Failed'. For asynchronously processed changes, the status is reported as 'InProgress' or 'Pending'. Use GetStoreCategoryUpdateStatus to monitor the status of asynchronously processed changes. SetStoreCategories Always Contains hierarchy data for eBay Store categories that you have created/modified. SetStoreCategories Always This call allows you to add or modify sales tax rates for one or more tax jurisdictions within the specified site. Any additions or modifications made with this call is saved in the seller's Sales Tax Table in My eBay. Sales Tax Tables are only supported on the US and Canada (English and French versions) sites, so this call is only applicable to those sites. To view their current Sales Tax Table, a seller may go to the Sales Tax Table in My eBay, or they can make a GetTaxTable call. GetTaxTable Multi-jurisdiction sales tax https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/taxes.html This table is used to set or modify sales tax rates for one or more tax jurisdictions within that country. A TaxJurisdiction container is required for each tax jurisdiction that is being added/updated. SetTaxTable Yes The response of a SetTaxTable call only includes the standard response fields for Trading API calls, such as the Ack field (to indicate the success or failure of the call), the timestamp, and an Errors container (if there were any errors and/or warnings). Enables users to add, modify, or delete a pinned note for any item that is being tracked in the My eBay All Selling and All Buying areas. Unique identifier of the listing to which the My eBay note will be attached. Notes can only be added to items that are currently being tracked in My eBay. 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 an existing user note. SetUserNotes Yes This field is needed if the Action is <code>AddOrUpdate</code>. The text supplied in this field will completely replace any existing My eBay note for the specified item. 255 SetUserNotes Conditionally Unique identifier for the order line item 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. The TransactionID value for auction listings is always <code>0</code> since there can be only one winning bidder/one sale for an auction listing. Note: Historically, TransactionID values have been '0' for auction listings, and some developers may have built logic around this. However, non-zero TransactionID values for auction listings started being used for some eBay marketplaces beginning in July 2024, and all eBay marketplaces are expected to start using non-zero TransactionID values for auction listings in the near future. If necessary, developers should update code to handle non-zero transaction IDs for auction transactions. SetUserNotes No Container consisting of name-value pairs that identify (match) one variation within a fixed-price, multiple-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, multiple- 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. 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. SetUserNotes Conditionally The response of a SetUserNotes call only includes the standard response fields for Trading API calls, such as the Ack field (to indicate the success or failure of the call), the timestamp, and an Errors container (if there were any errors and/or warnings). This call allows an eBay user to set/modify numerous seller account preferences. GetUserPreferences User preferences https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/user-mgmt-prefs.html This container is included if the seller wishes to receive contact information for unsuccessful bidders. This preference is only applicable for auction listings. SetUserPreferences No This container is included if the seller wishes to set the preference for allowing Combined Invoice orders for cases where the buyer has multiple unpaid order line items from the same seller. SetUserPreferences No This container is included if the seller wishes to set various payment preferences. One or more preferences may be set or modified under this container. Payment preferences specified in a SetUserPreferences call override the settings in My eBay payment preferences. SetUserPreferences No This container is included if the seller wishes to set 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 container. SetUserPreferences No This container is included if the seller wishes to set 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 container. These preferences are only applicable for auction listings. SetUserPreferences No This field is included and set to <code>true</code> if the seller wishes to email the shipment's tracking number to the buyer. false SetUserPreferences No This field is included and set to <code>true</code> if the seller wishes to require the buyer to provide a shipping phone number upon checkout. Some shipping carriers require the receiver's phone number. false SetUserPreferences No This container is included if the seller wishes to set or modify Unpaid Item preferences. The Unpaid Item preferences automatically opens an Unpaid Item case on the behalf of the seller if the buyer has not paid for the order after a specified number of days. One or more preferences may be set or modified under this container. 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 This container is included if the seller wishes to set the preference for sending a purchase reminder email to buyers. SetUserPreferences No This container is included if the seller wishes to set/modify the order cut off time 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 the DispatchCutoffTimePreference.CutoffTime field. Note: For sellers opted in to the feature that supports different order cut off times for each business day, this container cannot be used to change the order cut off for one or more business days. If this container is used, it will have no effect on any of the order cut off times configured for the seller. In order for the seller to change and/or confirm the actual order cutoff times for same-day handling, that seller should go to Shipping Preferences in My eBay. SetUserPreferences No Same day handling https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-handling-same-day.html details about dispatch cut off times If this flag is included and set to <code>true</code>, the seller's new listings will enable the Global Shipping Program by default. Note: This field is ignored for sellers who are not opted in to the Global Shipping Program (when GetUserPreferences returns OfferGlobalShippingProgramPreference with a value of <code>false</code>). false SetUserPreferences No If this flag is included and set to <code>true</code>, and the seller specifies an international shipping service to a particular country for a given listing, the specified service will take precedence and be the listing's default international shipping option for buyers in that country, rather than the Global Shipping Program. The Global Shipping Program will still be the listing's default option for shipping to any Global Shipping-eligible country for which the seller does not specify an international shipping service. If this flag is set to <code>false</code>, the Global Shipping Program will be each Global Shipping-eligible listing's default option for shipping to any Global Shipping-eligible country, regardless of any international shipping service that the seller specifies for the listing. false SetUserPreferences No If this flag is included and set to <code>true</code>, it enables the Out-of-Stock feature. A seller would use this feature to keep Fixed-Price GTC (Good 'Til Canceled) listings alive even when the "quantity available" value goes to 0 (zero). This is useful when waiting for additional stock and eliminates the need to end the listing and then recreating it when stock arrives. While the "quantity available" value is 0, the listing would be hidden from eBay search and if that item was specifically searched for with GetItem (or related call), the element HideFromSearch would be returned as 'true' and ReasonHideFromSearch would be returned as 'OutOfStock'. When stock is available, the seller can use the Revise calls to update the inventory of the item (through the Item.Quantity or Item.Variations.Variation.Quantity fields) and the listing would appear again. You can return the value of this flag using the <a href="https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetUserPreferences.html#Request.ShowOutOfStockControlPreference">GetUserPreferences</a> call and setting the ShowOutOfStockControlPreference field to 'true'. IMPORTANT: When a listing using the Out-of-Stock feature has zero quantity, the seller has 90 days to add inventory without incurring a listing fee. Fees are changed at the end of each the billing cycle but are then refunded if the item is out-of-stock for an entire billing period. See <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/out-of-stock-fees.html">Fees For a Listing With Zero Quantity</a> for details. false SetUserPreferences No Out-of-Stock control https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/out-of-stock.html The response of a SetUserPreferences call only includes the standard response fields for Trading API calls, such as the Ack field (to indicate the success or failure of the call), the timestamp, and an Errors container (if there were any errors and/or warnings). Uploads a picture to the eBay Picture Service and returns a URL of the picture. You will use this URL when creating, revising, or relisting an item with the Trading API. Add pictures https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/pictures.html Include pictures for variations https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/variations.html#pix A seller-defined name for the picture. This field is optional, but can make it easier for a seller to track than an arbitrary, eBay-assigned URL. 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 This enumeration value indicates the size of the picture that will be generated. IMPORTANT: To get the standard website image sizing with Zoom, set this field to Supersize. 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 the 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. UploadSiteHostedPictures No Determines if the uploaded picture is to replace all the pictures or to be added to the pictures currently available to a seller on the eBay site. The picture is available to the seller on the My Picture Uploads tab within the Sell Your Item pages. The picture you upload (and its URL) is stored for a period of time on the EPS server. If, within that time, the picture is associated with an item, then the picture persists on the eBay site for the same time length as other pictures uploaded using the UploadSiteHostedPictures call. The expiration date of the picture is returned in the SiteHostedPictureDetails.UseByDate field in the response. UploadSiteHostedPictures No This field is used if the seller wishes to upload a picture to the EPS server that is currently on another external site. The URL of the picture you want to upload is passed in this field. Only https:// servers are supported. You can include only one ExternalPictureURL field per call. The eBay server uses the information in this field to retrieve a picture from an external web server. Once retrieved, the picture will be copied to eBay Picture Services and retained for 30 days if not associated with a listing. When associated with a listing, the duration is the length of the listing plus 90 days. 1024 UploadSiteHostedPictures Conditionally 1 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 The information about an UploadSiteHostedPictures upload, including the URL of the uploaded picture. UploadSiteHostedPictures Always Enables a seller to test the definition of a new fixed-price listing by submitting the definition to eBay without creating an actual listing. AddFixedPriceItem List an item https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/list-item.html 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 transaction fees, which aren't calculated until the item has sold), and other details. With a successful VerifyAddFixedPriceItem call, this field is always returned, but the returned value is always <code>0</code>, since this call only validates the data passed in through the request payload and does not actually create an active listing. 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). VerifyAddFixedPriceItem Conditionally This container is an array of fees that would incur if the listing defined in request payload of the VerifyAddFixedPriceItem call was published. The fees in this container will not include any fees that are based on the purchase price (such as transaction fees) and only come into play when the listing has a sale. All listing fee types are returned, even if those fees are not applicable for the listing and are '0.0'. Note: The currency used for all fees returned under the Fees container reflects the currency used for the listing site, and not necessarily in the seller's default/home currency. For example, if a Canadian seller is using the VerifyAddFixedPriceItem call to verify a listing on the eBay US site, the currency type shown for each fee will be <code>USD</code> and not <code>CAD</code>. VerifyAddFixedPriceItem Always eBay.com Fees http://pages.ebay.com/help/sell/fees.html Fees by marketplace https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/fees-by-marketplace.html ID of the primary category in which the item would be 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. 10 VerifyAddFixedPriceItem Conditionally ID of the secondary category in which the item would be 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 VerifyAddFixedPriceItem Conditionally The nature of the discount, if a discount would have applied had this actually been listed at this time. VerifyAddFixedPriceItem Conditionally Enables a seller to specify the definition of a new item and submit the definition to eBay without creating a listing. Sellers who engage in cross-border trade on sites that require a recoupment agreement, must agree to the recoupment terms before adding or verifying items. This agreement allows eBay to reimburse a buyer during a dispute and then recoup the cost from the seller. The US site is a recoupment site, and the agreement is located <a href="https://scgi.ebay.com/ws/eBayISAPI.dll?CBTRecoupAgreement">here</a>. The list of the sites where a user has agreed to the recoupment terms is returned by the GetUser response. AddItem, VerifyAddFixedPriceItem List an item https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/list-item.html Root container holding all values that define a new listing. VerifyAddItem Yes Returns the listing recommendations (if applicable), the estimated fees for the proposed new listing (except the transaction fees, which aren't calculated until the item has sold), and other details. With a successful VerifyAddItem call, this field is always returned, but the returned value is always <code>0</code>, since this call only validates the data passed in through the request payload and does not actually create an active listing. VerifyAddItem Always This container is an array of fees that would incur if the listing defined in request payload of the VerifyAddItem call was published. The fees in this container will not include any fees that are based on the purchase price (such as transaction fees) and only come into play when the listing has a sale. All listing fee types are returned, even if those fees are not applicable for the listing and are '0.0'. Note: The currency used for all fees returned under the Fees container reflects the currency used for the listing site, and not necessarily in the seller's default/home currency. For example, if a Canadian seller is using the VerifyAddItem call to verify a listing on the eBay US site, the currency type shown for each fee will be <code>USD</code> and not <code>CAD</code>. VerifyAddItem Always eBay.com Fees http://pages.ebay.com/help/sell/fees.html Fees by marketplace https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/fees-by-marketplace.html ID of the primary category in which the item would be 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. 10 VerifyAddItem Conditionally ID of the secondary category in which the item would be 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 VerifyAddItem Conditionally The nature of the discount, if a discount would have applied had this actually been listed at this time. VerifyAddItem Conditionally Provides a list of products recommended by eBay which match the item information provided by the seller. VerifyAddItem Conditionally Simulates the creation of a new Second Chance Offer listing of an item without actually creating a listing. GetAllBidders, AddSecondChanceItem Second chance offers https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/second-chance.html 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. Note: Effective September 26, 2025, both usernames and public user IDs will be accepted in this field. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. VerifyAddSecondChanceItem Yes Specifies the amount the offer recipient must pay to purchase the item from the Second Chance Offer listing. Use only when the original item was an eBay Motors (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. Call fails with an error for any other item conditions. VerifyAddSecondChanceItem 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. VerifyAddSecondChanceItem Yes This field is used to identify the recently-ended auction listing for which a Second Chance Offer will be made to one of the non-winning bidders on the recently-ended auction listing. VerifyAddSecondChanceItem 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 VerifyAddSecondChanceItem No Base response of the VerifyAddSecondChanceItem call. Indicates the date and time when the the new Second Chance Offer listing became active and the recipient user could purchase the item. VerifyAddSecondChanceItem 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). VerifyAddSecondChanceItem Always Enable the seller to verify that the data they plan to pass into a RelistItem call will produce the results that you are expecting, including a successful call with no errors. RelistItem The Item container is used to configure the item that will be relisted. If the seller plans to relist the item with no changes, the only field under the Item container that is required is the ItemID field. In the ItemID field, the seller specifies the item that will be relisted. If the seller wishes to change anything else for the listing, the seller should include this field in the call request and give it a new value. If the seller wants to delete one or more optional settings in the listing, the seller should use the DeletedField tag. VerifyRelistItem Yes Specifies the name of the field to delete from a listing. See the eBay Features 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). Case-sensitivity must be taken into account when using a DeletedField tag to delete a field. The value passed into a DeletedField tag must either match the case of the schema element names in the full field path (Item.PictureDetails.PictureURL), or the initial letter of each schema element name in the full field path must be lowercase (item.pictureDetails.pictureURL). Do not change the case of letters in the middle of a field name. For example, item.picturedetails.pictureURL is not allowed. To delete a listing enhancement like 'BoldTitle', specify the value you are deleting; for example, Item.ListingEnhancement[BoldTitle]. VerifyRelistItem Conditionally The base response type for the VerifyRelistItem call. The response includes the Item ID for the relisted item, the SKU value for the item (if any), listing recommendations (if applicable), the estimated fees for the relisted item (except the transaction fees, which aren't calculated until the item has sold), the start and end times of the listing, and other details. With a successful VerifyRelistItem call, this field is always returned, but the returned value is always <code>0</code>, since this call only validates the data passed in through the request payload and does not actually relist an item. VerifyRelistItem Always This container is an array of fees that would incur if the listing defined in request payload of the VerifyRelistItem call was used to relist an item. The fees in this container will not include any fees that are based on the purchase price (such as transaction fees) and only come into play when the listing has a sale. All listing fee types are returned, even if those fees are not applicable for the listing and are '0.0'. Note: The currency used for all fees returned under the Fees container reflects the currency used for the listing site, and not necessarily in the seller's default/home currency. For example, if a Canadian seller is using the VerifyRelistItem call to verify an item to be relisted on the eBay US site, the currency type shown for each fee will be <code>USD</code> and not <code>CAD</code>. VerifyRelistItem Always eBay.com Fees http://pages.ebay.com/help/sell/fees.html Fees by marketplace https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/fees-by-marketplace.html This timestamp indicates the date and time when the item to be relisted became active on the eBay site. VerifyRelistItem Always This timestamp indicates the date and time when the item to be relisted is scheduled to end on the eBay site. This date/time is calculated by using the StartTime and the the listing duration. VerifyRelistItem Always This field is returned if an eBay special offer or promotion is applicable to the listing. VerifyRelistItem Conditionally Provides a list of products recommended by eBay which match the item information provided by the seller. VerifyRelistItem Conditionally Base type definition of the request payload, which can carry any type of payload content plus optional versioning information and detail level requirements. All concrete request types (e.g., AddItemRequestType) are derived from the abstract request type. The naming convention we use for the concrete type names is the name of the service (the verb or call name) followed by "RequestType": VerbNameRequestType Detail levels are instructions that define standard subsets of data to return for particular data components (e.g., each Item, Transaction, or User) within the response payload. For example, a particular detail level might cause the response to include buyer-related data in every result (e.g., for every Item), but no seller-related data. Specifying a detail level is like using a predefined attribute list in the SELECT clause of an SQL query. Use the DetailLevel element to specify the required detail level that the client application needs pertaining to the data components that are applicable to the request. The DetailLevelCodeType defines the global list of available detail levels for all request types. Most request types support certain detail levels or none at all. If you pass a detail level that exists in the schema but that isn't valid for a particular request, eBay ignores it and processes the request without it. For each request type, see the detail level tables in the Input/Output Reference to determine which detail levels are applicable and which elements are returned for each applicable detail level. Note that DetailLevel is required input for GetMyMessages. With GetSellerList and other calls that retrieve large data sets, please avoid using ReturnAll when possible. For example, if you use GetSellerList, use GranularityLevel instead, or use GetSellerEvents. If you do use 'ReturnAll' with GetSellerList, use a small Pagination.EntriesPerPage value and a narrow EndTimeFrom/EndTimeTo date range for better performance. Yes GetMyMessages ReturnSummary, ReturnHeaders, ReturnMessages Yes GetAdFormatLeads GetBestOffers GetFeedback GetOrders GetSellerEvents GetTaxTable ReturnAll, none No GetCategoryFeatures GetMyeBayBuying GetMyeBaySelling GetUser ReturnAll, ReturnSummary, none No GetItemTransactions GetSellerList GetSellerTransactions ItemReturnDescription, ReturnAll, none No GetItem ItemReturnAttributes, ItemReturnDescription, ReturnAll, none No Use ErrorLanguage to return error strings for the call in a different language from the language commonly associated with the site that the requesting user is registered with. Below are some examples from different countries. <table border="0"> <tr> <th>ID</th> <th>Country</th> </tr> <tr> <td>en_AU</td> <td>Australia</td> </tr> <tr> <td>de_AT</td> <td>Austria</td> </tr> <tr> <td>nl_BE</td> <td>Belgium (Dutch)</td> </tr> <tr> <td>fr_BE</td> <td>Belgium (French)</td> </tr> <tr> <td>en_CA</td> <td>Canada</td> </tr> <tr> <td>fr_CA</td> <td>Canada (French)</td> </tr> <tr> <td>zh_CN</td> <td>China</td> </tr> <tr> <td>fr_FR</td> <td>France</td> </tr> <tr> <td>de_DE</td> <td>Germany</td> </tr> <tr> <td>zh_HK</td> <td>Hong Kong</td> </tr> <tr> <td>en_IN</td> <td>India</td> </tr> <tr> <td>en_IE</td> <td>Ireland</td> </tr> <tr> <td>it_IT</td> <td>Italy</td> </tr> <tr> <td>nl_NL</td> <td>Netherlands</td> </tr> <tr> <td>en_SG</td> <td>Singapore</td> </tr> <tr> <td>es_ES</td> <td>Spain</td> </tr> <tr> <td>de_CH</td> <td>Switzerland</td> </tr> <tr> <td>en_GB</td> <td>United Kingdom</td> </tr> <tr> <td>en_US</td> <td> United States</td> </tr> </table> No Most Trading API calls support a MessageID element in the request and a CorrelationID element in the response. If you pass in a MessageID in a request, the same value will be returned in the CorrelationID field in the response. Pairing these values can help you track and confirm that a response is returned for every request and to match specific responses to specific requests. If you do not pass a MessageID value in the request, CorrelationID is not returned. No The version number of the API code that you are programming against (e.g., 1149). The version you specify for a call has these basic effects: <ul> <li>It indicates the version of the code lists and other data that eBay should use to process your request.</li> <li>It indicates the schema version you are using.</li> </ul> You need to use a version that is greater than or equal to the lowest supported version. For the SOAP API: If you are using the SOAP API, this field is required. Specify the version of the WSDL your application is using. For the XML API: If you are using the XML API, this field has no effect. Instead, specify the version in the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header. (If you specify Version in the body of an XML API request and it is different from the value in the HTTP header, eBay returns an informational warning that the value in the HTTP header was used instead.) Conditionally HTTP headers https://developer.ebay.com/api-docs/user-guides/static/make-a-call/using-xml.html#headers eBay Schema Versioning Strategy ../../HowTo/eBayWS/eBaySchemaVersioning.html Lowest Supported Version ../../HowTo/eBayWS/eBaySchemaVersioning.html#VersionSupportSchedule The public IP address of the machine from which the request is sent. Your application captures that IP address and includes it in a call request. eBay evaluates requests for safety (also see the BotBlock container in the request and response of this call). PlaceOffer Yes 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 Getting Tokens https://developer.ebay.com/DevZone/guides/features-guide/Basics/Tokens.html Error tolerance level for the call. This is a preference that specifies how eBay should handle requests that contain invalid data or that could partially fail. This gives you some control over whether eBay returns warnings or blocking errors and how eBay processes the invalid data. This field is only applicable to AddItem and related calls, and only when the listing includes ProductListingDetails. AddItem AddItems AddLiveAuctionItem RelistItem ReviseItem ReviseLiveAuctionItem VerifyAddItem BestEffort No Pre-filling Item Specifics with Product Details https://developer.ebay.com/DevZone/guides/features-guide/Development/ItemSpecifics-CatalogDetails.html CompleteSale BestEffort, FailOnError FailOnError No A unique identifier for a particular call. If the same InvocationID is passed in after it has been passed in once on a call that succeeded for a particular application and user, then an error will be returned. The identifier can only contain digits from 0-9 and letters from A-F. The identifier must be 32 characters long. For example, 1FB02B2-9D27-3acb-ABA2-9D539C374228. 32 AddOrder AddToItemDescription PlaceOffer ReviseItem No You can use the OutputSelector field to restrict the data returned by a call. This field can make the call response easier to manage, especially when a large payload is returned. If you use the OutputSelector field, the output data will only include the field(s) you specified in the request, as well as all of its child fields (if a field is a container) and its parent fields (if any). Note that it is possible that a field included through an OutputSelector field may still not be returned if it is not applicable, or if it is not found based on other criteria set up in the request payload. For example, if you are using GetItem and you only want to retrieve the URL of the View Item page (emitted in ViewItemURL field) and the item's Buy It Now price (emitted in BuyItNowPrice field), you would include two separate OutputSelector fields and set the value for each one as ViewItemURL and BuyItNowPrice as in the following example: <pre> If the following output selectors are used: ... <code><OutputSelector>ViewItemURL</OutputSelector> <OutputSelector>BuyItNowPrice</OutputSelector> </code> ... ...the response might look like the following <code> <Item> <BuyItNowPrice currencyID="USD">0.0</BuyItNowPrice> <ListingDetails> <ViewItemURL>http://www.ebay.com/itm/Tag-Heuer-Mens-Watch/182879833261</ViewItemURL> </ListingDetails> </Item> </code> </pre> GetAccount GetAdFormatLeads GetAllBidders GetBestOffers GetBidderList GetCategoryFeatures GetFeedback GetItem GetItemsAwaitingFeedback GetItemShipping GetItemTransactions GetMemberMessages GetMyeBayBuying GetMyeBaySelling GetMyMessages GetNotificationPreferences GetOrders GetSellerEvents GetSellerList GetSellerTransactions No https://developer.ebay.com/api-docs/user-guides/static/make-a-call/tapi-input-data.html#output-sel OutputSelector Controls whether or not to return warnings when the application passes unrecognized or deprecated elements in a request. An unrecognized element is one that is not defined in any supported version of the schema. Schema element names are case-sensitive, so using WarningLevel can also help you remove any potential hidden bugs within your application due to incorrect case or spelling in field names before you put your application into the Production environment. WarningLevel only validates elements; it doesn't validate XML attributes. It also doesn't control warnings related to user-entered strings or numbers, or warnings for logical errors. We recommend that you only use this during development and debugging. Do not use this in requests performed in the Production environment. No https://ebaydts.com/eBayKBDetails?KBid=499 Warning Level This container is only used by the PlaceOffer call request if the previous PlaceOffer call resulted in a BotBlock container in the response. If the caller receives this container in the response, that caller must make another PlaceOffer call, this time, passing in the encrypted token and URL that is returned in the BotBlock container in the response. This safeguard lets eBay know that a real user is making a PlaceOffer call and not a bot. PlaceOffer Conditionally Base type definition of a response payload that can carry any type of payload content with following optional elements: <ul> <li>timestamp of response message</li> <li>application-level acknowledgement</li> <li>application-level (business-level) errors and warnings</li> </ul> This value represents the date and time when eBay processed the request. The time zone of this value is GMT and the format is the ISO 8601 date and time format (YYYY-MM-DDTHH:MM:SS.SSSZ). See the Time Values section in the eBay Features Guide for information about this time format and converting to and from the GMT time zone. Note: Trading API calls are designed to retrieve very large sets of metadata that change once a day or less often. To improve performance, these calls return cached responses when you request all available data (with no filters). When this occurs, this time value reflects the time the cached response was created. Thus, this value is not necessarily when the request was processed. However, if you specify an input filter to reduce the amount of data returned, the calls retrieve the latest data (not cached). When this occurs, this time value does reflect when the request was processed. OrderAck, SetShipmentTrackingInfo Always A token representing the application-level acknowledgement code that indicates the response status (e.g., success). The AckCodeType list specifies the possible values for the Ack field. CompleteSale, GetPopularKeywords PartialFailure Always CompleteSale GetPopularKeywords Always Most Trading API calls support a MessageID element in the request and a CorrelationID element in the response. If you pass in a MessageID in a request, the same value will be returned in the CorrelationID field in the response. Pairing these values can help you track and confirm that a response is returned for every request and to match specific responses to specific requests. If you do not pass a MessageID value in the request, CorrelationID is not returned. OrderAck, SetShipmentTrackingInfo Conditionally A list of application-level errors (if any) that occurred when eBay processed the request. Conditionally Supplemental information from eBay, if applicable. May elaborate on errors (such as how a listing violates eBay policies) or provide useful hints that may help a seller increase sales. This data can accompany the call's normal data result set or a result set that contains only errors. Applications must recognize when the Message field is returned and provide a means to display the listing hints and error message explanations to the user. The string can return HTML, including TABLE, IMG, and HREF elements. In this case, an HTML-based application should be able to include the HTML as-is in the HTML page that displays the results. A non-HTML application would need to parse the HTML and convert the table elements and image references into UI elements particular to the programming language used. As usual for string data types, the HTML markup elements are escaped with character entity references (e.g.,<table><tr>...). AddFixedPriceItem AddItem AddItems AddToItemDescription EndItem PlaceOffer RelistFixedPriceItem RelistItem RespondToWantItNowPost ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem Conditionally Standard Data for All Calls https://developer.ebay.com/DevZone/guides/features-guide/Basics/Call-StandardCallData.html The version of the response payload schema. Indicates the version of the schema that eBay used to process the request. See the Standard Data for All Calls section in the eBay Features Guide for information on using the response version when troubleshooting CustomCode values that appear in the response. OrderAck, SetShipmentTrackingInfo Always This refers to the specific software build that eBay used when processing the request and generating the response. This includes the version number plus additional information. eBay Developer Support may request the build information when helping you resolve technical issues. OrderAck, SetShipmentTrackingInfo Always Event name of the notification. Only returned by Platform Notifications. Information that explains a failure due to a duplicate InvocationID being passed in. AddFixedPriceItem AddItem AddItems AddLiveAuctionItem AddOrder AddSecondChanceItem AddToItemDescription PlaceOffer RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem Conditionally Recipient user ID of the notification. Only returned by Platform Notifications. Unique Identifier of Recipient user ID of the notification. Only returned by Platform Notifications (not for regular API call responses). A Base64-encoded MD5 hash that allows the recipient of a Platform Notification to verify this is a valid Platform Notification sent by eBay. Expiration date of the user's authentication token. Only returned within the 7-day period prior to a token's expiration. To ensure that user authentication tokens are secure and to help avoid a user's token being compromised, tokens have a limited life span. A token is only valid for a period of time (set by eBay). After this amount of time has passed, the token expires and must be replaced with a new token. FetchToken, OrderAck, SetShipmentTrackingInfo, GetSessionID Conditionally This container is conditionally returned in the PlaceOffer call response if eBay wants to challenge the user making the call to ensure that the call is being made by a real user and not a bot. This container consist of an encrypted token, the URL of the image that should be displayed to the user, or the URL of an audio clip for sight-impaired users. After receiving this data in the response, the caller must make another PlaceOffer call, this time passing in the encrypted token and one of the URLs that was received in the previous call response. PlaceOffer Conditionally An application subscribing to notifications can include an XML-compliant string, not to exceed 256 characters, which will be returned. The string can identify a particular user. Any sensitive information should be passed with due caution. To subscribe to and receive eBay Buyer Protection notifications, this field is required, and you must pass in 'eBP notification' as a string. SetNotificationPreferences Conditionally GetNotificationPreferences Conditionally This enumerated type identifies the possible values that can be returned in the Ack field in call responses. The Ack value will indicate if the call was completely successful, if the called failed, or if the call was partially successful, but with minor errors or warnings. This value indicates that the call request was processed successfully without any issues. This value indicates that the call request processing failed. This value indicates that the call request was successful, but processing was not without any issues. These issues can be checked in the Errors container, that will also be returned when one or more known issues occur with the call request. This value indicates that the call request partially failed. One or more issues that may be responsible for this partial failure can be checked in the Errors container, that will also be returned when one or more known issues occur with the call request. Reserved for internal or future use. Type used by the BotBlock container of the PlaceOffer call request. The BotBlock container is conditionally required in a PlaceOffer call request if the previous PlaceOffer call resulted in a BotBlock container being returned in the response. The BotBlock container in the response will contain an authentication token and a URL that will need to be passed into the BotBlock container of the PlaceOffer call request in the subsequent call. This string value is an encrypted token that eBay generates and returns in the BotBlock.BotBlockToken field of the PlaceOffer call response when eBay is requiring that the user supply an authentication token and URL in order for eBay to process the PlaceOffer call. As soon as a user gets a BotBlock container returned in the PlaceOffer call response, that user should grab the authentication token and the URL and then run another PlaceOffer call, but this time using the BotBlock container and passing in the authentication token and the URL values. PlaceOffer Conditionally This string value is a URL that eBay generates and returns in either the BotBlock.BotBlockUrl or BotBlock.BotBlockAudioUrl field (returned for site-impaired users) of the PlaceOffer call response when eBay is requiring that the user supply an authentication token and URL in order for eBay to process the PlaceOffer call. As soon as a user gets a BotBlock container returned in the PlaceOffer call response, that user should grab the authentication token and the URL and then run another PlaceOffer call, but this time using the BotBlock container and passing in the authentication token and the URL values. PlaceOffer Conditionally This type is used by the BotBlock container that is returned in the PlaceOffer call response if eBay is requiring that the user supply an authentication token and URL in order for eBay to process the PlaceOffer call. The authentication token and URL values that are returned in the PlaceOffer call response are then passed in the BotBlock container of a subsequent PlaceOffer call. This string value is an encrypted token that eBay generates and returns in the BotBlock.BotBlockToken field of the PlaceOffer call response when eBay is requiring that the user supply an authentication token and URL in order for eBay to process the PlaceOffer call. As soon as a user gets a BotBlock container returned in the PlaceOffer call response, that user should grab the authentication token and the URL and then run another PlaceOffer call, but this time using the BotBlock container and passing in the authentication token and the URL values. PlaceOffer Conditionally This string value is a URL to an image that eBay generates and returns in the PlaceOffer call response when eBay is requiring that the user supply an authentication token and URL in order for eBay to process the PlaceOffer call. As soon as a user gets a BotBlock container returned in the PlaceOffer call response, that user should grab the authentication token and this BotBlockUrl and then run another PlaceOffer call, but this time using the BotBlock container and passing in the authentication token and this URL value in the BotBlockUserInput field. For site-impaired users, the BotBlockAudioUrl field might be returned instead, in which case, the BotBlockAudioUrl value should be passed into theBotBlockUserInput field instead. PlaceOffer Conditionally This string value is a URL to an audio clip that eBay generates and returns in the PlaceOffer call response when eBay is requiring that the user supply an authentication token and URL in order for eBay to process the PlaceOffer call. As soon as a user gets a BotBlock container returned in the PlaceOffer call response, that user should grab the authentication token and this BotBlockAudioUrl and then run another PlaceOffer call, but this time using the BotBlock container and passing in the authentication token and this URL value in the BotBlockUserInput field. Note: This field will generally only be returned for site-impaired users. If this field is not returned, but the BotBlockUrl field is returned instead, the BotBlockUrl value should be passed into the BotBlockUserInput field of the subsequent PlaceOffer call instead. PlaceOffer Conditionally This enumerated type defines different payment methods that can be used by buyers to pay sellers for purchases. Supported payment methods vary by eBay marketplace, by eBay Category, and even by listing format. If a seller is listing, revising, or relisting an item with a Trading API call, the seller should use one of the following metadata calls to see which payment methods are supported at the site and category level: <ul> <li>GeteBayDetails: through PaymentOptionDetails containers in the response, this call will show the seller all of the payment methods that are available for the specified marketplace. To retrieve this metadata, the seller should include the DetailName field in the request, and set its value to <code>PaymentOptionDetails</code></li> <li>GetCategoryFeatures: through PaymentMethod fields that are returned under the SiteDefaults container or under one or more Category containers in the response, this call will show the seller all of the payment methods that are available for the specified marketplace, including any category exceptions. To retrieve this metadata, the seller should include the FeatureID field in the request, and set its value to <code>PaymentMethods</code>. Note that Category containers will only be returned for categories that differ from Site Defaults as far as supported payment methods are concerned. </li> </ul> Note: As eBay now controls all of the online payment methods available to buyers, sellers will only specify offline payment methods for listings that require/support offline payment. CashOnPickup, MOCC, PersonalCheck, CustomCode, COD This enumeration value is deprecated, and should no longer be used in listing flows. This enumeration value indicates that a money order or cashiers check is accepted for payment. This value is only applicable for offline payments and is not supported on all marketplaces. Note: To see if this enumeration value is a supported payment method for a site and category, call GetCategoryFeatures specifying the listing category ID and including the FeatureID field set to <code>PaymentMethods</code>. This enumeration value is deprecated, and should no longer be used in listing flows. This enumeration value is deprecated, and should no longer be used in listing flows. This enumeration value is deprecated, and should no longer be used in listing flows. This enumeration value indicates that a personal check is accepted for payment. This value is only applicable for offline payments and is not supported on all marketplaces. Note: To see if this enumeration value is a supported payment method for a site and category, call GetCategoryFeatures specifying the listing category ID and including the FeatureID field set to <code>PaymentMethods</code>. This enumeration value indicates that a COD (Cash On Delivery) is accepted for payment. This value is only applicable for offline payments and is not supported on all marketplaces. Note: To see if this enumeration value is a supported payment method for a site and category, call GetCategoryFeatures specifying the listing category ID and including the FeatureID field set to <code>PaymentMethods</code>. This enumeration value is deprecated, and should no longer be used in listing flows. This payment method is deprecated. This enumeration value is deprecated, and should no longer be used in listing flows. This enumeration value is deprecated, and should no longer be used in listing flows. This enumeration value is deprecated, and should no longer be used in listing flows. This enumeration value indicates that cash on pickup is accepted for payment. This value is only applicable for offline payments. Note: To see if this enumeration value is a supported payment method for a site and category, call GetCategoryFeatures specifying the listing category ID and including the FeatureID field set to <code>PaymentMethods</code>. This enumeration value is deprecated, and should no longer be used in listing flows. This enumeration value is deprecated, and should no longer be used in listing flows. This enumeration value is deprecated, and should no longer be used in listing flows. This enumeration value is deprecated, and should no longer be used in listing flows. This enumeration value is deprecated, and should no longer be used in listing flows. This enumeration value is deprecated, and should no longer be used in listing flows. This enumeration value is deprecated, and should no longer be used in listing flows. Reserved for internal or future use. This enumeration value is deprecated, and should no longer be used in listing flows. This enumeration value is deprecated, and should no longer be used in listing flows. This enumeration value is deprecated, and should no longer be used in listing flows. 579 NoOp This payment type is no longer applicable since eBay India is no longer a functioning site. This payment type is no longer applicable since eBay India is no longer a functioning site. This payment method is deprecated. This payment method is deprecated. This payment method is deprecated. This payment method is deprecated. This enumeration value is deprecated, and should no longer be used in listing flows. This enumeration value is deprecated, and should no longer be used in listing flows. This enumeration value is deprecated, and should no longer be used in listing flows. This payment method is deprecated. This enumeration value is deprecated, and should no longer be used in listing flows. This enumeration value is deprecated, and should no longer be used in listing flows. This payment method is deprecated. This payment method is deprecated. Security header used for SOAP API calls. Authentication token representing the user who is making the request. The user's token must be retrieved from eBay. To determine a user's authentication token, see the Authentication and Authorization information in the eBay Web Services guide. For calls that list or retrieve item or transaction data, the user usually needs to be the seller of the item in question or, in some cases, the buyer. Similarly, calls that retrieve user or account data may be restricted to the user whose data is being requested. The documentation for each call includes information about such restrictions. 2000 FetchToken Yes Getting Tokens https://developer.ebay.com/DevZone/guides/features-guide/Basics/Tokens.html Expiration date of the user's authentication token. Only returned within the 7-day period prior to a token's expiration. To ensure that user authentication tokens are secure and to help avoid a user's token being compromised, tokens have a limited life span. A token is only valid for a period of time (set by eBay). After this amount of time has passed, the token expires and must be replaced with a new token. GetSessionID,FetchToken Conditionally Authentication information for the user on whose behalf the application is making the request, and authorization information for the application making the request. Only registered eBay users are allowed to make API calls. To verify that a user is registered, your application normally 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. FetchToken Yes A Base64-encoded MD5 hash that allows the recipient of a Platform Notification to verify this is a valid Platform Notification sent by eBay. Specifies standard subsets of data to return for each result within the set of results in the response payload. If no detail level is specified, a base set of data is returned. The base set of data varies per call. Returns all available data. With GetSellerList and other calls that retrieve large data sets, please avoid using ReturnAll when possible. For example, if you use GetSellerList, use a GranularityLevel or use the GetSellerEvents call instead. If you use ReturnAll with GetSellerList, use a small EntriesPerPage value and a short EndTimeFrom/EndTimeTo range for better performance. Returns the description, plus the ListingDesigner node and some additional information if applicable For GetItem, returns Item Specifics and Pre-filled Item Information, if any. Also see the description of Item.ProductListingDetails for GetItem. If this value is used, the primary category and, if applicable, the secondary category is returned. Returns the summary data. For GetMyMessages, this detail level returns the same data whether or not you include MessageIDs in the request. Returns up to 10 FolderID and FolderName values. Currently, this detail level is the only way to retrieve FolderID and FolderName values. See GetMyMessages for a code sample that demonstrates this. Returns message headers. For GetMyMessages, if you include MessageIDs in the request, this detail level returns header information, without body text, for the specified message ID or alert ID values. If you include a FolderID, header information is returned only for the messages and alerts in the specified folder. If you do not include MessageIDs, this detail level returns header information for Alerts and Messages as follows: <ul> <li>If all the Alerts have been read, they are sorted in date order, with the most recent first.</li> <li>If one of the Alerts has not been read, the Read Alerts come first, sorted most recent first, followed by the Unread Alert(s).</li> <li>All messages in ascending order by date received with the oldest messages first.</li> </ul> Note: Even when restricted by this detail level to return only header information, GetMyMessages may return a high volume of data. Returns full message information. For GetMyMessages, if you include MessageIDs in the request, this detail level returns message information for the specified message ID or alert ID values. If you include a FolderID, message information is returned only for the messages and alerts in the specified folder. This type is used by the DuplicateInvocationDetails container that is returned in some calls if a duplicate InvocationID or InvocationTrackingID is used in the call request. This value represents the duplicate InvocationID or InvocationTrackingID that was used in the call request. AddItem AddItems AddOrder AddSecondChanceItem AddToItemDescription PlaceOffer RelistItem ReviseItem Conditionally This enumeration value indicates the status of the previous call that used the InvocationID or InvocationTrackingID specified in the DuplicateInvocationID. AddFixedPriceItem AddItem AddItems AddOrder AddSecondChanceItem AddToItemDescription PlaceOffer RelistItem ReviseItem Conditionally This unique identifier identifies the business item the previous API invocation created. For example, the Item ID of the item created by an AddItem call. AddItem AddItems AddOrder AddSecondChanceItem AddToItemDescription PlaceOffer RelistItem ReviseItem Conditionally An error has occurred either as a result of a problem in the sending application or because the application's end-user has attempted to submit invalid data (or missing data). In these cases, do not retry the request. The problem must be corrected before the request can be made again. If the problem is due to something in the application (such as a missing required field), the application must be changed. If the problem is a result of end-user data, the application must alert the end-user to the problem and provide the means for the end-user to correct the data. Once the problem in the application or data is resolved, resend the request to eBay with the corrected data. Indicates that an error has occurred on the eBay system side, such as a database or server down. An application can retry the request as-is a reasonable number of times (eBay recommends twice). If the error persists, contact Developer Technical Support. Once the problem has been resolved, the request may be resent in its original form. (out) Reserved for internal or future use. Preferences that specify how eBay should handle certain requests that contain invalid data or that could partially fail. These preferences give you some control over whether eBay returns warnings or errors in response to invalid data and how eBay handles listing requests when such data is passed in. For example, these preferences are applicable to AddItem and related calls when Item Specifics are specified, and to CompleteSale. See <a href="https://developer.ebay.com/api-docs/user-guides/static/make-a-call/error-handling.html">Error handling</a> for details about these preferences and their effects. Apply validation rules that were in effect prior to the time the call started supporting ErrorHandling. Drop the invalid data, continue processing the request with the valid data. If dropping the invalid data leaves the request in a state where required data is missing, reject the request. If BestEffort is specified for CompleteSale, the Ack field in the response could return PartialFailure if one change fails but another succeeds. For example, if the seller attempts to leave feedback twice for the same order line item, the feedback changes would fail but any paid or shipped status changes would succeed. If any of the item specifics data is invalid, drop all the data and proceed with listing the item. If the category has required item specifics and the data was dropped, reject the listing. If any data is invalid, reject the request. This type is used by the ErrorParameters container if one or more errors or warnings occur with the call, and if a specific request parameter has been pinpointed as the reason why the error or warning was triggered. This is the value of the request parameter noted in the ParamID attribute. So, if the ParamID value was ItemID, the value in this field would be the actual value of that ItemID. Conditionally This is name of the request parameter that has been pinpointed as the reason why the error or warning was triggered. This value might be ItemID, in which case the identifier of that item would be returned in the Value field. Conditionally These are request errors (as opposed to system errors) that occur due to problems with business-level data (e.g., an invalid combination of arguments) that the application passed in. A brief description of the condition that raised the error. Conditionally A more detailed description of the condition that raised the error. Conditionally A unique code that identifies the particular error condition that occurred. Your application can use error codes as identifiers in your customized error-handling algorithms. other ActiveInventoryReport Active Inventory Report Errors /api-docs/sell/static/feed/lms-feeds-quick-reference.html#active-inventory-errors Conditionally Conditionally Errors By Number /Devzone/XML/docs/Reference/eBay/Errors/ErrorMessages.html#ErrorsByNumber Indicates whether the error message text is intended to be displayed to an end user or intended only to be parsed by the application. If true or not present (the default), the message text is intended for the end user. If false, the message text is intended for the application, and the application should translate the error into a more appropriate message. Only applicable to Item Specifics errors and warnings returned from listing requests. AddItem AddItems AddLiveAuctionItem RelistItem ReviseItem ReviseLiveAuctionItem VerifyAddItem Conditionally Indicates whether the error is a severe error (causing the request to fail) or an informational error (a warning) that should be communicated to the user. Conditionally This optional element carries a list of context-specific error variables that indicate details about the error condition. These are useful when multiple instances of ErrorType are returned. Conditionally API errors are divided between two classes: system errors and request errors. Conditionally Basic type for specifying measures and the system of measurement. A decimal value (e.g., 10.25) is meaningful as a measure when accompanied by a definition of the unit of measure (e.g., Pounds), in which case the value specifies the quantity of that unit. A MeasureType expresses both the value (a decimal) and, optionally, the unit and the system of measurement. Details such as shipping weights are specified as measure types. Unit of measure. This attribute is shared by various fields, representing units such as lbs, oz, kg, g, in, cm. For weight, English major/minor units are pounds and ounces, and metric major/minor units are kilograms and grams. For length, the English unit is inches, and metric unit is centimeters. To get the full list of package dimension and weight measurement units (and all alternative spellings and abbreviations) supported by your site, call GeteBayDetails. GetItemShipping GetSellerTransactions GetShippingDiscountProfiles Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GeteBayDetails GeteBayDetails.html The system of measurement (e.g., English). GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetShippingDiscountProfiles Conditionally This enumerated type defines the two measurement systems that are used globally. This enumeration value indicates that the English system of measurement is being used. Also known as the Imperial System of Measurement. Weights in this system are expressed as pounds and ounces, and package dimensions are expressed as feet or inches. This enumeration value indicates that the English system of measurement is being used. Weights in this system are expressed as kilograms and grams, and package dimensions are expressed as meters or centimeters. Contains data for controlling pagination in API requests. Pagination of returned data is required for some calls and not needed in or not supported for some calls. See the documentation for individual calls to determine whether pagination is supported, required, or desirable. This integer value is used to specify the maximum number of entries to return in a single "page" of data. This value, along with the number of entries that match the input criteria, will determine the total pages (see PaginationResult.TotalNumberOfPages) in the result set. The maximum and default values are not the same for all calls. For most Trading API calls, the maximum value is 200 and the default value is 25 entries per page. GetAccount GetFeedback GetItemsAwaitingFeedback GetItemTransactions GetMemberMessages GetMyeBayBuying GetMyeBaySelling GetMyMessages GetSellerTransactions No 1 100 25 GetOrders No GetBestOffers No 20 GetSellerList Yes 100 GetPopularKeywords No Specifies the number of the page of data to return in the current call. 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 the individual calls to determine the correct default value. 1 1 GetAccount GetBestOffers GetFeedback GetItemsAwaitingFeedback GetItemTransactions GetMemberMessages GetMyeBayBuying GetMyeBaySelling GetMyMessages GetOrders GetSellerTransactions No GetSellerList Yes 1 GetPopularKeywords No SeverityCodeType - Type declaration to be used by other schema. This code identifies the severity of an API error. A code indicates whether there is an API-level error or warning that needs to be communicated to the client. The request was processed successfully, but something occurred that may affect your application or the user. For example, eBay may have changed a value the user sent in. In this case, eBay returns a normal, successful response and also returns the warning. When a warning occurs, the error is returned in addition to the business data. In this case, you do not need to retry the request (as the original request was successful). However, depending on the cause or nature of the warning, you might need to contact either the end user or eBay to effect a long term solution to the problem to prevent it from reoccurring in the future. The request that triggered the error was not processed successfully. When a serious application-level error occurs, the error is returned instead of the business data. If the source of the problem is within the application (such as a missing required element), change the application before you retry the request. <ul> <li>If the problem is due to end-user input data, please alert the end-user to the problem and provide the means for them to correct the data. Once the problem in the application or data is resolved, you can attempt to re-send the request to eBay. </li> <li>If the source of the problem is on eBay's side, An application can retry the request as-is a reasonable number of times (eBay recommends twice). If the error persists, contact Developer Technical Support. Once the problem has been resolved, the request may be resent in its original form. </li> </ul> See the <a href="https://developer.ebay.com/api-docs/user-guides/static/make-a-call/error-handling.html">Error handling</a> section of the Making a Trading API call guide for more information. Reserved for internal or future use. Specifies a universally unique identifier for an item. This is used to ensure that you only list a particular item once, particularly if you are listing many items at once. The identifier can contain only digits from 0-9 and letters from A-F. The identifier must be 32 characters long. For example, 9CEBD9A6825644EC8D06C436D6CF494B. Item.Site in AddItem AddItem.html#Request.Item.UUID The application ID that is unique to each application you (or your company) has registered with the eBay Developers Program. If you are executing a call in the Sandbox, this is the "AppId" value that eBay issued to you when you received your Sandbox keys. If you are executing a call in Production, this is the "AppId" value that eBay issued to you when you received your Production keys. FetchToken Yes The unique developer ID that the eBay Developers Program issued to you (or your company). If you are executing a call in the Sandbox, this is the "DevId" value that eBay issued to you when you received your Sandbox keys. Typically, you receive your Sandbox keys when you register as a new developer. If you are executing a call in Production, this is the "DevId" value that eBay issued to you when you received your Production keys. Typically, you receive your Production keys when you certify an application. FetchToken Yes Authentication certificate that authenticates the application when making API calls. If you are executing a call in the Sandbox, this is the "CertId" value that eBay issued to you when you received your Sandbox keys. If you are executing a call in Production, this is the "CertId" value that eBay issued to you when you received your Production keys. This is unrelated to auth tokens. FetchToken Yes eBay user ID (i.e., eBay.com Web site login name) for the user the application is retrieving a token for. This is typically the application's end-user (not the developer). 64 FetchToken Yes Password for the user specified in Username. This enumerated type contains the list of values that can be passed in through the WarningLevel field of a call request. The WarningLevel value is set to <code>Low</code> if the user does not wish to receive warnings when the application passes unrecognized or deprecated elements in an API call request. This is the default value if WarningLevel is not specified in the call request. The WarningLevel value is set to <code>High</code> if the user wishes to receive warnings when the application passes unrecognized or deprecated elements in an API call request. Setting the WarningLevel value to <code>High</code> is not recommended in a production environment. Instead, it should only be used during the development/debugging stage. eBay user ID (i.e., eBay.com Web site login name) for the user the application is retrieving a token for. This is typically the application's end-user (not the developer). 64 FetchToken Yes Password for the user specified in Username. Authentication token representing the user who is making the request. The user's token must be retrieved from eBay. To determine a user's authentication token, see the Authentication and Authorization information in the eBay Web Services guide. For calls that list or retrieve item or transaction data, the user usually needs to be the seller of the item in question or, in some cases, the buyer. Similarly, calls that retrieve user or account data may be restricted to the user whose data is being requested. The documentation for each call includes information about such restrictions. 2000 FetchToken Yes Getting Tokens https://developer.ebay.com/DevZone/guides/features-guide/Basics/Tokens.html This type is used by the ASQPreferences container to allow the seller to add custom Ask Seller a Question (ASQ) subjects to item listings, or to reset the custom subjects to the default eBay values. This boolean field can be used in the SetMessagePreferences call to reset all custom Ask Seller a Question (ASQ) subjects to their default eBay values. For any given SetMessagePreferences call, either ResetDefaultSubjects or one or more Subject fields can be used, but not both in the same call. SetMessagePreferences Conditionally Each Subject field contains one custom Ask a Question (ASQ) subject. A maximum of nine custom ASQ subjects can be created. eBay's "General question about this item" subject will always be included in all listings. For any given SetMessagePreferences call, either ResetDefaultSubjects or one or more Subject fields can be used, but not both in the same call. ASQ subjects are displayed on the drop-down list in the same order as they are passed in to the request. So, if the seller would like to rearrange the order of the ASQ subjects, they should keep this behavior in mind. Note that the default ASQ subjects will display in the site's language if retrieved from a site other than the seller's own. For example, if a US seller sells on the German and French sites, the default subjects will display in German and French, respectively. However, if the seller adds custom subjects through the API on these sites, the custom subjects will display in the seller's own language - English in this use case. The GetMessagePreferences call will retrieve all custom ASQ subjects that have been set by the seller. If custom ASQ subjects have not been set up by the seller, the eBay default ASQ subjects will be returned in the Subject fields instead. 60 9 GetMessagePreferences Conditionally SetMessagePreferences Conditionally Enumerated type that defines the fee/charge and credit transactions that occur on an eBay user's account. These values are returned in the AccountEntry.AccountDetailsEntryType output field of the GetAccount call. CreditPromotedListingFeature, FeePromotedListingFeature, PictureManagerSubscriptionFee, PictureManagerSubscriptionFeeCredit, StoresSuccessfulListingFee, StoresSuccessfulListingFeeCredit, StoresReferralFee, StoresReferralCredit, eBayStoreInventorySubscriptionCredit, FeeGiftIcon, CreditGiftIcon, FeeHighlight, CreditHighlight, TradingLimitOverrideOn, TradingLimitOverrideOff, AutoTraderOn, AutoTraderOff, PaperInvoiceOn, PaperInvoiceOff, LACatalogFee, LAExtraItem, LACatalogItemFeeRefund, LACatalogInsertionRefund, LAFinalValueFee, LAFinalValueFeeRefund, LABuyerPremiumPercentageFee, LABuyerPremiumPercentageFeeRefund, LAAudioVideoFee, LAAudioVideoFeeRefund, SubscriptionAABasic, SubscriptionAAPro, CreditAABasic, CreditAAPro, FeePicturePack, CreditPicturePackPartial, CreditPicturePackFull, ElectronicInvoiceOn, ElectronicInvoiceOff, ExtendedAuctionFee, ExtendedAcutionCredit, BonusPointsAddition, BonusPointsReduction, BonusPointsPaymentAutomatic, BonusPointsPaymentManual, BonusPointsPaymentReversal, BonusPointsCashPayout, AutoPmntReqExempt, AutoPmntReqRein, SellerReportsBasicFee, SellerReportsBasicCredit, SellerReportsPlusFee, SellerReportsPlusCredit, BorderFee, BorderFeeCredit, FeeSearchableMobileDE, CreditSearchableMobileDE, EmailMarketingFee, EmailMarketingCredit, FeePictureShow, BasicUpgradePackBundleFee, BasicUpgradePackBundleFeeCredit, BasicBundleFee, BasicBundleFeeCredit, ImmoProFee, CreditImmoProFee, ImmoProFeatureFee, CreditImmoProFeatureFee, RealEstateProFee, CreditRealEstateProFee, RealEstateProFeatureFee, CreditRealEstateProFeatureFee, ListingDesignerFee, ListingDesignerCredit, PayPalOTPSucc, PayPalOTPPend, PayPalFailed, PayPalChargeBack, PayPalRefund, SMProListingDesignerFee, SMProListingDesignerCredit, PaypalOnFile, PaypalOnFileByCSR, PaypalOffFile, DepositProcessingFixedFee, DepositProcessingFixedFeeCredit This enumeration value indicates that the account transaction type is unknown. Sometimes this value will get returned, but the corresponding Description field may provide more details, and the corresponding GrossDetailAmount field will indicate whether the transaction was a charge or a credit (indicated with a negative dollar value). This enumeration value indicates that the account entry is an insertion fee for a listing. This enumeration value indicates that the account entry is a listing upgrade fee for a listing title in boldface font. This enumeration value indicates that the account entry is a listing upgrade fee for featuring the listing on an eBay marketplace's home page. Note: This feature is no longer available to most marketplaces and sellers. This enumeration value indicates that the account entry is a listing upgrade fee for featuring the listing on an eBay category page relevant to the item. Note: This feature is no longer available to most marketplaces and sellers. This enumeration value indicates that the account entry is a final value fee for a sale on the listing. This fee is charged when a listed item sells, and is a percentage of the final sale price. This fee does not take in account any shipping costs. The final value fee associated with shipping costs is returned in FeeFinalValueShipping entry. This enumeration value indicates that the account entry is a payment by check made by a user to eBay. This enumeration value indicates that the account entry is a payment by credit card made by a user to eBay. This enumeration value indicates that the account entry is a courtesy credit issued by eBay to the user. This enumeration value indicates that the account entry is a credit issued by eBay to the user due to no sale. This enumeration value indicates that the account entry is a credit issued by eBay to the user due to a partial sale. This enumeration value indicates that the account entry is a refund to a user's credit card issued by eBay. This enumeration value indicates that the account entry is a refund check to a user issued by eBay. This enumeration value indicates that the account entry is a finance charge to the user's account. A finance charge may be applicable if the user's monthly invoice balance is not paid in full by the due date. This value is no longer applicable, and should not be returned. This value is no longer applicable, and should not be returned. This value is no longer applicable, and should not be returned. This enumeration value indicates that the account entry is a credit issued to the seller for any listing fees for a duplicate listing that was removed by eBay. This enumeration value indicates that the account entry is a fee charged by eBay for a partial sale. This enumeration value indicates that the account entry is a reversal of an electronic transfer payment. This enumeration value indicates that the account entry is a one-time payment made by a credit card. This enumeration value indicates that the account entry is a fee charged by eBay for a returned check. This enumeration value indicates that the account entry is a fee charged by eBay when a check must be redeposited to collect funds. This enumeration value indicates that the account entry is a cash payment made on the user's account. This enumeration value indicates that the account entry is an insertion fee credit issued by eBay to the seller. This enumeration value indicates that the account entry is a credit for a Bold title listing upgrade. This enumeration value indicates that the account entry is a credit for a listing upgrade fee for featuring the listing on an eBay marketplace's home page. Note: This feature is no longer available to most marketplaces and sellers. This enumeration value indicates that the account entry is a credit for a listing upgrade fee for featuring the listing on an eBay category page relevant to the item. Note: This feature is no longer available to most marketplaces and sellers. This enumeration value indicates that the account entry is a credit for a final value fee for a sale on the listing. A final value fee may be credited back to a seller's account if the buyer never pays for the line item, or if the buyer cancels the order. This enumeration value indicates that the account entry is a fee charged by eBay when the seller's check does not clear due to insufficient funds. This enumeration value indicates that the account entry is a fee charged by eBay when the seller's check does not clear because the account has been closed. This enumeration value may be returned if the account entry is just a memo/note, or if the account entry cannot be properly classified. The corresponding Description field may provide more details, and the corresponding GrossDetailAmount field will indicate whether the transaction was a charge or a credit (indicate with a negative dollar value). This enumeration value may be returned if the account entry is a payment made to the account by money order. This enumeration value may be returned if the account entry is an automatic monthly charge of the seller's invoice amount made by eBay to a credit card the seller has placed on file. This enumeration value may be returned if the account entry is a one-time payment made with a user's credit card that is not on file with eBay for automatic monthly payments. This enumeration value indicates that the user has been invoiced. This enumeration value indicates that the user has been invoiced and that the balance will be charged to the credit card on file on the due date. This enumeration value may be returned if the account entry is a credit transferred from another account to this account. This enumeration value indicates that the account entry is a debit transferred from this account to another account. This enumeration value indicates that the account entry is a credit balance for an account's invoice period, meaning that the seller should not pay. This enumeration value may be returned for debits issued by eBay that are manually applied to the user's account, and not necessarily tied to a specific listing/line item. This enumeration value may be returned for credits issued by eBay that are manually applied to the user's account, and not necessarily tied to a specific listing/line item. This enumeration value indicates that the account entry is a promotional credit issued by eBay. This enumeration value may be returned as a note that the user's credit card is not with eBay. This enumeration value indicates that the account entry is an insertion fee credit. If a listed item does not sell or results in an Unpaid Item case, the seller can relist the item with no additional charge. This enumeration value may be returned as a note if a user's credit card payment is rejected. This enumeration value is no longer applicable and should not be returned since gift services and the gift icon are no longer supported in any eBay marketplaces. This enumeration value is no longer applicable and should not be returned since gift services and the gift icon are no longer supported in any eBay marketplaces. This enumeration value indicates that the account entry is a fee charged by eBay for listing an item in the Picture Gallery. A buyer sees a picture of the item when browsing a category, before moving to the item's listing page. This enumeration value indicates that the account entry is a fee charged by eBay for listing an item in the Featured section at the top of the Picture Gallery page. This enumeration value indicates that the account entry is a credit issued by eBay for the Gallery fee charged when the item was listed. This enumeration value indicates that the account entry is a credit issued by eBay for the Featured Gallery fee charged when the item was listed. This enumeration value indicates that the account entry is a fee for moving the item. This enumeration value indicates that the account entry is a credit that may be issued by eBay when listings are not available due to system downtime. The downtime can be a title search outage or a hard outage. This enumeration value indicates that the account entry is a credit for a PSA payment. This enumeration value indicates that the account entry is a credit for a PCGS fee. This enumeration value indicates that the account entry is a fee charged by eBay when the seller sets a reserve price for an auction listing. This enumeration value indicates that the account entry is a credit refunded to the seller for a reserve price that was set for an auction listing. This enumeration value indicates that the account entry is a credit issued by eBay to the user's Visa credit card. This enumeration value indicates that the account entry is a credit issued administratively. This enumeration value indicates that the account entry is a charge issued administratively. This enumeration value indicates that the account entry is a credit issued by eBay to a Store owner who has promoted items outside of eBay. This enumeration value indicates that the account entry is a charge issued by eBay to a Store owner who has promoted items outside of eBay. This enumeration value may be returned as a note about switching from one billing currency to another. This enumeration value indicates that the account entry is a payment made to the account by a gift certificate. This enumeration value indicates that the account entry is a payment made to the account by wire transfer. This enumeration value indicates that the account entry is a payment made to the account through home bank. This enumeration value indicates that the account entry is a one-time payment made to the account by electronic transfer. This enumeration value indicates that the account entry is a credit made by eBay to the seller's account when a payment needs to be adjusted. This enumeration value indicates that the account entry is a debit (deduction) made by eBay to the seller's account when a payment needs to be adjusted. This enumeration value indicates that the account entry is an eBay write-off of an account charge. This enumeration value indicates that the account entry is the recovery of an eBay write-off of an acccount charge. This enumeration value indicates that the account entry is an eBay write-off of the account charges by eBay due to the seller declaring bankruptcy. This enumeration value may be returned as a note that the eBay write-off of an account charge has been suspended. This enumeration value indicates that the account entry is an eBay write-off of the account charges by eBay due to the decease of the seller. This enumeration value indicates that the account entry is an eBay write-off of the account charges by eBay due to the decease of the seller. This enumeration value indicates that the account entry is an eBay write-off of the account charges by eBay due to the wackiness of the seller. This enumeration value indicates that the account entry is a reversal of the finance charge to the user's account. A finance charge may be applicable if the user's monthly invoice balance is not paid in full by the due date. This enumeration value indicates that the account entry is a reversal of a Final Value Fee credit, resulting in the fee again being charged to the seller. This enumeration value indicates that the account entry is a fee charged for currency conversion. This enumeration value indicates that the account entry is a reversal of a check payment made with foreign funds. This enumeration value may be returned to act as a note that there is an 'End of the Month' restriction for account activity. This enumeration value may be returned if eBay is issuing a credit to the seller for multiple listing fees. This enumeration value may be returned to act as a note that the user's account is on hold. This enumeration value may be returned to act as a note to indicate that the state of the user's account has been reverted. This enumeration value indicates that the account entry is a monthly payment made by automatic direct debit to the seller's checking account, when the account information is on file. This enumeration value indicates that the account entry is a one-time payment made by direct debit to the seller's checking account, when the account information is not on file, but is provided for this payment. This enumeration value indicates that the account entry is a payment made by direct debit from the seller's checking account when the seller has requested automatic monthly invoice payments. This enumeration value indicates that the account entry is a reversal of a payment made by direct debit from the seller's checking account. This enumeration value indicates that the account entry is a reversal of a payment made by direct debit from a seller's checking account when an item is returned by the buyer. This enumeration value indicates that the account entry is a fee charged by eBay for adding a colored band to emphasize a listing. Note: This feature is no longer available to most marketplaces and sellers. This enumeration value indicates that the account entry is a credit issued to the seller by eBay for adding a colored band to emphasize a listing. Note: This feature is no longer available to most marketplaces and sellers. This enumeration value may be returned to act as a note to indicate that the user's account has been suspended as part of a bulk suspension initiated by eBay. This enumeration value indicates that the account entry is a fee charged for a 30-day classified ad listing in a Real Estate category. This enumeration value indicates that the account entry is a credit issue to a seller for a 30-day classified ad listing in a Real Estate category. This enumeration value is only used internally. This enumeration value is only used internally. This enumeration value indicates that the account entry is a fee charged to a seller who did not provide a credit card or checking account number to verify identify. This enumeration value indicates that the account entry is a credit issued to a seller who was charged an Equifax fee. This enumeration value indicates that the account entry is a payment made by the seller for an Equifax fee. This enumeration value indicates that the account entry is a credit issued by eBay to the seller for a payment made on an Equifax fee. This enumeration value may be returned to act as a note to indicate that the user's two accounts (same owner, but different user IDs) have been merged into one account. The Auto Trader feature is no longer available for motor vehicle listings. The Auto Trader feature is no longer available for motor vehicle listings. This enumeration value is no longer applicable as paper invoices are no longer available. Users must download their invoices from My eBay. This enumeration value is no longer applicable as paper invoices are no longer available. Users must download their invoices from My eBay. This enumeration value may be returned to act as a note to indicate that there has been a change in the status of the user's account. This enumeration value indicates that the account entry is an automatic reversal of a Final Value Fee credit. This enumeration value indicates that the account entry is a credit issued by eBay to the seller if a title search outage of one hour or longer occurs on the site. This enumeration value is no longer applicable as Live Auction listings are no longer available on any eBay marketplace. This enumeration value is no longer applicable as Live Auction listings are no longer available on any eBay marketplace. This enumeration value is no longer applicable as Live Auction listings are no longer available on any eBay marketplace. This enumeration value is no longer applicable as Live Auction listings are no longer available on any eBay marketplace. This enumeration value is no longer applicable as Live Auction listings are no longer available on any eBay marketplace. This enumeration value is no longer applicable as Live Auction listings are no longer available on any eBay marketplace. This enumeration value is no longer applicable as Live Auction listings are no longer available on any eBay marketplace. This enumeration value is no longer applicable as Live Auction listings are no longer available on any eBay marketplace. This enumeration value is no longer applicable as Live Auction listings are no longer available on any eBay marketplace. This enumeration value is no longer applicable as Live Auction listings are no longer available on any eBay marketplace. This enumeration value is no longer applicable as the iPix photo feature is no longer available on any eBay marketplace. This enumeration value is no longer applicable as the iPix photo feature is no longer available on any eBay marketplace. This enumeration value is no longer applicable as the iPix photo feature is no longer available on any eBay marketplace. This enumeration value is no longer applicable as the iPix photo feature is no longer available on any eBay marketplace. A fee charged for listing an item for 10 days, rather than one, three, five, or seven days. This enumeration value indicates that the account entry is a credit issued to a seller for a 10-day auction listing. This enumeration value indicates that the account entry is a temporary credit from eBay to the user. This enumeration value indicates that the account entry is the reversal of a temporary credit from eBay to the user. This enumeration value is no longer applicable as the Auction Assistant feature is no longer available on any eBay marketplace. This enumeration value is no longer applicable as the Auction Assistant feature is no longer available on any eBay marketplace. This enumeration value is no longer applicable as the Auction Assistant feature is no longer available on any eBay marketplace. This enumeration value is no longer applicable as the Auction Assistant feature is no longer available on any eBay marketplace. This enumeration value indicates that the account entry is a fee charged by eBay for a super-sized picture in a listing. This enumeration value indicates that the account entry is a credit issued by eBay to the seller for a super-sized picture in a listing. This enumeration value is no longer applicable as eBay no longer charges a fee for adding photos to listings. This enumeration value is no longer applicable as eBay no longer charges a fee for adding photos to listings. This enumeration value is no longer applicable as eBay no longer charges a fee for adding photos to listings. This enumeration value indicates that the account entry is a monthly subscription fee charged for the user's eBay Store. This enumeration value indicates that the account entry is a credit toward the user's eBay Store subscription fee. This enumeration value indicates that the account entry is an insertion fee for a fixed-price listing. This enumeration value indicates that the account entry is an insertion fee credit for a fixed-price listing. This enumeration value indicates that the account entry is a final value fee for a sale on the fixed-price listing. This fee is charged when a listed item sells, and is a percentage of the final sale price. This enumeration value indicates that the account entry is a credit for a final value fee for a sale on the fixed-price listing. A final value fee may be credited back to a seller's account if the buyer never pays for the line item, or if the buyer cancels the order. This enumeration value is no longer applicable since paper invoices are no longer available, so electronic invoices are the only option. Users must download their invoices from My eBay. This enumeration value is no longer applicable since paper invoices are no longer available, so electronic invoices are the only option. Users must download their invoices from My eBay. This enumeration value acts as a note to indicate that a direct debit payment is pending. This enumeration value acts as a note to indicate that a direct debit payment is confirmed. This enumeration value indicates that the account entry is a fee charged by eBay for creating a fixed-price listing with a 10-day duration. Note: This charge may only be applicable to motor vehicle listings on eBay Motors, eBay Canada (English and French versions), eBay UK, and eBay Italy. For all non-motor vehicle categories, the only available listing duration is 'GTC', or 'Good 'til Cancelled'. This enumeration value indicates that the account entry is a credit issued by eBay to the seller for creating a fixed-price listing with a 10-day duration. Note: The 10-day duration fee is only applicable to motor vehicle listings on eBay Motors, eBay Canada (English and French versions), eBay UK, and eBay Italy. For all non-motor vehicle categories, the only available listing duration is 'GTC', or 'Good 'til Cancelled'. This enumeration value indicates that the account entry is a fee charged by eBay if the seller uses the 'Buy It Now' feature on an auction listing. This enumeration value indicates that the account entry is a credit issued by eBay if the seller uses the 'Buy It Now' feature on an auction listing. This enumeration value indicates that the account entry is a fee charged by eBay if the seller uses the scheduled listing feature for a listing. With scheduled listings, the seller schedules a listing to start at some later time (up to 3 weeks after) instead of immediately. This enumeration value indicates that the account entry is a credit issued by eBay to the seller if the seller needs to be refunded for a scheduled listing. With scheduled listings, the seller schedules a listing to start at some later time (up to 3 weeks after) instead of immediately. This enumeration value indicates that the account entry is the monthly subscription fee charged for the basic version of Selling Manager. For most eBay marketplaces and sellers, there is no subscription charge to use the basic version of Selling Manager. This enumeration value indicates that the account entry is the monthly subscription fee charged for using the Selling Manager Pro product. This enumeration value indicates that the account entry is a credit for the monthly subscription fee charged for the basic version of Selling Manager. For most eBay marketplaces and sellers, there is no subscription charge to use the basic version of Selling Manager. This enumeration value indicates that the account entry is a credit for the monthly subscription fee charged for using the Selling Manager Pro product. This enumeration value indicates that the account entry is a fee charged to the seller when a 'Good 'til Cancelled', fixed-price listing automatically renews after each month (as long as inventory is still available or 'out-of-stock' feature is on). This fee is similar to an insertion fee when a listing is first created. 'GTC' listings automatically renew each month, and these renewed listings may incur insertion fees unless the seller has 'zero insertion fee' credits. eBay sellers with stores get more 'zero insertion fee' credits than other sellers. This enumeration value indicates that the account entry is a credit issued by eBay to refund the seller for a 'Good 'til Cancelled' listing renewal/insertion fee. 'GTC' listings automatically renew each, and these renewed listings may incur insertion fees unless the seller has 'zero insertion fee' credits. eBay sellers with stores get more 'zero insertion fee' credits than other sellers. This enumeration value is no longer appplicable as sellers are no longer able to use Listing Designer templates when they create or revise listings. This enumeration value is no longer appplicable as sellers are no longer able to use Listing Designer templates when they create or revise listings. This enumeration value is no longer applicable as there is no additional fee charged to the seller for creating a 10-day auction listing. This enumeration value is no longer applicable as there is no additional fee charged to the seller for creating a 10-day auction listing. This enumeration value is no longer applicable. This enumeration value is no longer applicable. This enumeration value is no longer applicable. This enumeration value is no longer applicable. This enumeration value indicates that the account entry is a charge back. This enumeration value indicates that the account entry is the reversal of a charge back. This enumeration value is no longer applicable. This enumeration value is no longer applicable as the 'Anything Points' program is no longer available. This enumeration value is no longer applicable as the 'Anything Points' program is no longer available. This enumeration value is no longer applicable as the 'Anything Points' program is no longer available. This enumeration value is no longer applicable as the 'Anything Points' program is no longer available. This enumeration value is no longer applicable as the 'Anything Points' program is no longer available. This enumeration value is no longer applicable as the 'Anything Points' program is no longer available. This enumeration value indicates that the account entry is a credit to the seller's account for Value-Added Tax (VAT) previously paid by the seller. This enumeration value indicates that the account entry is a debit to the seller's account for a Value-Added Tax (VAT) charge. This enumeration value acts as a note to indicate that a VAT status change to the seller's account is pending. This enumeration value acts as a note to indicate that a VAT status change to the seller's account is approved. This enumeration value acts as a note to indicate that a VAT status change to the seller's account was denied. This enumeration value acts as a note to indicate that a VAT status change to the seller's account was cancelled by an eBay customer support representative. This enumeration value acts as a note to indicate that a VAT status change to the seller's account was cancelled by the user. This enumeration value is no longer appplicable as sellers are no longer able to use Listing Designer templates when they create or revise listings. This enumeration value is no longer appplicable as sellers are no longer able to use Listing Designer templates when they create or revise listings. This enumeration value is no longer applicable as <code>StoresFixedPrice</code> is no longer a valid listing type. This enumeration value is no longer applicable as <code>StoresFixedPrice</code> is no longer a valid listing type. This enumeration value is no longer applicable as there is no longer a referral fee charged to sellers when buyers are routed to their store through printed materials or emails. This enumeration value is no longer applicable as there is no longer a referral fee charged to sellers when buyers are routed to their store through printed materials or emails. This enumeration value indicates the account entry is a fee charged to the seller for adding a subtitle to a listing. Subtitles allow sellers to provide more keywords and/or descriptive information, and may increase buyers' interest. This enumeration value indicates the account entry is a credit issued from eBay to compensate the seller for a subtitle fee charged to their account. This enumeration value is no longer applicable as <code>StoresFixedPrice</code> is no longer a valid listing type. This enumeration value is no longer applicable. This enumeration value is no longer applicable. This enumeration value is no longer applicable as the Picture Manager feature is no longer available. This enumeration value is no longer applicable as the Picture Manager feature is no longer available. This enumeration value is no longer applicable as the Seller Reports feature is no longer available. This enumeration value is no longer applicable as the Seller Reports feature is no longer available. This enumeration value is no longer applicable as the Seller Reports feature is no longer available. This enumeration value is no longer applicable as the Seller Reports feature is no longer available. This enumeration value is no longer applicable. This enumeration value is no longer applicable. This enumeration value is no longer applicable. This enumeration value is no longer applicable as borders around listing photos are no longer supported on any eBay marketplace. This enumeration value is no longer applicable as borders around listing photos are no longer supported on any eBay marketplace. This enumeration value is no longer applicable since placing eBay Germany motor vehicle listings on the mobile.de site is no longer supported. This enumeration value indicates the account entry is a monthly subscription fee charged for Sales Reports Plus. This enumeration value indicates the account entry is a credit to the seller applied towards the monthly subscription fee charged for Sales Reports Plus. This enumeration value is no longer applicable since placing eBay Germany motor vehicle listings on the mobile.de site is no longer supported. This enumeration value is no longer applicable since this eBay Stores marketing feature is no longer supported. This enumeration value is no longer applicable since this eBay Stores marketing feature is no longer supported. This enumeration value is no longer applicable since the picture slide show feature is no longer available. This enumeration value is no longer applicable since the picture slide show feature is no longer available. This enumeration value indicates the account entry is a fee charged to the seller for using the Pro Pack Bundle feature pack (currently available to US and Canada eBay motor vehicle sellers). This enumeration value indicates the account entry is a credit towards the fee charged to the seller for using the Pro Pack Bundle feature pack (currently available to US and Canada eBay motor vehicle sellers). This enumeration value is no longer applicable since this bundle pack is no longer available on any eBay marketplaces. This enumeration value is no longer applicable since this bundle pack is no longer available on any eBay marketplaces. This enumeration value indicates the account entry is a fee charged by eBay to the seller for using the Value Pack Bundle feature pack. This enumeration value indicates the account entry is a credit towards the fee charged to the seller for using the Value Pack Bundle feature pack. This enumeration value indicates the account entry is a fee charged by eBay to the seller for using the Pro Pack Plus Bundle feature pack. This enumeration value indicates the account entry is a credit towards the fee charged by eBay to the seller for using the Pro Pack Plus Bundle feature pack. This enumeration value indicates the account entry is the final entry in a user's account before it is closed or merged with another account. This enumeration value is Reserved for future use. This enumeration value indicates that the account entry is a fee charged to the seller for using an extended listing duration. This enumeration value indicates that the account entry is a credit towards a fee charged to the seller for using an extended listing duration. This enumeration value indicates that the account entry is a 'cross-border trade' fee, where the seller pays an additional listing fee to have his/her listing surface in the search on another eBay marketplace. This enumeration value indicates that the account entry is a credit towards a 'cross-border trade' fee, where the seller pays an additional listing fee to have his/her listing surface in the search on another eBay marketplace. This enumeration value indicates that the account entry is a fee for an expired Terapeak Research subscription. This enumeration value indicates that the account entry is a credit towards a fee for an expired Terapeak Research subscription. This enumeration value indicates that the account entry is a fee for a Terapeak Research basic subscription. This enumeration value indicates that the account entry is a credit towards a fee for a Terapeak Research basic subscription. This enumeration value indicates that the account entry is a fee for a Terapeak Research pro subscription. This enumeration value is no longer applicable since a basic bundle pack is no longer available on any eBay marketplace. This enumeration value is no longer applicable since a basic bundle pack is no longer available on any eBay marketplace. This enumeration value indicates that the account entry is a credit towards a fee for a Terapeak Research pro subscription. This enumeration value is no longer applicable as there are no longer any subscription fees to sell motor vehicles through Motors local listings. This enumeration value is no longer applicable as there are no longer any subscription fees to sell motor vehicles through Motors local listings. This enumeration value indicates that the account entry is an insertion fee for a Motors local listing. This enumeration value indicates that the account entry is a credit towards an insertion fee for a Motors local listing. This enumeration value indicates that the account entry is a final value fee for the sale of a motor vehicle through a Motors local listing. This enumeration value indicates that the account entry is credit towards a final value fee for the sale of a motor vehicle through a Motors local listing. This enumeration value indicates that the account entry is a 'GTC' duration listing fee for a Motors local listing. This enumeration value indicates that the account entry is a credit towards a 'GTC' duration listing fee for a Motors local listing. This enumeration value indicates that the account entry is an eBay Motors Pro fee. Applies to eBay Motors Pro registered dealers only. This enumeration value indicates that the account entry is a credit towards an eBay Motors Pro fee. Applies to eBay Motors Pro registered dealers only. This enumeration value indicates that the account entry is an eBay Motors Pro fee for a Feature pack. Applies to eBay Motors Pro registered dealers only. This enumeration value indicates that the account entry is a credit towards an eBay Motors Pro fee for a Feature pack. Applies to eBay Motors Pro registered dealers only. This enumeration value indicates that the account entry is a fee charged by eBay for listing an item with the Gallery Plus feature. This enumeration value indicates that the account entry is a credit towards a fee charged by eBay for listing an item with the Gallery Plus feature. This enumeration value indicates that the account entry is a fee for a private listing. With a private listing, bidders/buyers remain anonymous to other eBay users (besides the seller). This enumeration value indicates that the account entry is a fee for a private listing. With a private listing, bidders/buyers remain anonymous to other eBay users (besides the seller). This enumeration value is no longer applicable, and should not be returned. This enumeration value is no longer applicable, and should not be returned. This enumeration value is no longer applicable, and should not be returned. This enumeration value is no longer applicable, and should not be returned. This enumeration value is no longer applicable, and should not be returned. This enumeration value is no longer applicable, and should not be returned. This enumeration value is no longer applicable, and should not be returned. This enumeration value is no longer applicable, and should not be returned. This enumeration value indicates that the account entry is a seller discount against a final value fee, an insertion fee, a subscription fee, or other fee. See the corresponding Description and/or Memo fields for more information on the type of discount. This enumeration value indicates that the account entry is a credit towards a final value fee for the shipping cost of an order. This fee is charged when a listed item sells, and is a percentage of the shipping cost. The final value fee associated with the final sale price is returned in a FeeFinalValue entry. This enumeration value indicates that the account entry is a final value fee for the shipping cost of an order. This fee is charged when a listed item sells, and is a percentage of the shipping cost. The final value fee associated with the final sale price is returned in a FeeFinalValue entry. This enumeration value indicates that the account entry is a return shipping fee if an item is returned by the buyer. This enumeration value indicates that the account entry is a credit toward a return shipping fee if an item is returned by the buyer. This enumeration value indicates that the account entry is a fee charged by eBay if the seller is using the Global Shipping Program to ship an item internationally. This enumeration value indicates that the account entry is a credit towards a fee charged by eBay if the seller is using the Global Shipping Program to ship an item internationally. This enumeration value indicates that the account entry is a fee charged to the seller's account if the seller ends an auction (with bids) early. This enumeration value indicates that the account entry is a credit issued by eBay to the seller's account if a duplicate auction listing is ended administratively by eBay. A seller is only eligible for this credit if the auction listing had zero bids and was never surfaced in Search. This enumeration value indicates that the account entry is a fee charged to the seller for printing out and using a FedEx shipping label from eBay. This enumeration value indicates that the account entry is a credit issued by eBay to reimburse the seller for a FedEx shipping label. In some cases, this credit may be issued to the seller as a result of an Unpaid Item case that the seller has won against a buyer. This enumeration value indicates that the account entry is a fee charged to the seller's account if eBay refunds the buyer in a case where the buyer has used the eBay returns process and return shipped the item to the seller, but the seller has not issued a refund to the buyer within seven business days after receiving the returned item. This enumeration value indicates that the account entry is a credit issued to the buyer's account by eBay in a case where the buyer has used the eBay returns process and return shipped the item to the seller, but the seller has not issued a refund to the buyer within seven business days after receiving the returned item. The buyer credit amounts to the total purchase price plus any shipping costs if the item was 'not as described'. This enumeration value indicates that the account entry is a fee charged for early termination of an eBay Stores subscription. This enumeration value indicates that the account entry is a credit toward a fee charged for early termination of an eBay Stores subscription. This enumeration value indicates that the account entry is a fee charged for early termination of a National Vehicle subscription. This enumeration value indicates that the account entry is a credit toward a fee charged for early termination of a National Vehicle subscription. This enumeration value indicates that the account entry is a monthly subscription fee charged for a National Vehicle subscription. This enumeration value indicates that the account entry is a credit toward a monthly subscription fee charged for a National Vehicle subscription. This enumeration value indicates that the account entry is a fee charged to the seller for printing out and using an Australia Post shipping label from eBay. This enumeration value indicates that the account entry is a credit toward a fee charged to the seller for printing out and using an Australia Post shipping label from eBay. In some cases, this credit may be issued to the seller as a result of an Unpaid Item case that the seller has won against a buyer. This enumeration value indicates that the account entry is a fee charged to the seller for printing out and using an FedEx shipping label from eBay in the Asia-Pacific geographical region. This enumeration value indicates that the account entry is a credit toward a fee charged to the seller for printing out and using an FedEx shipping label from eBay in the Asia-Pacific geographical region. In some cases, this credit may be issued to the seller as a result of an Unpaid Item case that the seller has won against a buyer. This enumeration value indicates that the account entry is a fee charged to the seller for printing out and using an Track & Trace (TNT) shipping label from eBay in the Asia-Pacific geographical region. This enumeration value indicates that the account entry is a credit toward a fee charged to the seller for printing out and using an Track & Trace (TNT) shipping label from eBay in the Asia-Pacific geographical region.In some cases, this credit may be issued to the seller as a result of an Unpaid Item case that the seller has won against a buyer. This enumeration value indicates that the account entry is a fee charged for eBay Money Back Guarantee reimbursement. This enumeration value indicates that the account entry is a credit toward a fee charged for eBay Money Back Guarantee reimbursement. This value is deprecated. Instead, Promoted Listing fees are returned as <code>FeeAd</code> for a Standard Promoted Listing ad on eBay or <code>AdFeePremium</code> for an Advanced Promoted Listing ad on eBay. This value is deprecated. Instead, Promoted Listing credits are returned as <code>CreditAd</code> for a Standard Promoted Listing ad on eBay or <code>AdFeePremiumCredit</code> for an Advanced Promoted Listing ad on eBay. This enumeration value indicates that the account entry is a fee charged for a Standard Promoted Listing ad on eBay. With Standard Promoted Listings, the seller is charged a fee when a buyer clicks on the ad and then goes on to purchase that same item within 30 days of that click. The seller chooses the bid percentage for the ad, and this rate is applied toward the total purchase price. This enumeration value indicates that the account entry is a credit issued toward a Standard Promoted Listing ad fee. This enumeration value indicates that the account entry is a fee charged to the seller for printing out and using a Universal Business Integration (UBI) shipping label from eBay. This enumeration value indicates that the account entry is a credit issued by eBay to reimburse the seller for a Universal Business Integration (UBI) shipping label. In some cases, this credit may be issued to the seller as a result of an Unpaid Item case that the seller has won against a buyer. This enumeration value indicates that the account entry is an annual subscription fee charged for an eBay Plus subscription. This enumeration value indicates that the account entry is a credit toward an annual subscription fee charged for an eBay Plus subscription. This enumeration value indicates that the charge is a payment processing fee for the order. This fee is only applied at the order level, and the amount of the fee will be the same, regardless of how many line items are in the order or on the total cost of the order. Typically, this fee is $0.30. This enumeration value indicates that the credit is for a payment processing fee for the order. This enumeration value indicates that the charge is a payment processing fee for the order. This fee is only applied at the order level, and the amount of the fee will be the same, regardless of how many line items are in the order or on the total cost of the order. Typically, this fee is $0.30. This enumeration value indicates the credit is a seller reimbursement for an eBay payment intermediation fee. This enumeration value indicates the invoice credit is a seller reimbursement for an eBay payment intermediation fee. This enumeration value indicates the invoice charge is a Final Value Fee (for item cost) charged to the seller's account after a buyer creates and wins a 'significantly not as described' (SNAD) case against the seller. This enumeration value indicates the invoice charge is a Final Value Fee (for shipping cost) charged to the seller's account after a buyer creates and wins a 'significantly not as described' (SNAD) case against the seller. This enumeration value indicates the invoice charge is for a 'Highline Search' fee, which is a capability that allows sellers to advertise multiple products at the same time, with ads appearing prominently on top of eBay's search results. This enumeration value indicates the invoice credit is for a 'Highline Search' fee that was charged to the seller's account. The 'Highline Search' capability allows sellers to advertise multiple products at the same time, with ads appearing prominently on top of eBay's search results. This enumeration value indicates the invoice credit is for a Final Value Fee (for item cost) that was charged to the seller's account after a buyer created a 'significantly not as described' (SNAD) case against the seller, but the seller won the case. This enumeration value indicates the invoice credit is for a Final Value Fee (for shipping cost) that was charged to the seller's account after a buyer created a 'significantly not as described' (SNAD) case against the seller, but the seller won the case. This enumeration value indicates that the account entry is a fee charged for a Advanced Promoted Listing ad on eBay. With Advanced Promoted Listings, the seller uses keywords to promote the listing, and if buyers find the listing based on a keyword defined in the seller's Promoted Listings campaign, the seller is charged a fee each time the ad is clicked. The seller chooses the bid percentage rate for the ad, and this rate is charged for each click on the ad. This enumeration value indicates that a credit was issued toward an Advanced Promoted Listing ad fee. This enumeration value is no longer applicable, and should not be returned. Instead, the payment processing fee for all orders is represented with the <code>FinalValueFeeFixedFeePerOrder</code> value. This enumeration value is no longer applicable, and should not be returned. Instead, any credit for a payment processing fee is represented with the <code>FinalValueFeeFixedFeePerOrderCredit</code> value. This enumeration value indicates the invoice charge is for a Vehicles Listing Basic Package fee. This enumeration value indicates that a credit was issued for a Vehicles Listing Basic Package fee charge. This enumeration value indicates the invoice charge is for a Vehicles Listing Plus Package fee. This enumeration value indicates that a credit was issued for a Vehicles Listing Plus Package fee charge. This enumeration value indicates the invoice charge is for a Vehicles Listing Premium Package fee. This enumeration value indicates that a credit was issued for a Vehicles Listing Premium Package fee charge. This enumeration value indicates the invoice charge is for a Send Label fee. This enumeration value indicates that a credit was issued for a Send Label fee charge. This enumeration value indicates the invoice charge is for a UPS Label fee. This enumeration value indicates that a credit was issued for a UPS Label fee charge. This enumeration value indicates the invoice charge is for a Canada Post Label fee. This enumeration value indicates that a credit was issued for a Canada Post Label fee charge. This enumeration value indicates the invoice charge is for eBay having to resend/regenerate a shipping label for a seller. Sellers typically have 24 hours to reprint a shipping label 24 hours after the purchase of the shipping label. If a seller tries to reprint a purchased shipping label after this time, a small fee may apply. This enumeration value indicates that a credit was issued for the fee charged by eBay to resend/regenerate a shipping label for the seller. This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value indicates that eBay is billing the seller for a USPS shipping label that was purchased through the seller's eBay account. This enumeration value indicates that eBay is giving a credit to the seller for a USPS shipping label that was purchased through the seller's eBay account. This enumeration value indicates that eBay is billing the seller for shipping insurance (such as ShipCover through USPS) that was purchased through the seller's eBay account. This enumeration value indicates that eBay is giving a credit to the seller for shipping insurance (such as ShipCover through USPS) that was purchased through the seller's eBay account. This enumeration value indicates that eBay is billing the seller for underpayment for a USPS shipping label that was purchased through the seller's eBay account. Underpayment may occur if the seller paid for a shipping label based on specific package weight and dimensions, but either or both package weight and dimensions were not accurate, hence the seller owes more money to USPS for postage. This enumeration value indicates that eBay is giving credit to the seller for underpayment for a USPS shipping label that was purchased through the seller's eBay account. Underpayment may occur if the seller paid for a shipping label based on specific package weight and dimensions, but either or both package weight and dimensions were not accurate, hence the seller owes more money to USPS for postage. This enumeration value indicates that eBay is billing the seller for a co-funding charge. This enumeration value indicates that eBay is giving credit to the seller for a co-funding charge. This enumeration value indicates that the account entry is a final value fee, which is a fee that is calculated as a percentage of the total amount of the order, including the purchase price and any shipping and handling charges. This fee is always deducted directly from the seller payout associated with the order. For more information about how transaction fees are handled, see the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/selling-fees?id=4822#section2" target="_blank">Selling fees</a> help page. This enumeration value indicates that the account entry is a credit towards a final value fee calculated for an order. The seller may get this credit for different reasons, including if the buyer cancels the order, or the buyer doesn't pay for the order and the seller files and wins an Unpaid Item case. This enumeration value indicates that the account entry is an international fee, which is a fee that is calculated as a percentage of the total amount of the order, and is applicable for international buyers. This fee is always deducted directly from the seller payout associated with the order. Note: For more information about this international fee, see the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/selling-fees?id=4822#section8" target="_blank">Selling fees</a> help page. This enumeration value indicates that the account entry is a credit towards an international fee calculated for an order. The seller may get this credit for different reasons, including if the buyer cancels the order, or the buyer doesn't pay for the order and the seller files and wins an Unpaid Item case. This enumeration value indicates that the account entry is a payment processing fee, which is a fixed fee that is charged for all orders. This fixed fee may vary by country, but it is currently $0.30 in the US. This fee is always deducted directly from the seller payout associated with the order. Note: For more information about how transaction fees are handled, see the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/selling-fees?id=4822#section2" target="_blank">Selling fees</a> help page. This enumeration value indicates that the account entry is a credit against a payment processing fee. Except for perhaps a very unlikely and unusual situation, the payment processing fee will generally not be refunded to the seller. This enumeration value indicates that the account entry is an additional final value fee for a Below Standard seller. Typically, this fee will be an additional 5 percent (on top of standard final value fee) of the total amount of the order, including the purchase price and any shipping and handling charges. It is possible that this fee may also be charged to an Above Standard or Top-rated seller if that seller is having an issue with 'item not as described' return requests. This fee is always deducted directly from the seller payout associated with the order. Note: For more information about this additional final value fee for sellers, see the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/selling-fees?id=4822#section6" target="_blank">Selling fees</a> help page. This enumeration value indicates that the account entry is a credit against an additional final value fee for a Below Standard seller. This enumeration value indicates that the account entry is a Promoted Listing Express fee. This enumeration value indicates that the account entry is a credit applied against a Promoted Listing Express fee. This enumeration value indicates that the account entry is a Motor Vehicles Deposit processing fee. eBay charges the seller a 2.8 percent processing fee (against the required deposit amount) when they sell their vehicle through a listing that required that the buyer make an initial deposit for the vehicle. This enumeration value indicates that the account entry is a credit applied against a Motor Vehicles Deposit processing fee. This enumeration value is deprecated. All Motor Vehicles Deposit processing fees are indicated with the <code>DepositProcessingFee</code> value. This enumeration value is deprecated. All credits against Motor Vehicles Deposit processing fees are indicated with the <code>DepositProcessingFeeCredit</code> value. This enumeration value indicates that the seller was charged a fee for a FedEx return shipping label. This enumeration value indicates that the seller received a credit against a fee for a FedEx return shipping label. This enumeration value indicates that the seller was charged a fee for an Australia Post return shipping label. This enumeration value indicates that the seller received a credit against a fee for an Australia Post return shipping label. This enumeration value indicates that the seller was charged a fee for a UPS Canada shipping label. This enumeration value indicates that the seller received a credit against a fee for a UPS Canada shipping label. This enumeration value indicates that the seller was charged a fee for a FedEx Canada shipping label. This enumeration value indicates that the seller received a credit against a fee for a FedEx Canada shipping label. This enumeration value indicates that the seller was charged a fee for a Hubbed return shipping label. This enumeration value indicates that the seller received a credit against a fee for a Hubbed return shipping label. This enumeration value indicates that the seller was charged a fee for a Royal Mail return shipping label. This enumeration value indicates that the seller received a credit against a fee for a Royal Mail return shipping label. This enumeration value indicates that the seller was charged a fee for a Parcel Force Post return shipping label. This enumeration value indicates that the seller received a credit against a fee for a Parcel Force Post return shipping label. This enumeration value indicates that the seller was charged a fee for offsite ad clicks for a Promoted Listing Advanced campaign. This enumeration value indicates that the seller was issued a credit against a fee for offsite ad clicks for a Promoted Listing Advanced campaign. This enumeration value indicates that the seller was charged a fee for Promoted Display. This enumeration value indicates that the seller was issued a credit against a fee for Promoted Display. This enumeration value indicates that US Federal tax was witheld and deducted from the seller's payout funds. This enumeration value indicates that the seller was issued a credit against US Federal tax that was witheld and deducted from the seller's payout funds. This enumeration value indicates that US State tax was witheld and deducted from the seller's payout funds. This enumeration value indicates that the seller was issued a credit against US State tax that was witheld and deducted from the seller's payout funds. This enumeration value indicates that the seller was charged an Eco Participation fee. This enumeration value indicates that the seller was issued a credit against an Eco Participation fee. This enumeration value indicates that the seller was charged a fee for a Canadian Post return shipping label. This enumeration value indicates that the seller was issued a credit against a fee for a Canadian Post return shipping label. This enumeration value indicates that the seller was charged a fee for a Hermes return shipping label. This enumeration value indicates that the seller was issued a credit against a fee for a Hermes return shipping label. This enumeration value indicates that the seller was charged a fee for a payout to their bank account. Note: This fee is for future use, and will initially only apply to sellers based in mainland China if they choose to receive payout funds through a bank account instead of through their Payoneer account. This enumeration value indicates that the seller was issued a credit against a fee for a payout to their bank account. This enumeration value indicates that the seller donated a portion of their sale proceeds to a charitable organization. This enumeration value indicates that the seller was issued a credit against a donation to a charitable organization. This enumeration value indicates the fee charged by eBay when a seller requests a payout through a debit card. This enumeration value indicates that the fee charged to the seller for a direct payout failed and the fee will be credited back to the seller's debit card. This enumeration value indicates the seller was charged a fee for a Hermes return shipping label and any applicable tax. Return shipping labels are subject to tax, which is payable by the seller. This enumeration value indicates that the seller was issued a credit against a fee for a Hermes return shipping label. This enumeration value indicates the seller was charged a fee for a DHL return shipping label and any applicable tax. Return shipping labels are subject to tax, which is payable by the seller. This enumeration value indicates that the seller was issued a credit against a fee for a DHL return shipping label. This enumeration value indicates that a fee is charged by eBay to cover the costs associated with complying with regulatory requirements in specific marketplaces. Note: Currently, this fee is only applicable in the following marketplaces: United Kingdom, Italy, France, Spain, Austria, Belgium (Dutch), Belgium (French), Poland, Ireland, and Switzerland. This enumeration value indicates that a credit against a fee to cover the costs associated with complying with regulatory requirements in specific marketplaces was issued. Note: Currently, this fee is only applicable in the following marketplaces: United Kingdom, Italy, France, Spain, Austria, Belgium (Dutch), Belgium (French), Poland, Ireland, and Switzerland. This enumeration value indicates that the seller was charged a fee for DHL processing. Note: Currently, this fee is only applicable in the German marketplace. This enumeration value indicates that the seller was issued a credit against a fee charged a fee for DHL processing. Note: Currently, this fee is only applicable in the German marketplace. Type defining the array of AccountEntry objects that are conditionally returned in the GetAccount response. Container consisting of detailed information for each debit or credit transaction that occurs on an eBay user's account. GetAccount Conditionally Enumerated type defining the possible values that can be used in the AccountEntrySortType field of the GetAccount request to sort account entries returned in the response. This is the default value. With this value set, account entries in the GetAccount response are sorted by transaction date (see AccountEntry.Date field) in ascending order (oldest transaction to most recent transaction). This value will produce the same results as the AccountEntryCreatedTimeAscending value. With this value set, account entries in the GetAccount response are sorted by transaction date (see AccountEntry.Date field) in ascending order (oldest transaction to most recent transaction). This value will produce the same results as the None value. With this value set, account entries in the GetAccount response are sorted by transaction date (see AccountEntry.Date field) in descending order (most recent transaction to oldest transaction). With this value set, account entries in the GetAccount response are sorted by Item ID value (see AccountEntry.ItemID field) in ascending order (oldest eBay listing to most recent eBay listing). With this value set, account entries in the GetAccount response are sorted by Item ID value (see AccountEntry.ItemID field) in descending order (most recent eBay listing to oldest eBay listing). With this value set, account entries in the GetAccount response are sorted in alphabetical order according to each entry's AccountEntry.Description value. When account entries are sorted according to fee type, the secondary sort criterion is transaction date, and for account entries with identical fee types, the oldest account entries will appear first in the response. With this value set, account entries in the GetAccount response are sorted in reverse alphabetical order according to each entry's AccountEntry.Description value. When account entries are sorted according to fee type, the secondary sort criterion is transaction date, and for account entries with identical fee types, the oldest account entries will appear first in the response. (out) Reserved for internal or future use. Type defining the AccountEntry container returned in the GetAccount response. Each AccountEntry container consists of detailed information for a single credit or debit transaction, or an administrative action which occurred on the eBay user's account. This enumeration value indicates the type of transaction or administrative action that occurred on the eBay user's account. Possible values are defined in the AccountDetailEntryCodeType enumerated type. GetAccount Conditionally The category of the monetary transaction or administrative action applied to an eBay account. GetAccount Conditionally This field is no longer returned. If the eBay user has an outstanding balance owed to eBay, the owed amount will be displayed in the AccountSummary.CurrentBalance field in the GetAccount response. GetAccount Conditionally Timestamp indicating the date and time that the entry was posted to the account, in GMT. GetAccount Conditionally Gross fees that are assessed by eBay (net fees plus VAT, if any). Returned even if VAT does not apply. The value is positive for debits and negative for credits. GetAccount Conditionally If the account entry is associated with an eBay listing, this field shows the eBay ItemID value. If there is no correlation between the account entry and one of the user's eBay listings, '0' is returned in this field. GetAccount Conditionally Memo line for the account entry. It can be an empty string. GetAccount Conditionally The rate used for the currency conversion for a transaction. GetAccount Conditionally Net fees that are assessed by eBay, excluding additional surcharges and VAT (if any). Returned even if VAT does not apply. The value is positive for debits (user pays eBay) and negative for credits (eBay pays user). GetAccount Conditionally This value is the unique identifier for the account entry. This value is created by eBay once the transaction occurs on the user's account. GetAccount Conditionally The applicable rate that was used to calculate the VAT (Value-Added Tax) for the transaction. When the VATPercent is specified for a listing, the item's VAT information appears on the View Item page. In addition, the seller can choose to print an invoice that includes the item's net price, VAT percent, VAT amount, and total price. Since VAT rates vary depending on the item and on the user's country of residence, a seller is responsible for entering the correct VAT rate; it is not calculated by eBay. VAT is only applicable to sellers located in a European Union (EU) country. If VAT does not apply to the account entry, this field is still returned but it's value will be '0'. GetAccount Conditionally A description or comment about the monetary transaction or administrative action applied to an eBay user account. GetAccount Conditionally OrderLineItemID is a unique identifier for an eBay order line item. This field is only returned if the account entry is associated with an order line item. GetAccount Conditionally The unique identifier of an order line item. This field is only returned if the account entry is associated with an order line item. The TransactionID value for auction listings is always <code>0</code> since there can be only one winning bidder/one sale for an auction listing. Note: Historically, TransactionID values have been '0' for auction listings, and some developers may have built logic around this. However, non-zero TransactionID values for auction listings started being used for some eBay marketplaces beginning in July 2024, and all eBay marketplaces are expected to start using non-zero TransactionID values for auction listings in the near future. If necessary, developers should update code to handle non-zero transaction IDs for auction transactions. GetAccount Conditionally This boolean field is returned as <code>true</code> if the seller received a discount on the Final Value Fee for the order line item. Only Top-Rated sellers are eligible for this Final Value Fee discount. The Final Value Fee discount percentage varies by country. For more information on becoming a Top-Rated Seller in the US and the requirements for Top-Rated Plus listings, see the <a href="https://www.ebay.com/help/selling/seller-levels-performance-standards/seller-levels-performance-standards?id=4080" target="_blank">Becoming a Top Rated Seller</a> help topic. This field will not be returned until eBay bills the seller for the Final Value Fee for the eligible order line item. GetAccount Conditionally This field is returned if the account fee or credit is associated with an entire (single or multiple line item) order, and not necessarily for a single line item within the order. GetAccount Conditionally This container is an array of one or more discounts applied to the corresponding accounty entry. This container will not be returned if there are no discounts applied to the corresponding accounty entry. GetAccount Conditionally This boolean field is returned with each account entry if the IncludeNettedEntries field is included in the request and set to <code>true</code>. The value indicates whether or not the corresponding account entry value (charge or credit) is a part of the 'Total Netted Charge Amount' or 'Total Netted Credit Amount' values returned in the AccountSummary.NettedTransactionSummary container. If this value is <code>true</code>, it indicates that the corresponding fee was deducted from a seller payout. If the value is <code>false</code>, it indicates that the fee or credit was invoiced to the seller instead. GetAccount Conditionally This enumerated type contains the suppported values that may be used in the AccountHistorySelection field to control the account entries that are returned in a GetAccount response. SpecifiedInvoice This value should be used if the eBay user wants to see the account entries posted to the last invoice that was sent to the user by eBay. If this value is used, the InvoiceDate, BeginDate, and EndDate fields of the GetAccount request are no longer applicable and will be ignored if they are included in the call request. This value is no longer applicable or supported, and an error occurs if it is used. As an alternative, users can use <code>BetweenSpecifiedDates</code> instead. This value should be used if the eBay user wants to see account entries for a customized date range that can overlap multiple formal eBay invoices. If this value is used, then you also must specify BeginDate and EndDate to set the date range for which to retrieve account entries. If this value is used, then InvoiceDate is no longer applicable and will be ignored if it is included in the call request. This value should be used if the eBay user wants to see the account entries related to a specific eBay order. If this value is used, the user must also include the OrderID field and sets its value to the identifier of the order for which they wish to retrieve account entries. (out) Reserved for internal or future use. Enumerated type that lists the possible states of an eBay user account. This value indicates that the eBay user account is active. This value indicates that the eBay user account has been created, but is not yet active, pending additional information or processing by eBay. This value indicates that the eBay user account is inactive. No new seller account entries would be posted by eBay to the account. Reserved for internal or future use. Summary data for the requesting user's seller account as a whole. This includes a balance for the account, any past due amount and date, and defining data for additional accounts (if the user has changed country of residency while having an active eBay account). Indicates the current state of the account (such as active or inactive). Possible values are enumerated in AccountStateCodeType. GetAccount Conditionally This field specifies the payment amount that has been made by the user for the invoice. This field is only returned if a payment has been made towards the invoice, and if the AccountHistorySelection input field's value was set to <code>LastInvoice</code>. This field is not returned if the AccountHistorySelection input field's value was set to <code>BetweenSpecifiedDates</code> and a custom time period (overlapping multiple billing cycles) was specified. If a credit was issued by eBay to the user instead, this credit will be shown in the InvoiceCredit field. GetAccount Conditionally This field specifies the credit amount that has been issued to the user's account by eBay for the invoice. This field is only returned if a credit has been issued towards the invoice, and if the AccountHistorySelection input field's value was set to <code>LastInvoice</code>. This field is not returned if the AccountHistorySelection input field's value was set to <code>BetweenSpecifiedDates</code> and a custom time period (overlapping multiple billing cycles) was specified. If a payment was made by the user instead, this payment amount will be shown in the InvoicePayment field. GetAccount Conditionally This field specifies the balance of any new fees that have been assessed toward the user's account since the last invoice was created. This field is only returned if the AccountHistorySelection input field's value was set to <code>LastInvoice</code>. This field is not returned if the AccountHistorySelection input field's value was set to <code>BetweenSpecifiedDates</code> or <code>OrderId</code>. If there have been no fees since the last invoice was created, this value will be <code>0.0</code>. GetAccount Conditionally This container shows the identifier and current balance for another eBay account associated with the eBay user. This container will appear under the AccountSummary container for each additional account that the eBay user owns. GetAccount Conditionally This value indicates the amount of money that is past due on the user's account. If no money is past due, this value will be <code>0.0</code>. GetAccount Conditionally This string value represents the first four digits of the bank account the associated with the user account. This field is only applicable if a bank account is being used to pay monthly invoices. 4 GetAccount Conditionally This timestamp indicates the date and time when the owner of the account last changed the bank account on file as the primary payment method. This field may not be returned if the bank account on file has never been changed, or if the primary payment method is not a bank account. GetAccount Conditionally This integer value indicates the day of the month on which eBay sends a billing invoice to the user. A value of <code>0</code> indicates that an invoice is sent on the last day of each month. A value of <code>15</code>15 indicates that an invoice is sent on the 15th day of each month. GetAccount Conditionally This timestamp indicates the expiration date for the credit card that is currently on file and used to pay monthly invoices. This field may not be returned if the primary method is not a credit card. GetAccount Conditionally This string value represents the last four digits of the credit card that the user selected as payment method for the account. This field is only applicable if a credit card is being used to pay monthly invoices. GetAccount Conditionally This timestamp indicates the date and time when the owner of the account last changed the credit card on file as the primary payment method. This field may not be returned if the credit card on file has never been changed, or if the primary payment method is not a credit card. GetAccount Conditionally This field shows the current balance for the user's account. This value can be <code>0.0</code>, a positive amount (debit), or a negative amount (credit). This field is only returned if the ExcludeBalance flag is included in the call request and set to <code>false</code>. GetAccount Conditionally This field specifies the balance for the invoice. This field is only returned if the AccountHistorySelection input field's value was set to <code>LastInvoice</code>. This field is not returned if the AccountHistorySelection input field's value was set to <code>BetweenSpecifiedDates</code> and a custom time period (overlapping multiple billing cycles) was specified. The value is positive for debits and negative for credits. GetAccount Conditionally This timestamp indicates the date and time of the invoice. This field is only returned if the AccountHistorySelection input field's value was set to <code>LastInvoice</code>. This field is not returned if the AccountHistorySelection input field's value was set to <code>BetweenSpecifiedDates</code> and a custom time period (overlapping multiple billing cycles) was specified. GetAccount Conditionally This field shows the amount of the last payment that was made by the user. GetAccount Conditionally This timestamp shows the date and time of the last payment that was made by the user. GetAccount Conditionally This boolean field indicates whether or not the account has a past due balance. A value of <code>true</code> indicates that the account is past due, and a value of <code>false</code> indicates that the account is current. If the account is past due, the amount past due can be found in the AmountPastDue field. GetAccount Conditionally This enumeration value indicates the primary payment method used by the user to pay monthly eBay invoices. GetAccount Conditionally This container shows the total amount of fees (and credits if applicable) that have already been paid through seller payout deductions. The seller must include the IncludeNettedEntries field in the request and set it to <code>true</code> in order for this container to be returned. GetAccount Conditionally This enumerated type contains a list of values that will indicate whether or not an Ad Format listing type is enabled for an eBay site or for an eBay category. This value indicates that the Classified Ad format feature is disabled for the site or category. This value indicates that the Classified Ad format feature is enabled for the site or category. This value indicates that the Classified Ad format is the only listing type supported by the eBay category. This value is not applicable at the eBay site level. This value indicates that the lead-generation Classified Ad format feature is enabled for the site or category. This value indicates that the lead-generation Classified Ad format is the only listing type supported by the eBay category. This value is not applicable at the eBay site level. This value indicates that eBay Motors Local Market listings are enabled for the site or category. (out) Reserved for internal or future use. Type defining the AdFormatEnabled field that is returned under the FeatureDefinitions container if <code>AdFormatEnabled</code> is used as a FeatureID value in the request, or if no FeatureID values are used in the request. This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support Classified Ad listings. To verify if a specific eBay site supports Classified Ad listings (for most categories), look for a <code>true</code> value in the SiteDefaults.AdFormatEnabled field. To verify if a specific category on a specific eBay site supports Classified Ad listings, pass in a CategoryID value in the request, and then look for a <code>true</code> value in the AdFormatEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Enumerated type that indicates to the owner of a classified ad whether or not an email correspondence from a prospective buyer has been answered. This value will appear in the response if there is a new message from a prospective buyer that the seller has not yet responded to. This value will appear in the response if the seller has already responded to the prospective buyer's message. (out) Reserved for internal or future use. This type is used by the AdFormatLead container that is returned in the GetAdFormatLeads call response. An AdFormatLead container will be returned for each user that has expressed interest in the Classified Ad listing that was specified by the seller in the GetAdFormatLeads call request. Each AdFormatLead container consists of prospective buyer contact information and other details associated with a lead for a Classified Ad listing. This field shows the message that was sent from the prospective buyer to the seller. This will be the same content that is returned in the AdFormatLead.MemberMessage.MemberMessageExchange.Question.Body field (that is only displayed if the IncludeMemberMessages boolean field is included in the request and set to <code>true</code>). The advantage of retrieving the MemberMessageExchange node, however, is that you retrieve the entire exchange between the seller and the prospective buyer. GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally This container consists of contact information for the prospective buyer. This container will not be returned if the buyer did not provide any contact information. GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally The time of day when the prospective buyer prefers to be contacted by the seller. This field is not returned if this information is unavailable. GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally Email address for the prospective buyer. If the prospective buyer chooses to hide his email address when contacting the seller, this element contains two dashes (--) instead of an email address. GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally Date and time (in GMT) that the lead was submitted. GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally The unique identifier of the listing. GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally The title of the listing. 80 GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally The eBay user ID of the user who is interested in the seller's item. Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally Contains any mail message content shared between the seller and prospective buyer. GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally The enumeration value in this field will indicate whether or not the seller has responded to the lead. GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally The pay-per-lead feature is no longer available, and this field is scheduled to be removed from the WSDL. Email address for the prospective buyer as entered in the lead form on the View Item page. Provides a way for sellers to contact prospective buyers who choose not to log in to eBay. This applies to only eBay Motors and eBay Motors categories. 128 GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally Prospective buyer's time frame for purchasing a vehicle as entered in the Lead form on View Item page for eBay Motors and eBay Motors categories. Purchasing Time Frames include: <ul> <li> within next 3 days </li> <li> within a week </li> <li> within a month </li> <li> within three months </li> <li> in more than three months </li> <li> within an undecided time frame </li> </ul> 255 GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally The year of the vehicle the prospective buyer would like to trade in. Entered on the lead form on the View Item page. Applies to eBay Motors and Motors categories only. 32 GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally The make of the vehicle the prospective buyer would like to trade in. Entered on the lead form on the View Item page. Applies to eBay Motors and Motors categories only. 128 GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally The model of the vehicle the prospective buyer would like to trade in. Entered on the lead form on the View Item page. Applies to eBay Motors and Motors categories only. 128 GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally Prospective buyer answer whether or not the prospective buyer would like financing. Entered on the lead form on the View Item page. Applies to eBay Motors and Motors categories only. Financing response meanings: 0= no response,1= yes, 2= no. GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally This field corresponds to a configurable question on the lead form in the View Item web page. The corresponding question is site-specific. To determine the question for a specific site, you must view the form in the web flow for the given site. This field applies to Classified Ad format listings in Motors categories only. GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally Type defining the AddItemRequestContainer containers that are used in an AddItems call. An AddItemRequestContainer container is required for each item being created through an AddItems call. Each item being created through an AddItems call is identified through a unique AddItemRequestContainer.MessageID value that is defined by the seller. Container holding all values that define a new listing. One Item container is required for each AddItemRequestContainer. AddItems Yes Most Trading API calls support a MessageID element in the request and a CorrelationID element in the response. With AddItems, a unique MessageID value is required for each AddItemRequestContainer container that is used in the request. The CorrelationID value returned under each AddItemResponseContainer container is used to correlate each item request container with its corresponding response container. The same MessageID value that you pass into a request will be returned in the CorrelationID field in the response. AddItems Yes Type defining the AddItemResponseContainer containers that are returned in an AddItems call. An AddItemResponseContainer container is returned for each item created through an AddItems call. Each item being created through an AddItems call is identified through a unique AddItemRequestContainer.MessageID value that is defined by the seller. To match up the AddItemResponseContainer to the AddItemRequestContainer, look for a AddItemResponseContainer.CorrelationID value that matches the AddItemRequestContainer.MessageID value in the request. Unique identifier for the new listing. This field is returned as long as the listing was successfully created. AddItems Always 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 included the Item.ScheduleTime field in the request and set a custom start time of the listing (in the future). AddItems Always Date and time when the new listing is scheduled to end based on the start time and the listing duration value that was set in the ListingDuration field at listing time. If the value of ListingDuration was set to <code>GTC</code> (Good 'Til Cancelled) this value will be set one month ahead of the start time, and this value will continue to be updated one month ahead each time the GTC listing needs to be renewed. Fixed-price listings get renewed automatically as long as there is still a quantity of <code>1</code> or above, or even if the quantity is <code>0</code>, but the 'out-of-stock control' feature is enabled. Note that <code>GTC</code> is not a supported listing duration for auction listings, but is the only supported listing duration for fixed-price listings except for a few motor vehicle categories on eBay Motors US, eBay UK, and eBay Italy. AddItems Always This container is an array of fees associated with the creation of the listing. The fees in this container will not include any fees that are based on the purchase price (such as transaction fees) and only come into play when the listing has a sale. All listing fee types are returned, even if those fees are not applicable for the revised listings and are '0.0'. Note: The currency used for all fees returned under the Fees container reflects the currency used for the listing site, and not necessarily in the seller's default/home currency. For example, if a Canadian seller is using the AddItems call to list items on the eBay US site, the currency type shown for each fee will be <code>USD</code> and not <code>CAD</code>. AddItems Always eBay.com Selling Fees https://www.ebay.com/help/selling/fees-credits-invoices/selling-fees?id=4822 Fees by marketplace https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/fees-by-marketplace.html The unique identifier of the primary category in which the item was listed. This field is only returned if the Item.CategoryMappingAllowed boolean field is set to <code>true</code> in the request (or omitted) and the Category ID passed in as the primary listing category was automatically mapped to a new Category ID by eBay. If the primary category ID passed in the request is still active/valid, this field is not returned. 10 AddItems Conditionally Unique identifier of the secondary category in which the item was listed. This field is only returned if the Item.CategoryMappingAllowed boolean field is set to <code>true</code> in the request (or omitted) and the Category ID passed in as the secondary listing category was automatically mapped to a new Category ID by eBay. If the secondary category ID passed in the request is still active/valid, this field is not returned. 10 AddItems Conditionally Most Trading API calls support a MessageID element in the request and a CorrelationID element in the response. With AddItems, a unique MessageID value is required for each AddItemRequestContainer container that is used in the request. The CorrelationID value returned under each AddItemResponseContainer container is used to correlate each item request container with its corresponding response container. The same MessageID value that you pass into a request will be returned in the CorrelationID field in the response. AddItems Always This container is an array of one or more errors and/or warnings (if any) that occurred when eBay attempted to create the corresponding listing. Note that one or more errors and/or warnings may also occur at the call-level. This container is only returned if there were one or more warnings and/or errors that occurred with the creation of the corresponding listing. AddItems Conditionally Supplemental information from eBay, if applicable. May elaborate on errors or provide useful hints for the seller. This data can accompany the call's normal data result set or a result set that contains only errors. The string can return HTML, including TABLE, IMG, and HREF elements. In this case, an HTML- based application should be able to include the HTML as-is in the HTML page that displays the results. A non-HTML application would need to parse the HTML and convert the table elements and image references into UI elements particular to the programming language used. Because this data is returned as a string, the HTML markup elements are escaped with character entity references (e.g.,<table><tr>...). AddItems Conditionally This container is an array of one or more listing fee/upgrade discount types being offered by eBay to the seller. AddItems Conditionally This type is used by the AddMemberMessagesAAQToBidderRequestContainer container. An AddMemberMessagesAAQToBidderRequestContainer container is required for each bidder the seller is sending a message to. The seller can communicate with up to 10 bidders with one AddMemberMessagesAAQToBidder call. A CorrelationID value is required for each AddMemberMessagesAAQToBidderRequestContainer container that is used in the request. The CorrelationID value returned under each AddMemberMessagesAAQToBidderResponseContainer container is used to correlate each member message container in the request with its corresponding member message container in the response. The same CorrelationID value that you pass into a request will be returned in the CorrelationID field in the response. AddMemberMessagesAAQToBidder Yes A unique identifier for an eBay listing. This field is required and identifies the active listing that is being discussed between the seller and the bidder. AddMemberMessagesAAQToBidder Yes This container consists of message body, the recipient(s) of the message, and a boolean flag to control whether or not a copy of the message is sent to the sender's My eBay Inbox. AddMemberMessagesAAQToBidder Yes This type is used by the AddMemberMessagesAAQToBidderResponseContainer container. A AddMemberMessagesAAQToBidderResponseContainer container is returned for each message that was sent from the seller to the bidders/potential buyers through a separate AddMemberMessagesAAQToBidderRequestContainer. The Ack value in each AddMemberMessagesAAQToBidderResponseContainer container indicates whether or not each message sent through the call was successful or not, and an AddMemberMessagesAAQToBidderResponseContainer is matched up to the corresponding AddMemberMessagesAAQToBidderRequestContainer through the CorrelationID value. This is a unique identifier for a message that was sent through the AddMemberMessagesAAQToBidder call. The seller must provide a CorrelationID value for each message that is sent through an AddMemberMessagesAAQToBidderRequestContainer container in the request. The CorrelationID value returned under each AddMemberMessagesAAQToBidderResponseContainer container is used to correlate each member message container in the request with its corresponding member message container in the response. AddMemberMessagesAAQToBidder Always This enumerated value indicates whether or not the corresponding message was successfully sent to the bidder(s)/potential buyer(s). If the value returned in this field is not <code>Success</code>, the message may have to be resent with another AddMemberMessagesAAQToBidder call. AddMemberMessagesAAQToBidder Always Contains the data for one additional account. An additional account is created when the user has an active account and changes country of registry (i.e., registers with the eBay site for the new country). A new account is created and the old account becomes inactive as an additional account. A user who never changes country of residency while having an account will never have any additional accounts. Indicates the current balance of the additional account. GetAccount Conditionally Indicates the currency in which monetary amounts for the additional account are expressed. GetAccount Conditionally Indicates the unique identifier for the additional account (the account ID). GetAccount Conditionally Type defining the AdditionalCompatibilityEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as <code>AdditionalCompatibilityEnabled</code> is included as a FeatureID value in the call request or no FeatureID values are passed into the call request). This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the Boats Parts Compatibility feature. To verify if a specific eBay site supports Boats Parts Compatibility (for most categories), look for a <code>true</code> value in the SiteDefaults.AdditionalCompatibilityEnabled field. To verify if a specific category on a specific eBay site supports Boats Parts Compatibility, pass in a CategoryID value in the request, and then look for a <code>true</code> value in the AdditionalCompatibilityEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). This enumerated type contains the possible values that can be returned in the type attribute of the AddressAttribute field. Currently, this type only contains one enumeration value, but in the future, other address attributes may be created for this type. This value indicates that the value returned in the AddressAttribute field is the reference ID for a "Click and Collect" order. Reserved for internal or future use. This type is used to display the value of the type attribute of the AddressAttribute field. The only supported value for this attribute is <code>ReferenceNumber</code>, but in the future, other address attributes may be supported. The <code>ReferenceNumber</code> is a unique identifier for a 'Click and Collect' order. Click and Collect orders are only available on the eBay UK and eBay Australia sites. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally PayPal Enumerated type used by the ShippingAddress.AddressOwner field in order management calls to indicate the owner of the shipping address on file. This value is deprecated. This value indicates that the buyer's shipping address being referenced is on file with eBay. Reserved for internal or future use. This enumerated type is deprecated. This value is not used. This value is not used. This value is not used. This enumerated type is deprecated. This value is not used. This value is not used. This value is not used. This value is not used. Contains the data for an eBay user's address. This is the base type for a number of user addresses, including seller payment address, buyer shipping address, and buyer and seller registration address. The eBay user's name associated with an address on file with eBay. Note: The Seller.RegistrationAddress container and its child fields will stop being returned in GetSellerTransactions on January 31, 2024. 128 GetItem RegistrationAddress

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll

GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetUserContactDetails Always GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally A concatenation of Street1 and Street2, primarily used for a registration address. GetBidderList Conditionally ShippingAddress GetItem RegistrationAddress

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally ShippingAddress GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll

AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No The first line of the user's street address. Note: Note the different maximum lengths noted below for different countries. If a street name exceeds the maximum length for the applicable country, the full street name may be expressed through both the Street1 and Street2 fields. GB, DE - 35; US, CA - 40; AU - 80; Other countries - 50 GetBidderList Conditionally ShippingAddress GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally ShippingAddress ShipToAddress GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally GetItem RegistrationAddress

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItem SellerContactDetails

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll

GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always The second line of the user's street address (such as an apartment number or suite number). Returned if the user specified a second street value for their address. Note: In case of Item.SellerContactDetails, Street2 can be used to provide City, Address, State, and Zip code (if applicable). Note: Note the different maximum lengths noted below for different countries. If a street name exceeds the maximum length for the applicable country, the full street name may be expressed through both the Street1 and Street2 fields. Note: In the case of TransactionArray.Transaction.MultiLegShippingDetails.SellerShipmentToLogisticsProvider.ShipToAddress, if the item is being shipped through eBay International Shipping and this address refers to an intermediated warehouse address, the eBay Virtual Tracking number (eVTN) that is used for the domestic leg of the shipment is appended to Street2. This value is generated by eBay when the order is completed. Example:"Reference #1234567890123456" GB, DE - 35; US, CA - 40; AU - 80; Other countries - 50 GetBidderList Conditionally ShippingAddress GetItem RegistrationAddress

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

SellerContactDetails Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally ShippingAddress ShipToAddress GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll

GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No The city associated with an address on file with eBay. Most addresses include a city name, but not all. For example, Singapore is an island city-state, so <code>SG</code> would appear in the Country field, and 'Singapore' or 'Republic of Singapore' would appear in the CountryName field, but the CityName field is not applicable. GB, DE - 35; US, CA - 40; AU - 80; Other countries - 50 GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally GetBidderList Conditionally ShippingAddress GetItem RegistrationAddress

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally ShippingAddress ShipToAddress GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll

GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetUserContactDetails Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The county associated with an address on file with eBay. This field should only be passed in or returned if applicable/defined. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

SellerContactDetails Conditionally The state or province associated with an address on file with eBay. Whether it's a state or a province will depend on the region and/or country. This field should only be passed in or returned if applicable/defined. GB, DE - 35; US, CA - 40; AU - 80; Other countries - 50 GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally GetBidderList Conditionally ShippingAddress GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally ShippingAddress ShipToAddress GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll

GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetUserContactDetails Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The two-digit code representing the country of the user. If not provided as input, eBay uses the country associated with the eBay Site ID when the call is made. GetAllBidders GetUserContactDetails Always GetBidderList GetUserPreferences Conditionally GetItem RegistrationAddress ShippingAddress

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

ShippingAddress ShipToAddress Conditionally GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetSellerList Conditionally HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll

GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

SetUserPreferences No The full name of the country associated with an address on file with eBay. eBay validates the content, but not the length for this field. Note: The eBay database allocates up to 128 characters for this field. GetBidderList Conditionally ShippingAddress GetItem RegistrationAddress

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

ShippingAddress ShipToAddress Conditionally GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll, ReturnSummary, none

GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always User's primary phone number. This may return a value of <code>Invalid Request</code> if:<ul><li>the seller has not enabled the preference for the <a href="https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/SetUserPreferences.html#Request.RequiredShipPhoneNumberPreference">RequiredShipPhoneNumberPreference</a> field</li><li>the buyer did not provide a phone number in the shipping address during the checkout process</li></ul> In the US, the area code (3 digits), the prefix (3 digits), the line number (4 digits), and phone extension (if specified by the user) are returned in this field. The extension can be one or more digits. Non-breaking spaces are used as delimiters between these phone number components. eBay validates the content (should only be integer values and delimiters), but not the length for this field. Note: The eBay database allocates up to 128 characters for this field. GetItem RegistrationAddress

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

ShippingAddress ShipToAddress Conditionally GetBidderList ShippingAddress Conditionally GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll

GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetUserContactDetails Always GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally Standard ISO code for the country of the user's primary telephone phone number. For Classified Ad listings, this code is used to look up the country's international calling prefix. Both the ISO code and country phone prefix are stored with listings of this type. This field applies to Classified Ad listings only. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

SellerContactDetails Conditionally Country Prefix of the secondary phone number. This value is derived from inputs supplied for PhoneCountryCode. This field applies to Classified Ad listings only. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

SellerContactDetails Conditionally Area or City Code of a user's primary phone number. This field applies to Classified Ad listings only. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

SellerContactDetails Conditionally The local number portion of the user's primary phone number. This field applies to Classified Ad listings only. Note: The full primary phone number is constructed by combining PhoneLocalNumber with PhoneAreaOrCityCode and PhoneCountryPrefix. 30 AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

SellerContactDetails Conditionally User's postal code. GB, DE - 35; US, CA - 40; AU - 80; Other countries - 50 GetBidderList Conditionally GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem RegistrationAddress ShippingAddress

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions ShippingAddress ShipToAddress

DetailLevel: none, ReturnAll

Conditionally GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll

GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally GetAllBidders Always GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always Unique ID for a user's address in the eBay database. This value can help prevent the need to store an address multiple times across multiple orders. The ID changes if a user changes their address. Note: For orders subject to Australian 'Goods and Services' tax (GST), in addition to the unique identifier for the address, the last two digits of the user's Australian Business Number (ABN) will also appear in this field. Australian 'Goods and Services' tax (GST) is automatically charged to buyers outside of Australia when they purchase items on the eBay Australia site. Note: The Seller.RegistrationAddress container and its child fields will stop being returned in GetSellerTransactions on January 31, 2024. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always This enumeration value returned here indicates the company that has the address on file. The value returned here should always be <code>eBay</code>. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally ShipToAddress Seller's international name that is associated with the payment address. This field is only applicable to seller payment/billing addresses. GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetBidderList Conditionally ShippingAddress International state and city that is associated with the seller's payment address. This field is only applicable to seller payment/billing addresses. GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetBidderList Conditionally ShippingAddress Seller's international street address that is associated with the payment address. This field is only applicable to seller payment/billing addresses. GetUser Conditionally SellerPaymentAddress

DetailLevel: ReturnAll

GetBidderList Conditionally ShippingAddress User's company name. This field should only be passed in or returned if applicable/defined. GetUserContactDetails Always GetBidderList Conditionally ShippingAddress AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

SellerContactDetails Conditionally GetUser Conditionally RegistrationAddress

DetailLevel: ReturnAll

Displays the first name of the seller (in a business card format) if the seller's SellerBusinessCodeType value is <code>Commercial</code>. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetAdFormatLeads Conditionally

DetailLevel: ReturnAll

Displays the last name of the seller (in a business card format) if the seller's SellerBusinessCodeType is set to <code>Commercial</code>. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetAdFormatLeads Conditionally

DetailLevel: ReturnAll

Secondary Phone number of the lead. Not returned if information is unavailable. GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally Uniquely identifies an order shipped using the Global Shipping Program. This value is generated by eBay when the order is completed. The international shipping provider uses the ReferenceID as the primary reference when processing the shipment. Sellers must include this value on the package immediately above the street address of the international shipping provider. Example: "Reference #1234567890123456" Note: International orders being sent through eBay International Shipping also contain reference IDs, but reference IDs for eBay International Shipping will be returned in the Street2 field instead. GetItemTransactions GetSellerTransactions GetOrders SellerShipmentToLogisticsProvider.ShipToAddress

DetailLevel: none, ReturnAll

Conditionally OrderReport SellerShipmentToLogisticsProvider.ShipToAddress Conditionally This field shows an attribute for the address, and its corresponding value. Currently, this field is only used to display the reference ID for a "Click and Collect" order, but in the future, other address attributes may be returned in this field. Note: The Seller.RegistrationAddress container and its child fields will stop being returned in GetSellerTransactions on January 31, 2024. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Type used by the AffiliateTrackingDetails container, which is included in the PlaceOffer call to pass in eBay Partner Network affiliate-related data, so affiliates can earn commissions based on user activity and the number of calls made by the user's application. Note: If you are using affiliate tracking, this field is required. The value you specify in this field is obtained from your tracking partner. For the eBay Partner Network, the TrackingID is the Campaign ID ("campid") provided by the eBay Partner Network. A Campaign ID is a 10-digit, unique number for associating traffic. A Campaign ID is valid across all programs to which you have been accepted. PlaceOffer Conditionally Note: If you are using affiliate tracking, this field is required. Specifies your tracking partner for affiliate commissions. Depending on your tracking partner, specify one of the following values. Not all partners are valid for all sites. For PlaceOffer, only eBay Partner Network is valid: 9 = eBay Partner Network For information about the eBay Partner Network, see <a href="https://www.ebaypartnernetwork.com" target="_blank">eBay Partner Network</a>. eBay Partner Network https://partnernetwork.ebay.com/ PlaceOffer Conditionally Note: If you are using affiliate tracking, this field is required. Type of device or platform from which the call originated. PlaceOffer Conditionally This field is not required, but an affiliate may want to use this identifier to better monitor marketing efforts. If you are using the eBay Partner Network, and you provide an AffiliateUserID, the tracking URL returned by eBay Partner Network will contain the AffiliateUserID, but it will be referred to as a "customid". Note: Effective September 26, 2025, both usernames and public user IDs will be accepted in this field. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. 256 PlaceOffer Conditionally An eBay-defined complex type for specifying monetary amounts. A double value (e.g., 1.00 or 1.0) is meaningful as a monetary amount when accompanied by a specification of the currency, in which case the value specifies the amount in that currency. An AmountType expresses both the value (a double) and the currency. The AmountType data type is typically used to specify details such as prices, fees, costs, and payments. In some cases, a whole number (i.e., without a period) can be passed or returned as a monetary value. This is necessary to support certain currencies that are only expressed as whole numbers. Because a double is used to represent the amount, this also means whole monetary amounts may be returned with only one 0 after the decimal. For example, a dollar value could be returned as 1.0 instead of 1.00 in calls like AddItem. Three-digit code representing the currency type being used. In Add/Revise/Relist calls, the currency can be specified in the Item.Currency field in requests instead. If you do specify this attribute in Add/Revise/Relist calls, the value must match the site currency (i.e., it must be the same as the value in Item.Currency) unless otherwise stated. In Add/Revise/Relist calls, listing fees are returned in the currency of the user's registration site. For example, a user who is registered on the eBay US site always sees their fees returned in USD, even when their listing request is sent to another site, such as eBay UK or eBay Germany. GetBidderList GetItemShipping GetMyeBaySelling Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally AddOrder Order.Total Yes GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetMyeBayBuying

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetShippingDiscountProfiles Conditionally SetShippingDiscountProfiles Conditionally RespondToBestOffer No InternationalShippingServiceOption ShippingServiceOptions ShippingServiceSelected Always GetBestOffers

DetailLevel: none, ReturnAll

Always GetOrders InternationalShippingServiceOption ShippingServiceOptions ShippingServiceSelected

DetailLevel: none, ReturnAll

Always OrderReport InternationalShippingServiceOption ShippingServiceOptions ShippingServiceSelected Always GetOrders InternationalShippingServiceOption ShippingServiceOptions ShippingServiceSelected

DetailLevel: none, ReturnAll

Conditionally OrderReport InternationalShippingServiceOption ShippingServiceOptions ShippingServiceSelected Conditionally GetSellerTransactions InternationalShippingServiceOption ShippingServiceOptions ShippingServiceSelected

DetailLevel: none

Conditionally PlaceOffer ConvertedCurrentPrice CurrentPrice Always PlaceOffer MinimumToBid Conditionally AddItem AddItems RelistItem ReviseItem VerifyAddItem No Always AddLiveAuctionItem ReviseLiveAuctionItem No Always GetAllBidders Yes Always RelistItem No SendInvoice ShippingInsuranceCost, ShippingServiceCost, ShippingServiceAdditionalCost, SalesTaxAmount, InsuranceFee No Part of the mechanism for eBay to control which announcement messages are to be made available to the user. No message is to be made available. A deprecation message is to be made available, but only if today's date is between AnnouncementMessageType.AnnouncementStartTime and AnnouncementMessageType.EventTime. A mapping message is to be made available, but only if today's date is after AnnouncementMessageType.EventTime. Both "Deprecation" and "Mapping" enumerations are to apply. Reserved for future use. Type defining the ShippingServiceDetails.DeprecationDetails container that is returned in the GeteBayDetails response. The ShippingServiceDetails.DeprecationDetails container consists of information related to a deprecated shipping service. The date on which an upcoming event can start to be announced. GeteBayDetails Conditionally The date on which the event occurs. This is also the ending date of the announcement that lead up to the event (see AnnouncementStartTime). GeteBayDetails Conditionally Control of what messages to display. GeteBayDetails Conditionally Type used by the ApplicationDeliveryPreferences container to control/indicate where and how Platform Notifications and/or Client Alerts are delivered to a user application, server, and/or email address. The URL to which eBay delivers all Platform Notifications and Client Alerts sent to the application. For delivery to a server, the URL must begin with "<code>https://</code>" and must be well formed. SetNotificationPreferences No GetNotificationPreferences Conditionally This field allows the user to enable or disable Platform Notifications and Client Alerts. Notice that disabling Platform Notifications and Client Alerts will not affect others preferences set in this container. SetNotificationPreferences No GetNotificationPreferences Conditionally The email address to which eBay sends all application markup and markdown event notifications. When setting the email address, input must be in the format "<code>mailto://youremailaddress@yoursite.com</code>". Note that the AlertEnable field must be set to <code>Enable</code> for alert emails to be sent. SetNotificationPreferences No GetNotificationPreferences Conditionally For SetNotificationPreferences: include and set AlertEnable to <code>Enable</code> to receive application markup and markdown alerts, or set to <code>Disable</code> to disable the alerts. If not included, the AlertEnable defaults to its current value. For GetNotificationPreferences: this field's value indicates whether application markup and markdown alerts are enabled or disabled. SetNotificationPreferences No GetNotificationPreferences Conditionally The value in this field indicates the type of schema to use for notification payloads. The only supported value is <code>eBLSchemaSOAP</code>, so this field no longer has to be included in a SetNotificationPreferences call, since it defaults to<code>eBLSchemaSOAP</code>. GetNotificationPreferences Conditionally The means of receipt of notification. In most cases, it is Platform (typical API calls and web interaction), so this is the default, if not specified. For wireless applications, use SMS. Do not test Client Alerts in production if you are currently using Platform Notifications. SetNotificationPreferences No GetNotificationPreferences Conditionally Use this field to specify the API version for all notifications for the calling application. If you do not specify PayloadVersion in SetNotificationPreferences, the API version for notifications will be based on the API version specified in your SetNotificationPreferences call. SetNotificationPreferences No GetNotificationPreferences Conditionally Defines settings for notification URLs (including the URL name in DeliveryURLName). You define settings for up to 25 notification URLs (including the URL name in DeliveryURLName) in separate DeliveryURLDetails containers. Associate a user token with notification URLs by using the token in a SetNotificationPreferences request that specifies the URL name or names in SetNotificationPreferencesRequest.DeliveryURLName. Use comma-separated format to specify multiple URL names in SetNotificationPreferencesRequest.DeliveryURLName. Notifications will be sent to these URL(s) if ApplicationDeliveryPreferencesType.ApplicationEnable is set to Enable. SetNotificationPreferences No GetNotificationPreferences Conditionally This enumerated type list the possible devices that may be running a affiliate user's application. The affiliate must mark the type of device that is running their application when the PlaceOffer call is made. This enumeration value indicates that the user's application is running in a browser. This enumeration value indicates that the user's application is a wireless application. This enumeration value indicates that the user's application is a desktop application. This enumeration value indicates that the user's application is running through a television set-top box. Reserved for future use. This enumerated type is deprecated. This value is not used. This value is not used. This value is not used. This value is not used. This enumerated type is deprecated. This type is used by the AuthenticityVerification container, which gives status on whether the order line item has passed or failed the authenticity inspection, or if the test is still pending. The following table describes the relationship between the Status and OutcomeReason fields. <table> <col /> <col /> <col /> <thead> <tr> <th> Status </th> <th> OutcomeReason </th> <th> Description </th> </tr> </thead> <tbody> <tr> <td>PENDING</td> <td>Not applicable</td> <td>Authenticity checks have not completed (the authentication status is pending). The order's authenticity is still unknown</td> </tr> <tr> <td>PASSED</td> <td>Not applicable</td> <td>The authentication has been accepted. The order is authentic. The authentication partner sends the order line item to the buyer with the message that the item is authentic</td> </tr> <tr> <td rowspan="2">PASSED_WITH_EXCEPTION There may be legal reasons or requirements such that the item cannot be labeled authentic. </td> <td>CUSTOMIZED</td> <td>The order line item has been altered or customized, and cannot be labeled as authentic but will be sent to the buyer</td> </tr> <tr> <td>MISCATEGORIZED</td> <td>The order line item was in the wrong eBay category and cannot be labeled as authentic but will be sent to the buyer</td> </tr> <tr> <td>PASSED_WITH_PARTIAL_FAILURE </td> <td>Dependent</td> <td>Multi-quantity use case where part of the order is authentic, but the other part of the order FAILED</td> </tr> <tr> <td rowspan="3">FAILED</td> <td>NOT_AUTHENTIC</td> <td>The order could not be authenticated. The authentication partner returns the order line item to the seller; refunds the buyer</td> </tr> <tr> <td>NOT_AS_DESCRIBED</td> <td>The order is not as described. The authentication partner returns the order line item to the seller; refunds the buyer</td> </tr> <tr> <td>NOT_AUTHENTIC_NO_RETURN</td> <td>This enumeration value indicates that the order line item was found as counterfeit and cannot be returned to the seller because of legal constraints; refunds the buyer</td> </tr> </tbody> </table> The value in this field indicates whether the order line item has passed or failed the authenticity inspection, or if the test and/or results are still pending. The possible values returned here are <code>PENDING</code>, <code>PASSED</code>, <code>PASSED_WITH_EXCEPTION</code>, <code>PASSED_WITH_PARTIAL_FAILURE</code>, or <code>FAILED</code>. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This field is returned after the third-party authenticator has performed the authentication inspection on the order line item. Different values will be returned based on whether the item passed or failed the authentication inspection. This field is not returned when the status value of the order line item is <code>PENDING</code> or <code>PASSED</code>. The possible values returned here are <code>CUSTOMIZED</code>, <code>MISCATEGORIZED</code>, <code>NOT_AUTHENTIC</code>, <code>NOT_AS_DESCRIBED</code>, or <code>NOT_AUTHENTIC_NO_RETURN</code>. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This container shows service cost to the buyer for an item that will go through the Authenticity Guarantee process. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Applicable to sites that support the Detailed Seller Rating (DSR) feature. The AverageRatingDetails container consists of the average detailed seller ratings in an area. When buyers leave an overall Feedback rating (positive, neutral, or negative) for a seller, they also can leave ratings in four areas: item as described, communication, shipping time, and charges for shipping and handling. Users retrieve detailed ratings as averages of the ratings left by buyers. The value shown in this field indicates the Detailed Seller Rating area. The corresponding Rating value is the average rating that the seller has received for this DSR area, and the RatingCount value is the total number of buyer ratings that the seller has received in this DSR area. When buyers leave an overall Feedback rating (positive, neutral, or negative) for a seller, they also can leave ratings in four areas: item as described, communication, shipping time, and charges for shipping and handling. GetFeedback Conditionally

DetailLevel: none, ReturnAll

This value is the seller's average rating (given by buyers) for the DSR area noted in the corresponding RatingDetail field. GetFeedback Conditionally

DetailLevel: none, ReturnAll

This value is the total count of buyer ratings given for the DSR area noted in the corresponding RatingDetail field. GetFeedback Conditionally

DetailLevel: none, ReturnAll

This type is used by the AverageRatingSummary container that is returned in the GetFeedback call to display the seller's rating information across the four different Detail Seller Rating areas. The Detail Seller Rating subject areas include Item as Described, Communication, Shipping Time, and Shipping and Handling charges. This enumeration value will indicate whether the statistics in each AverageRatingDetails container is for the last year (<code>FiftyTwoWeeks</code>) or the last month (<code>ThirtyDays</code>). GetFeedback Conditionally

DetailLevel: none, ReturnAll

Applicable to sites that support the Detailed Seller Ratings feature. Each AverageRatingDetails container consists of the average detailed seller ratings in an area. When buyers leave an overall Feedback rating (positive, neutral, or negative) for a seller, they also can leave ratings in four areas: item as described, communication, shipping time, and charges for shipping and handling. GetFeedback Conditionally

DetailLevel: none, ReturnAll

Base64 is a binary-to-text encoding scheme that represents binary data in an ASCII string format by translating it into a radix-64 representation. The term "Base64" originates from a specific MIME content transfer encoding. Note: This type contains the name or reference ID of the binary attachment, not the attachment data. This optional attribute allows the binary attachment to be named. UploadSiteHostedPictures No This type is deprecated. Enumerated type that defines the possible values that can be passed in to the Action field in a RespondToBestOffer request. This value should be passed in to the Action field to accept the Best Offer identified in the BestOfferID field. Note that only one Best Offer may be accepted in a single RespondToBestOffer call. This value should be passed in to the Action field to decline one or more Best Offers identified by one or more BestOfferID fields. Note that multiple Best Offers may be declined in a single RespondToBestOffer call. This value should be passed in to the Action field to counter a buyer's Best Offer or Counter Offer. Note that a seller may only counter one Best Offer in a single RespondToBestOffer call. If a seller is using the RespondToBestOffer call to counter a Best Offer, the counter offer price must be specified in the CounterOfferPrice field, and the quantity of items in the Best Offer must be specified in the CounterOfferQuantity field. Reserved for internal or future use. An array of one or more Best Offers. This type is used in the responses of the GetBestOffers and RespondToBestOffer calls. For GetBestOffers, each BestOffer container consists of detailed information on the Best Offer/Counter Offer, including the type of Best Offer (Best Offer, Buyer/Seller Counter Offer), amount of the Best Offer/Counter Offer, and status of Best Offer/Counter Offer. For RespondToBestOffer, each BestOffer container provides the status ('Success' or 'Failure') of the Best Offer action (Accept, Counter, or Decline), which are defined in <a href="types/BestOfferActionCodeType.html">BestOfferActionCodeType</a>. RespondToBestOffer Always GetBestOffers

DetailLevel: none, ReturnAll

Always Type defining the BestOfferAutoAcceptEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as <code>BestOfferAutoAcceptEnabled</code> or <code>BestOfferAutoDeclineEnabled</code> is included as a FeatureID value in the call request or no FeatureID values are passed into the call request). This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the Best Offer Auto Accept feature. To verify if a specific eBay site supports the Best Offer Auto Accept feature (for most categories), look for a <code>true</code> value in the SiteDefaults.BestOfferAutoAcceptEnabled field. To verify if a specific category on a specific eBay site supports the Best Offer Auto Accept feature, pass in a CategoryID value in the request, and then look for a <code>true</code> value in the BestOfferAutoAcceptEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Type defining the BestOfferAutoDeclineEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as <code>BestOfferAutoDeclineEnabled</code> or <code>BestOfferAutoAcceptEnabled</code> is included as a FeatureID value in the call request or no FeatureID values are passed into the call request). This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the Best Offer Auto Decline feature. To verify if a specific eBay site supports the Best Offer Auto Decline feature (for most categories), look for a <code>true</code> value in the SiteDefaults.BestOfferAutoDeclineEnabled field. To verify if a specific category on a specific eBay site supports the Best Offer Auto Decline feature, pass in a CategoryID value in the request, and then look for a <code>true</code> value in the BestOfferAutoDeclineEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Type defining the BestOfferCounterEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as <code>BestOfferCounterEnabled</code> is included as a FeatureID value in the call request or no FeatureID values are passed into the call request). This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the Best Offer Counter Offer feature. To verify if a specific eBay site supports the Best Offer Counter Offer feature (for most categories), look for a <code>true</code> value in the SiteDefaults.BestOfferCounterEnabled field. To verify if a specific category on a specific eBay site supports the Best Offer Counter Offer feature, pass in a CategoryID value in the request, and then look for a <code>true</code> value in the BestOfferCounterEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Type defining the BestOfferDetails container, which consists of Best Offer details associated with a listing. The BestOfferEnabled field in this container is used by Add/Revise/Relist calls to enable the Best Offer feature on a listing. The number of Best Offers made for this item, if any. In other words, if there are no Best Offers made, this field will not appear in the response. This field is not applicable to the Add/Revise/Relist calls. GetBidderList GetSellerList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetMyeBaySelling ActiveList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally This field indicates whether or not the Best Offer feature is enabled for the listing. A seller can enable the Best Offer feature for a listing as long as the category supports the Best Offer feature. To see if an eBay category supports the Best Offer feature, run a GetCategoryFeatures call, including <code>BestOfferEnabled</code> as a FeatureID value in the call request payload. A listing enabled with the Best Offer feature allows a buyer to bargain with the seller and make a lower-priced offer than the fixed price or the starting bid price for an auction listing. The seller can then decide whether to accept the buyer's Best Offer price or propose a counter offer higher than the Best Offer price, but lower than the fixed price or starting bid price. Note: The Best Offer feature is now available for auction listings on the following sites: US, Canada, UK, Germany, Australia, France, Italy, and Spain. However, sellers must choose between offering Best Offer or Buy It Now on an auction listing, as both features cannot be enabled on the same auction listing. If an auction listing is enabled with Best Offer, this feature will no longer be applicable once the listing receives its first qualifying bid. Note: Best Offer is not available for multi-variation listings. AddFixedPriceItem AddItem AddItems RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetBidderList Conditionally This is the amount of the buyer's current Best Offer. This field will not appear in the GetMyeBayBuying response if the buyer has not made a Best Offer. This field is also not applicable to the Add/Revise/Relist calls. GetMyeBayBuying BestOfferList

DetailLevel: none, ReturnAll

Conditionally This enumeration value indicates the status of the latest Best Offer from the buyer. This field is only applicable to the GetMyeBayBuying call, and will not appear in the response if the buyer has not made a Best Offer. GetMyeBayBuying Conditionally BestOfferList

DetailLevel: none, ReturnAll

Note: this field is no longer used. The Best Offer type is only returned in the BestOfferCodeType field of the GetBestOffers call, and the applicable values for Best Offer type (<code>BuyerBestOffer</code>, <code>BuyerCounterOffer</code>, <code>SellerCounterOffer</code>, etc.) are defined in BestOfferTypeCodeType. This field is deprecated. Type defining the BestOfferEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as <code>BestOfferEnabled</code> is included as a FeatureID value in the call request or no FeatureID values are passed into the call request). This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the Best Offer feature. To verify if a specific eBay site supports the Best Offer feature (for most categories), look for a <code>true</code> value in the SiteDefaults.BestOfferEnabled field. To verify if a specific category on a specific eBay site supports the Best Offer feature, pass in a CategoryID value in the request, and then look for a <code>true</code> value in the BestOfferEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Unique identifier for a Best Offer. This identifier is created once a prospective buyer makes a Best Offer on an item. Enumerated type that defines the possible values for the status of a Best Offer or a buyer's/seller's counter offer. This value indicates that the buyer's Best Offer on an item is awaiting the seller's response (accept, decline, counter offer). A buyer's Best Offer expires after 48 hours without a seller's response. Depending on context, this value can indicate that the buyer's offer or Best Offer was accepted by the seller, or that the seller's or buyer's counter offer was accepted by the other party, and the buyer completed the payment. Depending on context, this value can indicate that the buyer's Best Offer was declined by the seller, or that the seller's or buyer's counter offer was declined by the other party. Depending on context, this value can indicate that the buyer's Best Offer expired due to the passing of 48 hours with no seller response (accept, decline, counter offer), or that the seller's or buyer's counter offer expired due to the passing of 48 hours with no response from other party. Depending on context, this value can indicate that the buyer has retracted the Best Offer, or that the seller's or buyer's counter offer has been retracted. This value indicates that the Best Offer was ended by an eBay administrator. Depending on context, this value can indicate that a buyer's Best Offer or that the seller's or buyer's counter offer is in the active state. The <code>Active</code> value can also be used in the GetBestOffers request to retrieve only active Best Offers. Depending on context, this value can indicate that a buyer's Best Offer has been countered by the seller, or that the seller's or buyer's counter offer has been countered by the other party. This value indicates that the seller has accepted the buyers offer. The status will change to Accepted once the buyer completes payment. This value is used in the GetBestOffers request to retrieve all Best Offers in all states. This value is only applicable to the GetBestOffers call. This value indicates that the buyer and seller have come to agreement on a Best Offer price, but the seller is still waiting for payment from the buyer. If the buyer does not pay within 48 hours, the Best Offer will expire. This value indicates that the seller is waiting on the buyer to commit to buying the item at the counter offer price. (out) Reserved for internal or future use. Type defining the BestOffer container, which consists of information on one Best Offer or counter offer. This information includes the price of the offer, the expiration of the offer, and any messaging provided by the prospective buyer or seller. Unique identifier for a Best Offer. This identifier is created once a prospective buyer makes a Best Offer on an item. GetBestOffers

DetailLevel: none, ReturnAll

Always PlaceOffer Conditionally Timestamp indicating when a Best Offer will naturally expire (if the seller has not accepted or declined the offer). GetBestOffers

DetailLevel: none, ReturnAll

Always Container consisting of information about the prospective buyer who made the Best Offer. GetBestOffers

DetailLevel: none, ReturnAll

Always The amount of the Best Offer or counter offer. For this field to be returned, the user must have a relationship to the Best Offer, either as the seller, buyer, or potential buyer who has made the Best Offer or counter offer. GetBestOffers

DetailLevel: none, ReturnAll

Conditionally The status of the Best Offer or counter offer. For PlaceOffer, the only applicable values are <code>Accepted</code>, <code>AdminEnded</code>, <code>Declined</code>, and <code>Expired</code>. GetBestOffers

DetailLevel: none, ReturnAll

Always Accepted, AdminEnded, Declined, Expired PlaceOffer Conditionally The quantity of the item for which the buyer is making a Best Offer. This value will usually be <code>1</code>, unless the buyer is making an offer on multiple quantity of a line item in a multi-quantity listing. GetBestOffers

DetailLevel: none, ReturnAll

Always A prospective buyer has the option to include a comment when placing a Best Offer or making a counter offer to the seller's counter offer. This field will display that comment. 500 (in bytes) GetBestOffers

DetailLevel: ReturnAll

Conditionally A seller has the option to include a comment when making a counter offer to the prospective buyer's Best Offer. This field will display that comment. 500 (in bytes) GetBestOffers

DetailLevel: none, ReturnAll

Conditionally This value indicates whether the corresponding offer is a Best Offer, a seller's counter offer, or a buyer counter offer to the seller's counter offer. GetBestOffers

DetailLevel: none, ReturnAll

Always The value in this field (<code>Success</code> or <code>Failure</code>) will indicate whether or not the seller's attempt to accept, decline, or counter offer a Best Offer was successful. This field is only used by the RespondToBestOffer response. RespondToBestOffer Always This field is no longer applicable, as it formerly supported the Best Offer Beta feature which is no longer active. This field is no longer applicable, as it formerly supported the Best Offer Beta feature which is no longer active. Enumerated type that defines the possible offer types for the Best Offer feature. This value indicates that the offer is an original Best Offer made by a prospective buyer to the seller. This value indicates that the offer is a prospective buyer's counter offer against the seller's counter offer. This value indicates that the offer is a seller's counter offer against the seller's original Best Offer. Reserved for internal or future use. This enumerated type lists the possible actions that can be made on a listing or Best Offer and the possible states of a bid or Best Offer. NotUsed This value indicates that the action or state is unknown. This value is used in a PlaceOffer call if the buyer wants to bid on an auction listing. If this value is used, the prospective buyer must also include the Offer.MaxBid field in the PlaceOffer call and specify the maximum amount that they are willing to bid in an attempt to win the auction. eBay will automatically rebid on behalf of the buyer each time the buyer is outbid up until the time when their Offer.MaxBid value threshold is met. The GetAllBidders call will return this value as well if the buyer has set up automatic bidding using a maximum bid threshold. This value is no longer applicable. This value indicates that a buyer's Best Offer or a seller's or buyer's counter offer was retracted. This value cannot be used with the PlaceOffer call. This value indicates that a buyer's Best Offer or a seller's or buyer's counter offer was automatically retracted. This value cannot be used with the PlaceOffer call. This value indicates that a buyer's Best Offer or a seller's or buyer's counter offer was cancelled. This value cannot be used with the PlaceOffer call. This value indicates that a buyer's Best Offer or a seller's or buyer's counter offer was automatically cancelled. This value cannot be used with the PlaceOffer call. This value is returned in the GetAllBidders call if an absentee bid was made, which means that eBay made a bid on the auction listing on behalf of the buyer, who has set a maximum bid threshold. This value is not applicable for the PlaceOffer call, as the buyer would use the <code>Bid</code> value instead, as well as setting a Offer.MaxBid value that would specify the maxium amount that the buyer is willing to bid in an attempt to win the auction. This value is returned in the GetAllBidders call if the buyer purchased an item in an auction listing using the Buy It Now feature. This value is not applicable for the PlaceOffer call, as the buyer would use the <code>Purchase</code> value instead. This value is used in a PlaceOffer call if the buyer wants to purchase a fixed-price item or purchase an auction item enabled with the Buy It Now feature. Note that this call cannot be used to purchase items that require immediate payment. The GetAllBidders call will return this value as well if the buyer purchased the item. For items requiring immediate payment, the PlaceOffer call cannot be used for purchase. Reserved for future or internal use. This value is used in a PlaceOffer call if the buyer is proposing a Best Offer to the seller. The GetAllBidders call will return this value as well if the buyer proposed a Best Offer to the seller. This value is used in a PlaceOffer call if the buyer is proposing a counter offer to the seller's proposed counter offer. The GetAllBidders call will return this value as well if the buyer proposed a counter offer to the seller's counter offer. This value is used in a PlaceOffer call if the buyer is accepting a counter offer proposed by the seller. The GetAllBidders call will return this value as well if the buyer accepted a counter offer. This value is used in a PlaceOffer call if the buyer is declining a counter offer proposed by the seller. The GetAllBidders call will return this value as well if the buyer declined a counter offer. This type is used by the BidderNoticePreferences container, which consists of the seller's preference for receiving contact information for unsuccessful bidders in auction listings. This boolean field should be set to true in a SetUserPreferences call if the seller wishes to receive contact information for bidders who have bid on a seller's auction item, but did not win. This might be helpful to a seller if that seller wishes to proposed Second Chance Offers to these unsuccessful bidders if the seller has multiple, identical items, or if the winning bidder does not pay for the original auction item. This field is always returned with BidderNoticePreferences container in the GetUserPreferences response. GetUserPreferences Conditionally SetUserPreferences Conditionally Type defining the BiddingDetails container, which consists of information about the buyer's bidding history on a single auction item. Converted value (from seller's currency to buyer's currency) of the amount in the MaxBid field. This field is only applicable and returned if the buyer purchased an item from an eBay site in another country. For active items, it is recommended to refresh the listing's data every 24 hours to pick up the current conversion rates. GetMyeBayBuying BidList LostList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally This value is the dollar value of the highest bid that the buyer placed on the auction item. GetMyeBayBuying BidList LostList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally This value is the total number of bids that the buyer placed on the auction item throughout the duration of the listing. GetMyeBayBuying BidList LostList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally This field will only be returned if the buyer won the auction item, and if it is returned, its value will always be <code>1</code>. GetMyeBayBuying BidList LostList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally This field is returned as <code>true</code> if the prospective buyer is the current high bidder in an active listing. GetMyeBayBuying BidList

DetailLevel: none, ReturnAll

Conditionally Type used by the BiddingSummary container, which is returned in the GetAllBidders response if the IncludeBiddingSummary boolean field is included and set to <code>true</code> in the call request. The BiddingSummary container consists of bidding history information for a specific bidder (specified in the User.UserID field). This integer value indicates the length of time (in number of days) that is being used to calculate all counts in the BiddingSummary container. This value is generally <code>30</code> (days), which means that all counts in the container have been calculated from the present time and going back 30 days in the past. This field is always returned with the BiddingSummary container. GetAllBidders Conditionally This integer value indicates the total number of bids (from any and all eBay sellers) that the user has placed during the last 30 days (or the number of days specified in the SummaryDays field). This field is always returned with the BiddingSummary container. GetAllBidders Conditionally This integer value is actually a percentage value that indicates what percentage of the user's total number of bids during the last 30 days (or the number of days specified in the SummaryDays field) has been placed on auction items that the seller has listed. The percentage value is rounded up to the highest whole percentage number. This field is always returned with the BiddingSummary container. GetAllBidders Conditionally This integer value indicates the total number of bids to unique sellers that the user has placed during the last 30 days (or the number of days specified in the SummaryDays field). This field is always returned with the BiddingSummary container. GetAllBidders Conditionally This integer value indicates the total number of bids made with unique listing categories that the user has placed during the last 30 days (or the number of days specified in the SummaryDays field). This field is always returned with the BiddingSummary container. GetAllBidders Conditionally This integer value indicates the total number of bids that the user has retracted (from any and all sellers) during the last 30 days (or the number of days specified in the SummaryDays field). This field is always returned with the BiddingSummary container. GetAllBidders Conditionally This container provides information on each auction item that the user has placed a bid on during the last 30 days (or the number of days specified in the SummaryDays field). GetAllBidders Conditionally This enumerated type contains the possible values that can be returned in the ListingFeatureDetails.BoldTitle field to indicate whether or not bold listing titles are supported by the eBay site specified in the GeteBayDetails call request. This value indicates that bold listing titles are enabled for the eBay site specified in the GeteBayDetails call request. This value indicates that bold listing titles are disabled for the eBay site specified in the GeteBayDetails call request. Reserved for future use. Note: This enumerated type is deprecated as the Picture Border feature is no longer available on any eBay Marketplace sites. This value indicates that picture borders are enabled for the eBay site specified in the GeteBayDetails call request. This value indicates that picture borders are disabled for the eBay site specified in the GeteBayDetails call request. Reserved for internal or future use. Type defining the BrandMPNIdentifierEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as <code>BrandMPNIdentifierEnabled</code> is included as a FeatureID value in the call request or no FeatureID values are passed into the call request). This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the Brand/Manufacturer Part Number feature. To verify if a specific eBay site supports the Brand/Manufacturer Part Number feature (for most categories), look for a <code>true</code> value in the SiteDefaults.BrandMPNIdentifierEnabled field. To verify if a specific category on a specific eBay site supports the Brand/Manufacturer Part Number feature, pass in a CategoryID value in the request, and then look for a <code>true</code> value in the BrandMPNIdentifierEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category ID was passed in the request). Type defining the BrandMPN container which is used to identify a product (through a unique product brand and Manufacturer Part Number combination). Note: If a brand and/or MPN value is required for a category, it is highly recommended that the brand and MPN name/value pair is also passed in through an ItemSpecifics.NameValueList container, since brand and MPN values may be dropped from the listing if eBay is not able to find a eBay catalog product match based on the provided Brand/MPN pair. The brand of the product. Both Brand and MPN should be specified if the BrandMPN container is used, or an error may occur. If Brand is a required or recommended item specific for a category, but an MPN is not applicable to the category/product, the Brand value should be specified in an Item.ItemSpecifics.NameValueList container instead. Note: The BrandMPN container is not applicable for multiple-variation listings. For multiple-variation listings that use MPNs, the Brand value should be specified through an ItemSpecifics.NameValueList container, and the Manufacturer Part Numbers (MPNs) for each product variation should be specified through a VariationSpecifics.NameValueList container. 65 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally The manufacturer part number of the product. Use the value specified by the manufacturer. Both Brand and MPN must be specified if the BrandMPN container is used or an error may occur. Note: If the listing is being posted to a category that expects an MPN value, but one doesn't exist for the product, the seller must provide a string indicating that the product identifier is unavailable. This text varies by marketplace. Refer to <a href="https://developer.ebay.com/api-docs/sell/static/inventory/product-identifier-text.html" target="_blank">Product Identifier Text</a> for the specific text based on the listing marketplace. Note: The BrandMPN container is not applicable for multiple-variation listings. For multiple-variation listings that use MPNs, the Brand value should be specified through an ItemSpecifics.NameValueList container, and the Manufacturer Part Numbers (MPNs) for each product variation should be specified through a VariationSpecifics.NameValueList container. 65 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally Enumerated type that defines the eBay user's account type. This value indicates that the eBay user's account is a Partially Provisioned Account without buying and selling privileges on eBay. This value indicates that the eBay user's account is a fully provisioned account with buying and selling privileges on eBay. Type used by the BusinessSellerDetails container, which is returned in an Item node if the item's seller is registered on eBay as a Business Seller. This field shows the address on file for the Business Seller. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This field shows the Fax number on file for the Business Seller. This field is only returned if known and available. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This field shows the email address on file for the Business Seller. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This field shows any additional contact for the Business Seller in free-form text. This field is only returned if known and available. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This field shows the Trade Registration Number for the Business Seller. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This boolean field is returned as <code>true</code> if the Business Seller provides legal invoices to buyers. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This free-form text field provides the Business Seller's terms and conditions for doing business. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This container provides Value-Added Tax (VAT) details for the Business Seller, including the seller's VAT ID and the VAT percentage rate applicable to the item. VAT is similar to a sales and/or consumption tax, and it is only applicable to sellers selling on European sites. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Type defining the BuyerGuaranteeEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as <code>BuyerGuaranteeEnabled</code> is included as a FeatureID value in the call request or no FeatureID values are passed into the call request). This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the Buyer Guarantee feature. To verify if a specific eBay site supports the Buyer Guarantee feature (for most categories), look for a <code>true</code> value in the SiteDefaults.BuyerGuaranteeEnabled field. To verify if a specific category on a specific eBay site supports the Buyer Guarantee feature, pass in a CategoryID value in the request, and then look for a <code>true</code> value in the BuyerGuaranteeEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Type defining the BuyerPackageEnclosure container, which is returned in GetOrders (and other order management calls) if the 'Pay Upon Invoice' option is being offered to the buyer, and the seller is including payment instructions in the shipping package. A BuyerPackageEnclosure container will be returned for each shipping package containing payment instructions. The 'Pay Upon Invoice' option is only available on the German site. This attribute indicates the type of payment instructions included in the shipping package. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally Type defining the BuyerPackageEnclosures container, which is returned in GetOrders (and other order management calls) if the 'Pay Upon Invoice' option is being offered to the buyer, and the seller is including payment instructions in the shipping package(s). A BuyerPackageEnclosure container will be returned for each shipping package containing payment instructions. The 'Pay Upon Invoice' option is only available on the German site. A BuyerPackageEnclosure container will be returned for each shipping package containing payment instructions. The 'Pay Upon Invoice' option is only available on the German site. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally This enumerated type identifies all of the payment methods supported for the 'Pay Upon Invoice' feature. The 'Pay Upon Invoice' feature is only available through the eBay Germany marketplace. This enumeration value indicates that no payment method was specified by the seller. This enumeration value indicates that a credit card was used to pay for the order. This enumeration value indicates that a bank debit card was used to pay for the order. This enumeration value indicates that PayPal was used to pay for the order. This enumeration value indicates that Elektronisches Lastschriftverfahren (direct debit) was used to pay for the order. This enumeration value indicates that an unknown credit card was used to pay for the order. This enumeration value indicates that Elektronisches Lastschriftverfahren (direct debit) was used locally to pay for the order. This enumeration value indicates that a Master Card credit card was used to pay for the order. This enumeration value indicates that an American Express credit card was used to pay for the order. This enumeration value indicates that a Visa credit card was used to pay for the order. This enumeration value indicates that a Discover credit card was used to pay for the order. This enumeration value indicates that a Diners Club credit card was used to pay for the order. This enumeration value indicates that a JCB credit card was used to pay for the order. This enumeration value indicates that a Switch debit card was used to pay for the order. This enumeration value indicates that a Solo debit card was used to pay for the order. This enumeration value indicates that Giropay was used to pay for the order. This enumeration value indicates that BML was used to pay for the order. This enumeration value indicates that the 'Pay Upon Invoice' option was offered to the buyer on the Germany site. Reserved for internal or future use. This enumeration type indicates the item's eligibility status for eBay's Money Back Guarantee program. This value indicates that the item is ineligible for buyer protection. In many cases, the item is ineligible for buyer protection due to the listing category. This value indicates that the item is eligible for buyer protection. This value indicates that customer support has marked the item as ineligible per special criteria (e.g., seller's account closed). This value indicates that customer support has marked the item as eligible per special criteria. This value indicates that the item is ineligible for coverage under any buyer protection program. Reserved for internal or future use. Type defining the ApplyBuyerProtection container, which consists of details related to whether or not the item is eligible for buyer protection and which of the buyer protection programs will cover the item. This value indicates the type of buyer protection program applicable for the item. This field is always returned with the ApplyBuyerProtection container. GetItemTransactions Conditionally GetSellerTransactions Conditionally GetItem Conditionally This value indicates the item's eligibility for the buyer protection program listed in the ApplyBuyerProtection.BuyerProtectionSource field. This field is always returned with the ApplyBuyerProtection container. GetItemTransactions Conditionally GetSellerTransactions Conditionally GetItem Conditionally PayPal This enumeration type indicates the applicable buyer protection program that the item is eligible to be covered under. This value indicates that the item is possibly eligible for buyer protection under the eBay Money Back Guarantee program. This value is deprecated. Reserved for internal or future use. Type defining the BuyerRequirementDetails container, which indicates if the seller has set any buyer requirements that apply to a listing. Sellers use buyer requirements if they want to avoid working with 'risky' buyers, who may be brand new to eBay, have low/poor Feedback scores, or who have some unpaid item strikes or buyer-initiated cancellations. This field is returned as <code>true</code> if the seller has enabled the setting to block buyers/bidders who reside (according to their eBay primary shipping address) in countries that are on the seller's ship-to exclusion list. false GetBidderList GetSellerList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This field is returned as <code>true</code> if the seller has enabled the setting to block buyers/bidders with a feedback score of 0 from buying items. false GetBidderList GetSellerList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This container is returned if the seller has set a maximum quantity threshold buyer requirement. With this buyer requirement, a buyer is limited in regards to the quantity of a line item that may be purchased. This buyer requirement is only applicable to fixed-price listings where multiple quantity is available for purchase. In addition to setting a maximum quantity threshold buyer requirement, the seller can also choose to apply this threshold to only those prospective buyers who don't meet or exceed the minimum Feedback score threshold. GetBidderList GetSellerList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This container is returned if the seller has enabled a setting to block prospective buyers who have one or more unpaid items and/or buyer-initiated cancellations on their account during a specified time period. GetBidderList GetSellerList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Type defining the BuyerRoleMetrics container, which consists of details relating to the eBay buyer's one-year history of leaving feedback for the seller. This integer value indicates the number of positive feedback entries that the eBay user, acting in the buying role, has left for their order partner (seller) during the last one-year period, counting back from the present date. GetFeedback

DetailLevel: none, ReturnAll

Conditionally This integer value indicates the number of negative feedback entries that the eBay user, acting in the buying role, has left for their order partner (seller) during the last one-year period, counting back from the present date. GetFeedback

DetailLevel: none, ReturnAll

Conditionally This integer value indicates the number of neutral feedback entries that the eBay user, acting in the buying role, has left for their order partner (seller) during the last one-year period, counting back from the present date. GetFeedback

DetailLevel: none, ReturnAll

Conditionally This float value indicates the percentage of time that the eBay user, acting in the buying role, has left feedback for their order partner (seller) during the last one-year period, counting back from the present date. GetFeedback

DetailLevel: none, ReturnAll

Conditionally This type is used by various Get calls, including GetItem and GetOrders. Only the order management calls return the BuyerTaxIdentifier container, and each call that uses BuyerType uses the ShippingAddress container a little differently. This container shows the buyer's shipping address. Note: For an Authenticity Guarantee program order returned in GetItemTransactions or GetSellerTransactions, this is the address of the authenticator's warehouse. The authenticator is responsible for delivery to the buyer's shipping address. Note: For In-Store Pickup and Click and Collect orders, this is the address of the merchant's store where the buyer will pick up the order. This is only applicable for GetItemTransactions and GetSellerTransactions calls. Note: For eBay Vault scenarios: GetItemTransactions calls, and GetSellerTransactions calls (Seller View only), mock address details are returned for: - Vault to vault orders: Buyer and Seller View - Ship to vault orders: Mock addresses are returned for the Buyer View (only); the address returned for the Seller View will be the authenticator&apos;s address. - Vault in-hand submission orders: the address returned for the Buyer View will be the authenticator's address (GetItemTransactions only). The following address details are returned for mock addresses: <pre> <ShippingAddress> <code>  <Name>eBay Vault</Name></code> <code>  <AddressID>Invalid Request</AddressID></code> <code>  <AddressOwner>eBay</AddressOwner></code> <code>  <AddressUsage>Invalid</AddressUsage></code> <code>  <CityName>Invalid Request</CityName></code> <code>  <Country>US</Country></code> <code>  <CountryName>Invalid Request</CountryName></code> <code>  <ExternalAddressID>Invalid Request</ExternalAddressID></code> <code>  <Phone>Invalid Request</Phone></code> <code>  <PostalCode>Invalid Request</PostalCode></code> <code>  <StateOrProvince>Invalid Request</StateOrProvince></code> <code>  <Street1>Invalid Request</Street1></code> <code>  <Street2></Street2></code> </ShippingAddress> </pre> GetAllBidders Always GetBidderList Conditionally GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerList Conditionally HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This container consists of taxpayer identification for the buyer. Although this container may be used for other purposes at a later date, it is currently used by sellers selling on the Italy or Spain site to retrieve the taxpayer ID of the buyer. It is now required that buyers registered on the Italy site provide their Codice Fiscale ID (similar to the Social Security Number for US citizens) before buying an item on the Italy site. On the Spain site, a Spanish seller has the option to require that Spanish buyers (registered on Spain site) provide a tax ID before checkout. This option is set by the seller at the account level. Once a Spanish buyer provides a tax ID, this tax ID is associated with his/her account, and once a tax ID is associated with the account, Spanish buyer will be asked to provide the tax ID during checkout on all eBay sites. Buyers with a registered address outside of Spain will not be asked to provide a tax ID during checkout. This container is only returned for Spanish or Italian sellers when the buyer was asked to provide tax identifier information during checkout. A BuyerTaxIdentifier will be returned for each tax ID that is associated with the buyer's account. GetOrders

DetailLevel:none,ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel:none,ReturnAll

Conditionally Type defining the BuyingSummary container returned in GetMyeBayBuying. The BuyingSummary container consists of data that summarizes the buyer's recent buying activity, including the number of items the user has bid on, the number of items the user is winning, and the number of items the user has won. The BuyingSummary container is only returned if the BuyingSummary.Include field is included in the GetMyeBayBuying request and set to <code>true</code>. The number of auction items the user has bid on. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The number of active auction listings in which the user is currently the highest bidder. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The total cost of items that the user is currently the highest bidder on. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The number of auction items that the user has won. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The total cost of auction items that the user has won. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The time period for which won items are displayed. Default is 31 days. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The number of items the user has made Best Offers on. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally Type defining the CalculatedHandlingDiscount container that is used in the SetShippingDiscountProfiles call to specify the rules used to determine package handling costs for an order in which calculated shipping is used. The type of discount that is detailed in the profile. If the selection is <code>EachAdditionalAmount</code>, <code>EachAdditionalAmountOff</code> or <code>EachAdditionalPercentOff</code>, the value is set in the child element of same name in CalculatedHandlingDiscount. If the selection is <code>CombinedHandlingFee</code>, specify the amount in CalculatedHandlingDiscount.OrderHandlingAmount. If the selection is <code>IndividualHandlingFee</code>, the amount is determined by eBay by adding the fees of the individual items. GetShippingDiscountProfiles Conditionally SetShippingDiscountProfiles Conditionally If specified, this is the fixed shipping cost to charge for an order, regardless of the number of items in the order. This field is mutually exclusive with the other amount and percentage fields within this type. This field only applies when the specified DiscountName value is <code>CombinedHandlingFee</code>. GetShippingDiscountProfiles Conditionally SetShippingDiscountProfiles Conditionally The packaging/handling cost for each item beyond the first item (where the item with the highest packaging/handling cost is selected by eBay as the first item). Let's say the buyer purchases three items, each assigned a packaging/handling cost of $8, and the seller set EachAdditionalAmount to $6. The packaging/handling cost for three items would normally be $24, but since the seller specified $6, the total packaging/handling cost would be $8 + $6 + $6, or $20. This field is mutually exclusive with the other amount and percentage fields within this type. This field only applies when the DiscountName value is <code>EachAdditionalAmount</code>. GetShippingDiscountProfiles Conditionally SetShippingDiscountProfiles Conditionally The amount by which to reduce the packaging/handling cost for each item beyond the first item (where the item with the highest packaging/handling cost is selected by eBay as the first item). Let's say the buyer purchases three items, each assigned a packaging/handling cost of $8, and the seller set EachAdditionalAmountOff to $2. The packaging/handling cost for three items would normally be $24, but since the seller specified $2, the total packaging/handling cost would be $24 - (two additional items x $2), or $20. This field is mutually exclusive with the other amount and percentage fields within this type. This field only applies when the DiscountName value is <code>EachAdditionalOffAmount</code>. GetShippingDiscountProfiles Conditionally SetShippingDiscountProfiles Conditionally The percentage by which to reduce the packaging/handling cost for each item beyond the first item (where the item with the highest packaging/handling cost is selected by eBay as the first item). Let's say the buyer purchases three items, each assigned a packaging/handling cost of $8, and the seller set EachAdditionalPercentOff to 0.25. The packaging/handling cost for three items would normally be $24, but since the seller specified 0.25 ($2 out of 8), the total packaging/handling cost would be $24 - (two additional items x $2), or $20. This field is mutually exclusive with the amount fields within this type. This field only applies when the DiscountName value is <code>EachAdditionalPercentOff</code>. GetShippingDiscountProfiles Conditionally SetShippingDiscountProfiles Conditionally Type used by the CalculatedShippingDiscount container, which is used in the SetShippingDiscountProfiles call to create one or more discounted calculated shipping rules. The CalculatedShippingDiscount container is returned in the response of all other calls that use this type. This enumeration value indicates the type of calculated shipping discount rule that is being applied. Each rule is explained below. GetShippingDiscountProfiles IndividualItemWeight, CombinedItemWeight, WeightOff Conditionally SetShippingDiscountProfiles IndividualItemWeight, CombinedItemWeight, WeightOff Conditionally GetItem IndividualItemWeight, CombinedItemWeight, WeightOff

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Shipping discount profiles https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-discount-profiles.html This container provides details of this particular calculated shipping discount profile. For SetShippingDiscountProfiles: If the ModifyActionCode value is set to <code>Update</code>, all details of the modified version of the profile must be provided. If the ModifyActionCode value is set to <code>Delete</code>, the DiscountProfileID is required, the MappingDiscountProfileID is optional, and all other fields of the container are no longer applicable. Restrictions on how many profiles can exist for a given discount rule are discussed in the Features Guide documentation on Shipping Cost Discount Profiles. GetShippingDiscountProfiles Conditionally SetShippingDiscountProfiles IndividualItemWeight, CombinedItemWeight, WeightOff Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Shipping discount profiles https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-discount-profiles.html This type is used to specify domestic and international package handling costs if calculated shipping is being used. Fees a seller might assess for the shipping of the item (in addition to whatever the shipping service might charge). Any packaging/handling cost specified on input is added to each shipping service on output. If domestic and international calculated shipping is offered for an item and if packaging/handling cost is specified only for domestic shipping, that cost will be applied by eBay as the international packaging/handling cost. (To specify a international packaging/handling cost, you must always specify a domestic packaging/handling cost, even if it is 0.) When UPS is one of the shipping services offered by the seller, package dimensions are required on list/relist/revise. Note: If the listing only has one domestic shipping service and it is free shipping, the domestic package handling cost will be ignored and will not be applied to the listing. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This field shows any package handling cost applied to international shipping. This cost will be in addition to any shipping cost applicable to each international shipping service option. For international calculated shipping only. AddFixedPriceItem AddItem AddItems RelistItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList GetItemShipping GetSellerList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Enumerated type that defines all possible reasons why an eBay order can be cancelled. BuyerCancelOrAddressIssue, BuyerNoShow, BuyerNotSchedule, BuyerRefused, ValetDeliveryIssues, ValetUnavailable This value indicates that the eBay order was cancelled by the seller due to the fact that one or more order line items were out-of-stock. This reason given by the seller will result in a seller defect. This value indicates that the eBay Scheduled Delivery order was cancelled due to the fact that the buyer was not at the expected delivery location to receive the order. This value is only applicable to eBay Scheduled Delivery orders, a service that is currently only available in the London area (UK). This value indicates that the eBay Scheduled Delivery order was cancelled due to the fact that the buyer refused to accept the order. This value is only applicable to eBay Scheduled Delivery orders, a service that is currently only available in the London area (UK). This value indicates that the eBay Scheduled Delivery order was cancelled due to the fact that the buyer did not successfully schedule the delivery of the order. This value is only applicable to eBay Scheduled Delivery orders, a service that is currently only available in the London area (UK). This value indicates that the seller initiated the cancellation of the order but at the request of the buyer. This is a cancel reason that the seller gives to avoid a seller defect for the cancellation. This value indicates that the eBay Scheduled Delivery order was cancelled due to the fact that the delivery person had an issue delivering the order to the buyer. This value is only applicable to eBay Scheduled Delivery orders, a service that is currently only available in the London area (UK). This value indicates that the eBay Scheduled Delivery order was cancelled due to the fact that no delivery person was available to deliver the order to the buyer. This value is only applicable to eBay Scheduled Delivery orders, a service that is currently only available in the London area (UK). This value indicates that the cancellation of the eBay order was initiated by the buyer because the order was placed by mistake. This value indicates that the cancellation of the eBay order was initiated by the buyer because the buyer decided that the price for the item was too high. This value indicates that the cancellation of the eBay order was initiated by the buyer because the buyer found the same item somewhere else at a cheaper price. This value indicates that the cancellation of the eBay order was initiated by the buyer because the buyer realized that the order will not arrive soon enough. THIS ENUMERATION VALUE IS DEPRECATED. This value indicates that the seller initiated the cancellation of the order but at the request of the buyer, or if the buyer supplied a bad/incorrect address at purchase time. This is a cancel reason that the seller can give to avoid a seller defect for the cancellation. Replacement values are AddressIssues and BuyerCancelOrder. This value indicates that the eBay order was cancelled by the seller due to the fact that one or more order line items were out-of-stock, or due to another reason why the seller was unable to fulfill the order. This reason given by the seller will result in a seller defect. This enumeration value indicates that the seller initiated the order cancellation request because there are issues with the destination address supplied by the buyer. This cancellation reason can only be given by the seller and not the buyer. This value is reserved for internal or future use. Enumerated type that defines the possible states of an eBay order cancellation. This value indicates that the order cancellation request is invalid. This value indicates that the order cancellation request is not applicable. This value indicates that the buyer has initiated the cancellation of the eBay order. It will be up to the seller to decide to approve or reject the cancellation request. This value indicates that the cancellation of the eBay order has been initiated by the buyer and approved by the seller, but the cancellation request has yet to be completed. This value indicates that the cancellation of the eBay order initiated by the buyer has been rejected by the seller. This value indicates that the order cancellation request has been closed, with no refund issued to the buyer. This value indicates that the order cancellation request has been closed, with a refund issued to the buyer. This value indicates that the order cancellation request has been closed, and it is unknown whether or not a refund was issued to the buyer. This value indicates that since the buyer committed to buying the item but did not pay for it, the cancellation succeeded and no refund is needed. This value indicates that the cancellation of the eBay order has been completed. This value indicates that the cancellation of the eBay order has failed. This value is reserved for internal or future use. This type is deprecated. Use DetailLevelCodeType instead. Return all available data. Return the category feature definitions only. (out) Reserved for internal or future use. Type defining the Category container that is returned in the GetCategoryFeatures response. A Category node is returned for each category that is relevant/applicable to the input criteria in the GetCategoryFeatures request. The CategoryID value identifies the eBay category. The rest of the CategoryFeatureType fields that are returned will be dependent on which FeatureID value(s) are specified in the GetCategoryFeatures request. Specifies the unique identifier of the eBay category. All eBay feature information that is returned under the corresponding Category container is relevant to this eBay category. 10 GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally A ListingDuration field is returned for each listing type and listing duration combination that is supported for the category. The integer value indicates the number of days of the listing duration, and the type attribute identifies the supported listing type. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ListingDurations</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category requires sellers to specify shipping details at listing time. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ShippingTermsRequired</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports the Best Offer feature for listings. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>BestOfferEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether a bidder must consent to the bid by confirming that he or she read and agrees to the terms in eBay's privacy policy. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>UserConsentRequired</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether or not it is possible to enhance a listing by putting it into a rotation for display on a special area of the eBay home page. Support for this feature varies by site. Item or feedback restrictions may apply. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>HomePageFeaturedEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is deprecated. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports Classified Ad listings. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>AdFormatEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports sellers offering a counter offer against a buyer's Best Offer, or a buyer offering a counter offer against the seller's counter offer. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>BestOfferCounterEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports the Best Offer Auto Decline feature. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>BestOfferAutoDeclineEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports the Speciality level subscription to Motors Local Market listings. This feature is only available to licensed vehicle dealers. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>LocalMarketSpecialitySubscription</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports the Regular level subscription to Motors Local Market listings. This feature is only available to licensed vehicle dealers. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>LocalMarketRegularSubscription</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports the Premium level subscription Motors Local Market listings. This feature is only available to licensed vehicle dealers. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>LocalMarketPremiumSubscription</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports a seller creating a Motors Local Market listing without a subscription. This feature is only available to licensed vehicle dealers. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>LocalMarketNonSubscription</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates the Minimum Reserve Price for an auction listing in this category. If there is no Minimum Reserve Price, a value of <code>0.0</code> is returned in this field. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>MinimumReservePrice</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether this category supports seller-level contact information for Classified Ad listings. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>SellerContactDetailsEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the Transaction Confirmation Request feature is supported for this category. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the payment method should be displayed to the user for Classified Ad format listings. Even if enabled, checkout may or may not be enabled. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ClassifiedAdPaymentMethodEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates if shipping options are available for Classified Ad listings in the category. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ClassifiedAdShippingMethodEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates if Best offer is enabled for Classified Ad listings for this category. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ClassifiedAdBestOfferEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether counter offers are allowed in Classified Ad listings for this category. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ClassifiedAdCounterOfferEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether automatic decline for best offers for Classified Ad listings is enabled for this category. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ClassifiedAdAutoDeclineEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports the telephone as a contact method for Classified Ad listings. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ClassifiedAdContactByPhoneEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports email as a contact method for Classified Ad listings. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ClassifiedAdContactByEmailEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is no longer applicable, as eBay now controls all online payment methods. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates if pay-per-lead listings are allowed for this category. Pay-per-lead listings can be applicable if the value of ListingType is <code>LeadGeneration</code> and the value of ListingSubtype is <code>ClassifiedAd</code>. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports the use of Item Specifics in listings. If enabled, sellers can use the Item.ItemSpecifics node in Add/Revise/Relist calls to specify Item Specific name-value pairs. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ItemSpecificsEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Note: This field is deprecated since it is only applicable to the eBay India site, and this marketplace is no longer available. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports the capability to identify a product using the brand/manufacturer part number combination. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>BrandMPNIdentifierEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports the Best Offer Automatic Accept feature for Classified Ad listings. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ClassifiedAdAutoAcceptEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports the Best Offer Automatic Accept feature for listings. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>BestOfferAutoAcceptEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports specifying that listings be displayed in the default search results of North America sites (US and Canada (English). Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>CrossBorderTradeEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports specifying that listings be displayed in the default search results of the UK and Ireland sites. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>CrossBorderTradeEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports specifying that listings be displayed in the default search results of the Australia site. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>CrossBorderTradeEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally If this field is returned as <code>true</code>, the category supports the Best Price Guarantee feature on the Australia site. This field/feature is only applicable to Australia. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned if the Featured Gallery feature is supported for the category. The time unit that is returned in this field indicates how long a gallery will be featured on eBay. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>GalleryFeaturedDurations</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies whether this category allows Classified Ad listings on eBay Motors. This element is applicable for eBay Motors Pro users. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>eBayMotorsProAdFormatEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether this category supports including the telephone in the seller's contact information. This element is for eBay Motors Pro users. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>eBayMotorsProContactByPhoneEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates which telephone option is enabled for the seller's contact information. This element is for eBay Motors Pro users. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>eBayMotorsProContactByPhoneEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether this category supports including the address in the seller's contact information. This element is for eBay Motors Pro users. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>eBayMotorsProContactByAddressEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates which address option is enabled for the seller's contact information. This element is for eBay Motors Pro users. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>eBayMotorsProContactByAddressEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether this category supports including the company name in the seller's contact information. This element is for eBay Motors Pro users. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>eBayMotorsProCompanyNameEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether this category supports including an email address in the seller's contact information. This element is for eBay Motors Pro users. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>eBayMotorsProContactByEmailEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates if Best Offer is supported for eBay Motors Classified Ad listings in this category. This element is for eBay Motors Pro users. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>eBayMotorsProBestOfferEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies whether this category allows auto-accept for Best Offers for eBay Motors Classified Ad listings. This element is for eBay Motors Pro users. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>eBayMotorsProAutoAcceptEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies whether this category allows auto-decline for Best Offers for eBay Motors Classified Ad listings. This element is for eBay Motors Pro users. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>eBayMotorsProAutoDeclineEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates if the payment method should be displayed to the user for this category in an eBay Motors Classified Ad listing. Even if enabled, checkout may or may not be enabled. This element is for eBay Motors Pro users. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>eBayMotorsProPaymentMethodCheckOutEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates if shipping options should be displayed to the user for this category in an eBay Motors Classified Ad listing. This element is for eBay Motors Pro users. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>eBayMotorsProShippingMethodEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether counter offers are allowed on Best Offers for this category in an eBay Motors Classified Ad listing. This element is for eBay Motors Pro users. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>eBayMotorsProCounterOfferEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies whether this category allows seller-level contact information for eBay Motors Classified Ad listings. A value of true means seller-level contact information is available for Classified Ad listings. This element is for eBay Motors Pro users. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>eBayMotorsProSellerContactDetailsEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies whether this category supports Motor Local Market Classified Ad listings. This element is for Local Market dealers. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>LocalMarketAdFormatEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether this category supports including the telephone in the seller's contact information. This element is for Local Market dealers. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>LocalMarketContactByPhoneEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates which telephone option is enabled for the seller's contact information. This element is for Local Market dealers. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>LocalMarketContactByPhoneEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether this category supports including the address in the seller's contact information. This element is for Local Market dealers. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>LocalMarketContactByAddressEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates which address option is enabled for the seller's contact information. This element is for Local Market dealers. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>LocalMarketContactByAddressEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports including a company name in the seller's contact information. This element is for Local Market dealers. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>LocalMarketCompanyNameEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports including an email address in the seller's contact information. This element is for Local Market dealers. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>LocalMarketContactByEmailEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates if Best Offer is enabled/required for Motors Local Market Classified Ad listings in this category. This element is for Local Market dealers. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>LocalMarketBestOfferEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies whether this category supports auto-accept for Best Offers for Motors Local Market Classified Ads. This element is for Local Market dealers. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>LocalMarketAutoAcceptEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies whether this category supports auto-decline for Best Offers for Motors Local Market Classified Ads. This element is for Local Market dealers. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>LocalMarketAutoDeclineEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates if the payment method should be displayed to the user for this category in an Motors Local Market Classified Ad listing. Even if enabled, checkout may or may not be enabled. This element is for Local Market dealers. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>LocalMarketPaymentMethodCheckOutEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates if shipping methods should be displayed to the user for this category in an Motors Local Market Classified Ad listing. Even if enabled, checkout may or may not be enabled. This element is for Local market dealers. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>LocalMarketShippingMethodEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether counter offers are allowed on Best Offers for this category for Motors Local Market Classified Ad listings. This element is for Local market dealers. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>LocalMarketCounterOfferEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the whether this category allows seller-level contact information for Motors Local Market Classified Ad listings. This element is for Local Market dealers. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>LocalMarketSellerContactDetailsEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates which telephone option is included in the seller's contact information. This element is for For Sale By Owner listings. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ClassifiedAdContactByPhoneEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether this category supports including an address in the seller's contact information. This element is for For Sale By Owner listings. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ClassifiedAdContactByAddressEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates which address option is included in the seller's contact information. This element is for For Sale By Owner listings. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ClassifiedAdContactByAddressEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether this category supports including a company name in the seller's contact information. This element is for For Sale By Owner listings. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ClassifiedAdCompanyNameEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally The value in this field indicates whether the category supports Motors Local Market listings if the seller has a Specialty vehicle subscription. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>SpecialitySubscription</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally The value in this field indicates whether the category supports Motors Local Market listings if the seller has a Regular vehicle subscription. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>RegularSubscription</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally The value in this field indicates whether the category supports Motors Local Market listings if the seller has a Premium vehicle subscription. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>PremiumSubscription</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally The value in this field indicates whether the category supports Motors Local Market listings if the seller does not have a vehicle subscription. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>NonSubscription</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Note: This field is deprecated since it is only applicable to the eBay India site, and this marketplace is no longer available. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates if the category allows the seller to revise the quantity of a multi-quantity, active listing. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ReviseQuantityAllowed</code>. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Indicates if the category allows the seller to revise the price of a fixed-price listing. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>RevisePriceAllowed</code>. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Indicates if an eBay Store owner gets extended listing durations in a given category. When the value of this element is true, it means the listing duration values defined in StoreOwnerExtendedListingDurations are applicable to fixed-price listings in a given category. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>StoreOwnerExtendedListingDurationsEnabled</code>. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Provides additional listings durations that are available to eBay Store owners. The extended listing durations provided here in this element should be merged in with the baseline listing durations provided in the ListingDurations element. Applies to fixed-price Listings. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>StoreOwnerExtendedListingDurations</code>. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally For most sites: If true, listings in this category require a return policy. For eBay Australia (AU) and US eBay Motors Parts and Accessories: If true, the category supports but does not require a return policy. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ReturnPolicyEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates if a seller's stated handling time is enabled for a category. A handling time is generally needed for items that are shipped to the buyer, but not necessarily applicable to freight shipping or local pickup. The handling time is the maximum number of business days the seller commits to for preparing an item to be shipped after receiving a cleared payment. The seller's handling time does not include the shipping time (the carrier's transit time). For a list of the handling time values allowed for each site, use <code>DispatchTimeMaxDetails</code> in GeteBayDetails. Note: Although the field name ends with "Enabled", a value of true means that a handling time is NOT supported, and value of false means that a handling time IS supported. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>HandlingTimeEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally The maximum cost the seller can charge for the first domestic flat-rate shipping service. Mutually exclusive with the Group<code>N</code>MaxFlatShippingCost elements. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>MaxFlatShippingCost</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-flat-rate.html#max-flat Flat rate shipping Returns the applicable max cap per shipping cost for shipping service group1. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>Group1MaxFlatShippingCost</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Returns the applicable max cap per shipping cost for shipping service group2. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>Group2MaxFlatShippingCost</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Returns the applicable max cap per shipping cost for shipping service group3. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>Group3MaxFlatShippingCost</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates the acceptable payment methods that can be used when listing an item for sale in the corresponding category. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>PaymentMethods</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally If <code>true</code>, you can pass in Item.Variations in an Add/Revise/Relist fixed-price item call when you list in this category. Multi-variation listings contain items that are logically the same product, but that vary in their manufacturing details or packaging. For example, a particular brand and style of shirt could be available in different sizes and colors, such as "large blue" and "medium black" variations. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>VariationsEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports free, automatic upgrades for Gallery Plus, which enhances pictures in search results. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>FreeGalleryPlusEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports free, automatic upgrades for Picture Pack, a discount package that includes super-sizing of pictures. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>FreePicturePackEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports parts compatibility by application (ByApplication), by specification (BySpecification), or not at all (Disabled). Categories cannot support both types of parts compatibility. Parts Compatibility is supported in limited Parts & Accessories categories for the eBay Motors (US) site (site ID 100) only. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>CompatibilityEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field specifies the minimum number of required compatible applications for listing items. A value of "0" indicates it is not mandatory to specify parts compatibilities when listing. This applies to categories that are enabled for compatibility by application only. Parts compatiblity by application can be specified by listing with a catalog product that supports parts compatibility or by specifying parts compatibility by application manually ( Item.ItemCompatibilityList). Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>MinCompatibleApplications</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field specifies the maximum number of compatible applications allowed per item when adding or revising items. This is relevant for specifying parts compatibility by application manually ( Item.ItemCompatibilityList) only. Applicable for the US site only. For DE, UK, and AU sites, this field returns the same value as MaxGranularFitmentCount. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>MaxCompatibleApplications</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category supports, requires, or doesn't support the use item condition for an item listing. For categories that require or support the use of item condition, see the ConditionValues and/or SpecialFeatures containers for a list of valid item conditions (display names and ID values). Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ConditionEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This container specifies all of the item conditions that are supported for the corresponding category. The display name of the item condiation and the ID associated with the description are both shown. This container will not be returned for any eBay categories that don't support the use of an item condition value. To see which categories require, support, or don't support the use of item conditions, you can include a FeatureID value of <code>ConditionEnabled</code>. Any eBay category that does not support the use of an item condition value will return a ConditionEnabled value of <code>Disabled</code>. This container will also not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ConditionValues</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This container is only returned if the corresponding category supports a special item condition such as Certified - Refurbished condition (condition ID 2000), Excellent - Refurbished condition (condition ID 2010), Very Good - Refurbished condition (condition ID 2020), and Good - Refurbished condition (condition ID 2030). A seller must be pre-qualified by eBay to list items with the any of these refurbished item conditions. All other item conditions supported by a category will be returned in the ConditionValues container instead. Neither the ConditionValues or the SpecialFeatures containers will be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ConditionValues</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Some eBay sites may select a few categories and designate them as "value categories". These are typically selected from categories where buyers can find great deals. (Not all categories with great deals are designated as value categories.) This designation can change over time. While a category is designated as a value category (i.e., when ValueCategory is <code>true</code>), it is subject to the following rule: Items in value categories can only be listed in one category. For example, if you attempt to list in two categories and the primary category or secondary category is a value category, then eBay drops the secondary category and lists the item in the primary category only. Similarly, if you attempt to add a secondary category to an existing listing, or you change the category for an existing listing, and if the primary or secondary category is a value category, then eBay drops the secondary category. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ValueCategory</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This value is deprecated. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether or not European Article Numbers (EANs) are supported/required when listing products in the category. A value of <code>Disabled</code> indicates that EANs cannot be used for the category, a value of <code>Enabled</code> indicates that EANs can be used for the category, and a value of <code>Required</code> indicates that an EAN is required when listing a product in this category. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>EANEnabled</code>. Note: It is recommended that sellers always use GetCategoryFeatures to see if an eBay category requires a Global Trade Item Number (GTIN) or a Brand/MPN combination. So, that means that they should look for EANEnabled, ISBNEnabled, UPCEnabled, and BrandMPNIdentifierEnabled at the category level in the GetCategoryFeatures response. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether or not International Standard Book Numbers (ISBNs) are supported/required when listing products in the category. A value of <code>Disabled</code> indicates that ISBNs cannot be used for the category, a value of <code>Enabled</code> indicates that ISBNs can be used for the category, and a value of <code>Required</code> indicates that an ISBN is required when listing a product in this category. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ISBNEnabled</code>. Note: It is recommended that sellers always use GetCategoryFeatures to see if an eBay category requires a Global Trade Item Number (GTIN) or a Brand/MPN combination. So, that means that they should look for ISBNEnabled, EANEnabled, UPCEnabled, and BrandMPNIdentifierEnabled at the category level in the GetCategoryFeatures response. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether or not Universal Product Codes (UPCs) are supported/required when listing products in the category. A value of <code>Disabled</code> indicates that UPCs cannot be used for the category, a value of <code>Enabled</code> indicates that UPCs can be used for the category, and a value of <code>Required</code> indicates that a UPC is required when listing a product in this category. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>UPCEnabled</code>. Note: It is recommended that sellers always use GetCategoryFeatures to see if an eBay category requires a Global Trade Item Number (GTIN) or a Brand/MPN combination. So, that means that they should look for UPCEnabled, ISBNEnabled, EANEnabled, and BrandMPNIdentifierEnabled at the category level in the GetCategoryFeatures response. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates the maximum number of compatible applications allowed per item when adding or revising items with compatibilities provided at the most detailed granularity. For example, in Car and Truck Parts on the US site, the most granular application would include Year, Make, Model, Trim, and Engine. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>MaxGranularFitmentCount</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is for future use. It is currently returned as an empty field, but in the future, the string value in this field will indicate Parts Compatibility vehicle type (e.g. cars, motorcycles, boats). Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>CompatibleVehicleType</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates the Business Policies category group that may be used for Shipping profiles. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ShippingProfileCategoryGroup</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates the Business Policies category group that may be used for Payment profiles. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>PaymentProfileCategoryGroup</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates the Business Policies category group that may be used for Return Policy profiles. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>ReturnPolicyProfileCategoryGroup</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is deprecated. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is deprecated. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as <code>true</code> if the corresponding category supports the use of a seller-provided title for a motor vehicle listing on the US or Canada Motors marketplaces. A seller-provided title is a descriptive title, given by the seller, that appears below eBay's pre-filled listing title for the motor vehicle. Visually, the seller-provided title is similar to a subtitle on other types of eBay listings (non-vehicle). A seller-provided title can assist in helping buyers discover the vehicle. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as <code>true</code> if the corresponding category supports the use of a deposit/down payment on a motor vehicle listing. In an AddItem call, the seller can configure a down payment for a motor vehicle listing using the PaymentDetails container. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates if the Global Shipping Program (GSP) is supported for the category. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>GlobalShippingEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field indicates whether or not the category (specified in the Category.CategoryID field) supports Boats and Motorcycles Parts compatibility. If <code>true</code>, parts compatibility name-value pairs for boats and motorcycles can be added to an item listed in the specified category. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>AdditionalCompatibilityEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally A <code>true</code> value in this field indicates that items listed in the category (specified in the Category.CategoryID field) may be enabled with the 'Click and Collect' feature. With the 'Click and Collect' feature, a buyer can purchase certain items on an eBay site and collect them at a local store. Buyers are notified by eBay once their items are available. A <code>false</code> value in this field indicates that items listed in the category are not eligible for the 'Click and Collect' feature. The 'Click and Collect' feature is only available to large merchants on the eBay UK (site ID - 3), eBay Australia (Site ID - 15), and eBay Germany (Site ID - 77) sites. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>PickupDropOffEnabled</code>. Note: For Click and Collect eligible sellers, the Click and Collect feature can only be enabled at the account level, and then each of the seller's listings within an Click and Collect enabled category will be automatically evaluated for Click and Collect eligibility. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally A <code>true</code> value in this field indicates that digital gift cards (eBay gift cards or third-party gift cards) can be listed in the category specified in the Category.CategoryID field. A <code>false</code> value in this field indicates that digital gift cards can not be listed in the specified category. Digital gift cards are currently only supported on the US site. There are some restrictions when it comes to selling gift cards, including the following: <ul> <li>Each seller can only have one gift card listing at any given time </li> <li>The maximum dollar value of the gift card may not exceed 500.00</li> <li>Prepaid credit cards from American Express, Discover, MasterCard, or Visa are not allowed</li> </ul> For more information on eBay's Gift Card policy, see the <a href=" http://pages.ebay.com/help/policies/gift.html" target="_blank">Gift cards policy Help page</a>. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>DigitalGoodDeliveryEnabled</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as <code>true</code> if the category supports the use of an eBay Product ID (e.g. ePID) in an Add/Revise/Relist API call to identify which motorcycles and/or scooters are compatible with a motor vehicle part or accessory. ePIDs can only be used to identify motorcycles and scooters on the Germany and UK sites. For more information on using an ePID to identify a compatible motorcycle or scooter through an Add/Revise/Relist API call on the Germany or UK site, see the documentation for the <a href=" https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/AddItem.html#Request.Item.ItemCompatibilityList.Compatibility.NameValueList">Compatibility.NameValueList</a> container. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>EpidSupported</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as <code>true</code> if the category supports the use of a K Type vehicle number in an Add/Revise/Relist API call to identify which cars and/or trucks are compatible with a motor vehicle part or accessory. K type vehicle numbers can only be used to identify cars and trucks on the Germany site. For more information on using a K Type vehicle number to identify a compatible car or truck through an Add/Revise/Relist API call on the Germany site, see the documentation for the <a href=" https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/AddItem.html#Request.Item.ItemCompatibilityList.Compatibility.NameValueList">Compatibility.NameValueList</a> container. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent or the site default. Will not be returned if one or more <a href="types/FeatureIDCodeType.html">FeatureID</a> values are used in the call request, and one of those values does not include <code>KTypeSupported</code>. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally The values returned in this field indicate whether or not the seller accepts domestic returns for items listed in the associated marketplace and category. While most categories return the ReturnsAccepted flag (indicating the category supports returns), some categories will also return the ReturnsNotAccepted flag to indicate the seller can choose to not accept returns for an item listed in that category. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated category, which indicates that items listed in the category must include a return policy. Here, it's worth noting that not accepting returns is a return policy. The values returned in this field are valid in AddItem and its related family of calls, and in the return policies you configure for use with the Account API. Note: Sellers have the option of creating a separate international return policy for items that are shipped to international customers. If a seller does not add a separate international return policy, the settings in the domestic return policy will be used instead. For the international equivalent of this field, see the InternationalReturnsAcceptedValues field. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally The values returned in this field indicate whether or not the seller can offer international returns. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated category, which indicates that items listed in the category must include a return policy. The values returned in this field are valid in AddItem and its related family of calls, and in the return policies you configure for use with the Account API. Note: Sellers have the option of creating a separate international return policy for items that are shipped to international customers. If a seller does not add a separate international return policy, the settings in the domestic return policy will be used instead. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally The values returned in this field indicate the return duration options that are available for domestic returns for items listed in the associated marketplace and category. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated category, which indicates that items listed in the category must include a return policy. The values returned in this field are valid in AddItem and its related family of calls, and in the return policies you configure for use with the Account API. Note: Sellers have the option of creating a separate international return policy for items that are shipped to international customers. If a seller does not add a separate international return policy, the settings in the domestic return policy will be used instead. For the international equivalent of this field, see the InternationalReturnsDurationValues field. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally The values returned in this field indicate the return duration options that are available for international returns for items listed in the associated marketplace and category. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated category, which indicates that items listed in the category must include a return policy. The values returned in this field are valid in AddItem and its related family of calls, and in the return policies you configure for use with the Account API. Note: Sellers have the option of creating a separate international return policy for items that are shipped to international customers. If a seller does not add a separate international return policy, the settings in the domestic return policy will be used instead. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally On the EBAY_US marketplace only, sellers can offer item replacement in addition to offering money back returns. This flag defines the availability of such options for the given US marketplace category. Sellers can offer item replacements only if returns are enabled (returnPolicyEnabled is set to <code>true</code>) for the item. You can specify item replacement in the AddItem family of calls and in the return policy settings of the Account API. Note: Sellers have the option of creating a separate international return policy for items that are shipped to international customers. If a seller does not add a separate international return policy, the settings in the domestic return policy will be used instead. For the international equivalent of this field, see the InternationalRefundMethodValues field. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally In US, sellers can offer an item replacement for returns, in addition to offering money back returns. The values returned in this field indicate the availability of such options for the given marketplace and category. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated category, which indicates that items listed in the category must include a return policy. The values returned in this field are valid in AddItem and its related family of calls, and in the return policies you configure for use with the Account API. Note: Sellers have the option of creating a separate international return policy for items that are shipped to international customers. If a seller does not add a separate international return policy, the settings in the domestic return policy will be used instead. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally In some EU countries, sellers are legally required to describe the return policy they offer. The value returned by this field indicates if sellers can provide such a description within the given marketplace and category. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated category, which indicates that items listed in the category must include a return policy. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Type defining the CategoryGroup container, which defines the category group to which the corresponding Business Policies profile will be applied, and a flag that indicates whether or not that Business Policies profile is the default for that category group. Defines the name of the category group tied to a Business Policies profile. Valid values are <code>ALL</code> (referring to all non-motor vehicle category groups) or <code>MOTORS_VEHICLE</code> (referring to only motor vehicle category groups). The CategoryGroup container is only returned in GetUserPreferences if the ShowSellerProfilePreferences field is included in the request and set to <code>true</code>. GetUserPreferences Conditionally This boolean value indicates whether the corresponding Business Policies profile is the default for the category group. The CategoryGroup container is only returned in GetUserPreferences if the ShowSellerProfilePreferences field is included in the request and set to <code>true</code>. GetUserPreferences Conditionally Container for data on one listing category. Many of the CategoryType fields are returned <a href="../../../../../api-docs/commerce/taxonomy/resources/category_tree/methods/getCategoryTree" target="_blank">getCategoryTree</a> or <a href="../../../../../api-docs/commerce/taxonomy/resources/category_tree/methods/getCategorySubtree" target="_blank">getCategorySubtree</a> methods of the Taxonomy API. Add/Revise/Relist calls only use the CategoryID field to specify which eBay category in which to list the item. This string value is the unique identifier of an eBay category. In GetItem and related calls, see the CategoryName field for the text name of the category. The parent category of this eBay category can be retrieved through the <a href="../../../../../api-docs/commerce/taxonomy/resources/methods" target="_blank">Taxonomy API's</a> getCategoryTree or getCategorySubtree methods and inspecting the parentCategoryTreeNodeHref field in the response. Note: When listing in categoryID 173651 (Auto Performance Tuning Devices & Software), use of catalog products is required. For more information, see <a href="../../../../../api-docs/user-guides/static/trading-user-guide/tuning-devices-and-software.html" target="_blank">Tuning devices and software</a>. In an Add call, the PrimaryCategory.CategoryID is conditionally required unless the seller successfully uses the ProductListingDetails container to find an eBay catalog product match. When the seller successfully uses an eBay catalog product to create a listing, the listing title, listing description, item specifics, listing category, and stock photo defined in the catalog product is used to create the listing. In an Add/Revise/Relist call, the SecondaryCategory.CategoryID is conditionally required if a Secondary Category is used. Using a Secondary Category can incur a listing fee. For ReviseItem only: Previously, removing the listing from a secondary category was only possible within 12 hours of the listing's scheduled end time when an auction listing had no active bids or a multiple-quantity, fixed-price listing had no items sold, but this restriction no longer exists. Now, the secondary category can be dropped for any active listing at any time, regardless of whether an auction listing has bids or a fixed-price listing has sales. To drop a secondary category, the seller passes in a value of <code>0</code> in the SecondaryCategory.CategoryID field. 10 AddItem AddItems VerifyAddItem AddFixedPriceItem VerifyAddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem RelistItem ReviseItem VerifyRelistItem PrimaryCategory Conditionally AddItem AddItems VerifyAddItem AddFixedPriceItem VerifyAddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem RelistItem ReviseItem VerifyRelistItem SecondaryCategory Conditionally GetBidderList PrimaryCategory Always GetBidderList Conditionally FreeAddedCategory SecondaryCategory GetItem Always PrimaryCategory

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItem Conditionally FreeAddedCategory SecondaryCategory

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList Conditionally FreeAddedCategory SecondaryCategory

DetailLevel: ItemReturnDescription, ReturnAll

GetSellerList Conditionally PrimaryCategory SecondaryCategory

DetailLevel: ItemReturnDescription, ReturnAll

This string value is the display name of the eBay primary category, as it would appear on the eBay site. In GetItem, this will be a fully-qualified category name (e.g., Collectibles:Decorative Collectibles:Hummel, Goebel). GetBidderList Always PrimaryCategory GetBidderList Conditionally FreeAddedCategory SecondaryCategory GetItem Always PrimaryCategory

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItem Conditionally FreeAddedCategory SecondaryCategory

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally This field is deprecated. This field is deprecated. Type defining the CharityAffiliationDetail container that is returned in the GetUser response. The CharityAffiliationDetail container consists of information on a nonprofit charity organization associated with the seller's account. A separate CharityAffiliationDetail container is returned for each nonprofit charity organization associated with the seller's account. The eBay unique identifier of the nonprofit organization associated with the seller's account. Once a nonprofit organization comes aboard as an eBay for Charity organization, eBay creates and assigns this ID to the nonprofit organization. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally The enumeration value returned here indicates whether the eBay user is just selling on the behalf of the nonprofit organization, or if the eBay user is directly affiliated with/representing the nonprofit organization, or the eBay user has been added as a Direct Seller by the nonprofit organization. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This timestamp indicates when the eBay user last contributed to the nonprofit organization through the donated proceeds of an eBay sale. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This type is used to hold an array of one or more eBay for Charity organizations that are affiliated with the seller's account. A CharityAffiliationDetail container will be returned for each eBay for Charity organization that is associated with the seller's account. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This enumeration type defines the possible values that can be returned for the CharityAffiliationDetail.AffiliationType field in the GetUser response. This enumeration value indicates that the eBay user is just selling on the behalf of the nonprofit organization, and is not directly affiliated with the organization. This enumeration value indicates that the eBay user is directly affiliated with or represents the nonprofit organization, or the eBay user has been added as a Direct Seller by the same nonprofit organization. This enumeration value may be returned if the nonprofit organization has recently unregistered as an eBay for Charity organization, or it may be returned if the eBay user has recently removed the charity feature from a listing. Reserved for internal or future use. Enumerated type defining the possible states for a seller's charity seller account. RegisteredNoCreditCard, DirectDebitRejected The seller's charity seller account is suspended. The seller is a registered charity seller. The seller is no longer a registered charity seller. The account with the PayPal Giving Fund is closed. The credit card associated with a seller's charity seller account has expired. The token associated with a seller's charity seller account has expired. The credit card associated with a seller's charity seller account will expire in 15 (or fewer) days. The seller is no longer a registered charity seller and has lost direct seller status. The seller is a registered direct seller, but has no credit card associated with the charity seller account. The seller is a registered charity seller with no donation payment method on file. Reserved for internal or future use. Enumerated type defining the possible states for a nonprofit charity organization registered with the PayPal Giving Fund. The specified nonprofit charity organization is a valid nonprofit charity organization according to the requirements of the PayPal Giving Fund. The specified nonprofit charity organization is no longer a valid nonprofit charity organization according to the requirements of the PayPal Giving Fund. (out) Reserved for internal or future use. This type is used to provide details about a nonprofit organization that will benefit from each sale generated from an eBay listing. The full name of the nonprofit organization. 150 GetBidderList Conditionally GetItem GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally The percentage of the purchase price that the seller chooses to donate to the selected nonprofit organization. This percentage is displayed in the eBay for Charity listing. Possible values: 10.0 to 100.0. <ul> <li>Percentages must increment by 5.0. </li> <li>Minimum donation percentages may be required for eBay for Charity listings, see <a href="http://pages.ebay.com/help/sell/selling-nonprofit.html"> Selling to benefit nonprofit organizations</a> for details. </li> </ul> The DonationPercent field is required in an Add/Revise/Relist call if the seller will be donating a percentage of the sale proceeds for each sale generated by the listing. AddItem AddItems RelistItem VerifyAddItem AddFixedPriceItem VerifyAddFixedPriceItem RelistFixedPriceItem RelistFixedPriceItem VerifyRelistItem ReviseItem ReviseFixedPriceItem Conditionally GetBidderList Conditionally GetItem GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally The unique identifier that eBay creates and assigns to each nonprofit organization. The field is conditionally required in an Add/Revise/Relist call if the seller will be donating a percentage of the sale proceeds to this organization for each sale generated by the listing. AddItem AddItems RelistItem VerifyAddItem AddFixedPriceItem VerifyAddFixedPriceItem RelistFixedPriceItem RelistFixedPriceItem VerifyRelistItem ReviseItem ReviseFixedPriceItem Conditionally GetBidderList Conditionally GetItem GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally The stated mission of the nonprofit charity organization. This mission statement is displayed in the eBay for Charity section of the View Item page. 511 GetBidderList Conditionally GetItem GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally The full URL to the nonprofit organization's logo image file. This logo image file is the image that is displayed in all eBay listings that benefit that charity. This field is returned as long as it is defined for the nonprofit organization. GetItem GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList Conditionally This enumeration value indicates whether or not the nonprofit organization is a valid eBay for Charity organization, and is able to receive proceeds from eBay sales. GetBidderList Conditionally GetItem GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally If this field is returned as <code>true</code>, a percentage of order line item's purchase price will be donated to a nonprofit organization. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Enumerated type that lists the possible checkout states of an order line item. This value indicates that the buyer has paid and checkout is complete. This value indicates that checkout is incomplete, generally because the buyer has not paid yet. This value indicates that the buyer wants to confirm the total price of the order line item before making a payment. This value indicates that the seller has just responded to the buyer concerning the total price of the order line item. Reserved for future use. Type defining the CheckoutStatus container that is returned in GetOrders to indicate the current checkout status of the order. Indicates the status of the buyer's payment for an order. If the payment was successfully processed, a value of <code>NoPaymentFailure</code> will be returned. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always This timestamp indicates when the order was last modified. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always The payment method that the buyer selected to pay for the order. Note: Effective September 26, 2025, access to buyer payment details for U.S. users will be limited to select developers. All other developers will receive a value of "CustomCode" in place of buyer payment details. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. Note: Sellers no longer have to specify any electronic payment methods at listing time, but this field is still returned. The value returned in this field will generally be <code>CreditCard</code>, unless an eBay gift card was used by the buyer to pay a partial or full balance of the order. If this is the case, the value returned in this field will be <code>CCAccepted</code>. Either of these two values will be returned, but neither accurately reflects the actual payment method that the buyer used. If the order was paid for off of eBay's platform using an 'offline' payment method such as 'CashOnPickup' or 'MOCC' (money order or cashier's check), and the seller marked the order as paid, either of those values may get returned here. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always Indicates the status of the order. This value is subject to change based on the status of the checkout flow. Generally speaking, the Status field reads <code>Incomplete</code> when payment has yet to be initiated, <code>Pending</code> when payment has been initiated but is in process, and <code>Complete</code> when the payment process has completed. Note: If the PaymentMethod is <code>CashOnPickup</code>, the Status value will read <code>Complete</code> right at checkout, even though the seller may not have been officially paid yet, and the eBayPaymentStatus field will read <code>NoPaymentFailure</code>. The Status value will remain as <code>Complete</code> even if the seller changes the checkout status to Pending. However, the eBayPaymentStatus value in GetOrders will change from <code>NoPaymentFailure</code> to <code>PaymentInProcess</code>. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always This field is no longer applicable as eBay sellers can no longer use iMCC gateway accounts to handle buyer payments. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always The enumeration value in this field indicates which payment method was used by the German buyer who was offered the 'Pay Upon Invoice' option. This field will only be returned if a German buyer was offered the 'Pay Upon Invoice' option. Otherwise, the buyer's selected payment method is returned in the PaymentMethod field. Note: Effective September 26, 2025, access to buyer payment details for U.S. users will be limited to select developers. All other developers will receive a value of "CustomCode" in place of buyer payment details. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Type defining the ClassifiedAdAutoAcceptEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as 'ClassifiedAdAutoAcceptEnabled' or 'ClassifiedAdAutoDeclineEnabled' is included as a FeatureID value in the call request or no FeatureID values are passed into the call request). This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the Classified Ad Auto Accept feature. To verify if a specific eBay site supports the Classified Ad Auto Accept feature (for most categories), look for a 'true' value in the SiteDefaults.ClassifiedAdAutoAcceptEnabled field. To verify if a specific category on a specific eBay site supports the Classified Ad Auto Accept feature, pass in a CategoryID value in the request, and then look for a 'true' value in the ClassifiedAdAutoAcceptEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Type defining the ClassifiedAdAutoDeclineEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as 'ClassifiedAdAutoDeclineEnabled' or 'ClassifiedAdAutoAcceptEnabled' is included as a FeatureID value in the call request or no FeatureID values are passed into the call request). This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the Classified Ad Auto Decline feature. To verify if a specific eBay site supports the Classified Ad Auto Decline feature (for most categories), look for a 'true' value in the SiteDefaults.ClassifiedAdAutoDeclineEnabled field. To verify if a specific category on a specific eBay site supports the Classified Ad Auto Decline feature, pass in a CategoryID value in the request, and then look for a 'true' value in the ClassifiedAdAutoDeclineEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Enumerated type that defines the values used to indicate whether Best Offers for the Classified Ad listing format are enabled/disabled for all/most of a site's categories (SiteDefaults.ClassifiedAdBestOfferEnabled), or enabled/required/disabled for a specific eBay category (Category.ClassifiedAdBestOfferEnabled). This value indicates that Classified Ad Best Offer feature is disabled for all/most of a site's categories (if returned in the SiteDefaults.ClassifiedAdBestOfferEnabled field), or disabled for a specific category (if returned in the Category.ClassifiedAdBestOfferEnabled field). This value indicates that Classified Ad Best Offer feature is enabled for all/most of a site's categories (if returned in the SiteDefaults.ClassifiedAdBestOfferEnabled field), or enabled for a specific category (if returned in the Category.ClassifiedAdBestOfferEnabled field). This value indicates that Classified Ad Best Offer feature is required for a specific category (if returned in the Category.ClassifiedAdBestOfferEnabled field). This value is not applicable at the site level (SiteDefaults container). (out) Reserved for internal or future use. Type defining the ClassifiedAdBestOfferEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as 'ClassifiedAdBestOfferEnabled' is included as a FeatureID value in the call request or no FeatureID values are passed into the call request). This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the Classified Ad Best Offer feature. To verify if a specific eBay site supports the Classified Ad Best Offer feature (for most categories), look for a 'true' value in the SiteDefaults.ClassifiedAdBestOfferEnabled field. To verify if a specific category on a specific eBay site supports the Classified Ad Best Offer feature, pass in a CategoryID value in the request, and then look for a 'true' value in the ClassifiedAdBestOfferEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Indicates whether the category supports the use of a company name when contacting the seller for Classified Ad format listings. Added for the For Sale By Owner format. Indicates whether the category supports the use of an address when contacting the seller for Classified Ad format listings. Added for the For Sale By Owner format. Indicates if Email can be a contact method for the category Indicates whether the telephone can be a contact method for the category. Type defining the ClassifiedAdCounterOfferEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as 'ClassifiedAdCounterOfferEnabled' is included as a FeatureID value in the call request or no FeatureID values are passed into the call request). This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the Classified Ad Best Offer Counter Offer feature. To verify if a specific eBay site supports the Classified Ad Best Offer Counter Offer feature (for most categories), look for a 'true' value in the SiteDefaults.ClassifiedAdCounterOfferEnabled field. To verify if a specific category on a specific eBay site supports the Classified Ad Best Offer Counter Offer feature, pass in a CategoryID value in the request, and then look for a 'true' value in the ClassifiedAdCounterOfferEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Defines the pay-per-lead feature. If the field is present, the corresponding feature applies to the category. The field is returned as an empty element (i.e., a boolean value is not returned). Used to indicate whether the payment method will be displayed for a category belonging to the Lead Generation Format. Display the payment method and permit checkout. Display the payment method and suppress checkout. Do not display the payment method. (out) Reserved for internal or future use. Indicates whether Contact Seller is enabled Classified Ads. Indicates which phone option the category supports for contacting the seller for Classified Ad format listings. Added for the For Sale By Owner format. Indicates whether shipping options are available for the category. Indicates which address option the category supports for Classified Ad format listings. Added for the For Sale By Owner format. INVOICE This enumerated type defines the collection methods that are used to collect either 'Collect and Remit' sales tax in the US, or 'Good and Services' tax in Australia and New Zealand. Note: Although the CollectionMethod field is returned for orders subject to 'Collect and Remit' sales tax or 'Good and Services' tax, the CollectionMethod field and CollectionMethodCodeType are currently not applicable. Note: This value is for future use. This value is always returned, but because the CollectionMethod field and CollectionMethodCodeType are not currently applicable, this value does not have any purpose at this time. Defines the Combined Fixed Price Treatment feature. If the field is present, the corresponding feature applies to the category. The field is returned as an empty element (i.e., a boolean value is not returned). Enumerated type that defines the seller's preference for allowing <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manage-fulfill-combine-invoices.html">Combined Invoice</a> orders that pass on a shipping discounts to the buyer. This value indicates that the seller does not allow Combined Invoice orders. In other words, the buyer must pay for each order line item separately, and cannot combine multiple single line item orders into one Combined Invoice order and make one payment for that order. This value indicates that the seller allows Combined Invoice orders, and that the seller has one or more shipping discount rules (Flat, Calculated, or Promotional) that can be applied at the listing level. This value indicates that the seller allows Combined Invoice orders, and that the seller will apply any shipping discounts after the creation of the Combined Invoice order. Reserved for internal or future use. This enumerated type contains the list of values that can be used by the seller to set the number of days after item purchase that an unpaid order can be combined with one or more other mutual (same buyer and same seller) unpaid orders into one <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manage-fulfill-combine-invoices.html">Combined Invoice</a> order. Either the buyer or the seller can initiate the Combined Invoice process. Sellers can offer buyers shipping discounts through Combined Invoice orders, and buyers only have to make one payment for multiple orders as opposed to a payment for each order. This value indicates that an unpaid order can be combined into a Combined Invoice order within three days after purchase (creation of order). This value indicates that an unpaid order can be combined into a Combined Invoice order within five days after purchase (creation of order). This value indicates that an unpaid order can be combined into a Combined Invoice order within seven days after purchase (creation of order). This value indicates that an unpaid order can be combined into a Combined Invoice order within 14 days after purchase (creation of order). This value indicates that an unpaid order can be combined into a Combined Invoice order within 30 days after purchase (creation of order). This value indicates that an order is not eligible to be combined into a Combined Payment order. This value is reserved for internal or future use. Type used to indicate if the seller supports <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manage-fulfill-combine-invoices.html">Combined Invoice</a> orders, and if so, defines whether the seller specifies any shipping discount before or after purchase. Specifies whether or not a seller wants to allow buyers to combine single order line items into a Combined Invoice order. A Combined Invoice order can be created by the buyer or seller if multiple unpaid order line items exist between the same buyer and seller. Often, a Combined Invoice order can reduce shipping and handling expenses for the buyer and seller. GetUserPreferences Conditionally SetUserPreferences No https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manage-fulfill-combine-invoices.html Combined Invoice This enumerated type list the Feedback ratings that can be left by one eBay user for another user regarding that user's experience with the another user during the purchase/checkout flow of an order line item. This value indicates that the submitting user's experience with the other user (receiving feedback) was rated as a "Positive" experience. If an eBay user receives a Positive rating for an order line item from a Verified User, their overall Feedback score increases by a value of 1. This value indicates that the submitting user's experience with the other user (receiving feedback) was rated as a "Neutral" experience. If an eBay user receives a Neutral rating for an order line item from a Verified User, their overall Feedback score remains the same. This value indicates that the submitting user's experience with the other user (receiving feedback) was rated as a "Negative" experience. If an eBay user receives a Negative rating for an order line item from a Verified User, their overall Feedback score decreases by a value of 1. This value indicates that a submitted Feedback entry was withdrawn. If a Feedback entry is withdrawn, the effect of that entry on the overall Feedback score is nullified. However, Feedback comments from the withdrawn entry are still visible. This value indicates that a submitted Feedback entry was withdrawn based on the decision of a third-party (such as eBay). If a Feedback entry is withdrawn, the effect of that entry on the overall Feedback score is nullified. This value is only applicable to the eBay Motors site only. This value is reserved for internal or future use. Defines the vehicle type to which parts compatibility applies. If the field is present, the corresponding feature applies to the site. The field is returned as an empty element (e.g., a boolean value is not returned). Enumerated type that contains values which indicate whether an order or order line item is complete, incomplete, or pending. This value indicates that the order or order line item is in the incomplete state. Generally speaking, an order or order line item is considered incomplete when payment from the buyer has yet to be initiated. This value indicates that the order or order line item is complete. Generally speaking, an order or order line item is complete when payment from the buyer has been initiated and has been processed. Note: If the PaymentMethodUsed is <code>CashOnPickup</code>, the CheckoutStatus.Status value in GetOrders will be <code>Complete</code> at checkout time, even though the seller may not have been officially paid yet. The CheckoutStatus.Status value in GetOrders will remain as <code>Complete</code> even if the seller changes the checkout status to Pending. However, the eBayPaymentStatus value in GetOrders will change from <code>NoPaymentFailure</code> to <code>PaymentInProcess</code>. This value indicates that the order or order line item is in the pending state. Generally speaking, an order is considered pending when payment from the buyer has been initiated but has yet to be fully processed. Note: If the payment method is <code>CashOnPickup</code>, the CheckoutStatus.Status value in GetOrders will read <code>Complete</code> at checkout time, even though the seller may not have been officially paid yet. The CheckoutStatus.Status value in GetOrders will remain as <code>Complete</code> even if the seller changes the checkout status to Pending. However, the eBayPaymentStatus value in GetOrders will change from <code>NoPaymentFailure</code> to <code>PaymentInProcess</code>. Reserved for internal or future use This type contains details like name, value, and additional information, that is provided by the seller about the specific condition of an item. A numeric ID is passed in this field. This numeric ID maps to the name of a condition descriptor. Condition descriptor name-value pairs provide more information about an item's condition in a structured way. To retrieve all condition descriptor numeric IDs for a category, use the <a href = "/api-docs/sell/metadata/resources/marketplace/methods/getItemConditionPolicies">getItemConditionPolicies</a> method of the Metadata API. In the case of trading cards, this field is used to provide condition descriptors for a card. For graded cards, the condition descriptors for Grader and Grade are required, while the condition descriptor for Certification Number is optional. For ungraded cards, only the Card Condition condition descriptor is required. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally A numeric ID is passed in this field. This numeric ID maps to the value associated with a condition descriptor name. Condition descriptor name-value pairs provide more information about an item's condition in a structured way. To retrieve all condition descriptor numeric IDs for a category, use the <a href = "/api-docs/sell/metadata/resources/marketplace/methods/getItemConditionPolicies">getItemConditionPolicies</a> method of the Metadata API. In the case of trading cards, this field houses the information on the Grader and Grade descriptors of graded cards and the Card Condition descriptor for ungraded cards. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally Open text is passed in this field. This text provides additional information about a condition descriptor. In the case of trading cards, this field houses the optional Certification Number condition descriptor for graded cards. 30 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally This type contains the data for condition descriptors associated with an item. This container is used by the seller to provide additional information about the condition of an item in a structured format. Condition descriptors are name-value attributes that can be either closed set or open text inputs. To retrieve all condition descriptor numeric IDs for a category, use the <a href = "/api-docs/sell/metadata/resources/marketplace/methods/getItemConditionPolicies">getItemConditionPolicies</a> method of the Metadata API. Note: The use of Condition Descriptors is currently only available for the following trading card categories (CategoryID): <ul><li>Non-Sport Trading Card Singles (<code>183050</code>)</li> <li>CCG Individual Cards (<code>183454</code>)</li> <li>Sports Trading Card Singles (<code>261328</code>)</li></ul> AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally Enumerated type that defines the values used to indicate whether Condition IDs are enabled/disabled for all/most of a site's categories (SiteDefaults.ConditionEnabled), or enabled/required/disabled for a specific eBay category (Category.ConditionEnabled). This value indicates that Condition IDs are disabled for all/most of a site's categories (if returned in the SiteDefaults.ConditionEnabled field), or disabled for a specific category (if returned in the Category.ConditionEnabled field). This value indicates that Condition IDs are enabled for all/most of a site's categories (if returned in the SiteDefaults.ConditionEnabled field), or enabled for a specific category (if returned in the Category.ConditionEnabled field). This value indicates that Condition IDs are required for a specific category (if returned in the Category.ConditionEnabled field). This value is not applicable at the site level (SiteDefaults container). (out) Reserved for internal or future use. Type defining the ConditionEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as 'ConditionEnabled' is included as a FeatureID value in the call request or no FeatureID values are passed into the call request). This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the use of Condition IDs to express the condition of an item. To verify if a specific eBay site supports Condition IDs (for most categories), look for a 'Enabled' value in the SiteDefaults.ConditionEnabled field. To verify if a specific category on a specific eBay site supports Condition IDs, pass in a CategoryID value in the request, and then look for an 'Enabled' or 'Required' value in the ConditionEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Type defining the ConditionValues.Condition and SpecialFeatures.Condition containers that are returned at the site default level and category level in the GetCategoryFeatures response if 'ConditionValues' is specified as a FeatureID value, or if no FeatureID values are specified. A ConditionValues.Condition container is returned for each supported item condition value for each eBay category returned in the response, and a SpecialFeatures.Condition container is returned for item condition values that a seller must be pre-qualified to use, such as the refurbished conditions. The numeric identifier of the item condition (e.g., 1000). The numeric identifier is used in the Item.ConditionID field in Add/Revise/Relist calls to set the condition of an item. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally The human-readable label for the condition (e.g., "New"). This value is typically localized for each site. The display name can vary by category. For example, condition ID 1000 could be called "New: with Tags" in one category and "Brand New" in another. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Defines the Item Condition feature. If a field of this type is present, the corresponding feature applies to the site. The field is returned as an empty element (e.g., a boolean value is not returned). Fields in this type provide condition values and display names. This repeatable container shows the display name and unique identifier of each item condition supported by the corresponding eBay category. Note: 'Certified Refurbished', 'Excellent - Refurbished', 'Very Good - Refurbished', and 'Good - Refurbished' item conditions will not be returned in this container for categories in the eBay Refurbished Program, but instead will be returned in the Category.SpecialFeatures container if the corresponding category supports any of these Refurbished item conditions. To used any of these Refurbished item conditions, sellers must go through an <a href="https://pages.ebay.com/seller-center/listing-and-marketing/ebay-refurbished-program.html" target="_blank">application and qualification process</a>. The new item condition values appearing in the Category.SpecialFeatures container does not necessarily indicate that a seller is eligible to list with these item conditions. If the corresponding category supports it, 'Seller Refurbished' will still be returned in this container. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally URL to the eBay Web site's item condition help for the category. This may include policies about how to assess the condition of an item in the category. To reduce item-not-as-described cases, we recommend that you refer sellers (and buyers) to these help pages. These help pages may vary for some categories. The Sandbox might not return valid help URLs. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Type defining the ContactHoursDetails container, which is used in Add/Revise/Relist calls to provide contact hours for the owner of a Classified Ad. The ContactHoursDetails container is only applicable to Classified Ad listings. Indicates the local time zone of the values provided for Hours1From/Hours1To and Hours2From/Hours2To. If you specify a contact hours time range with Hours1From and Hours1To, you must provide a local time zone. To retrieve a complete list of the TimeZoneID values supported by eBay, call GeteBayDetails with DetailName set to TimeZoneDetails. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates the range of days for which the primary contact hours specified by Hours1AnyTime or Hours1From and Hours1To apply. If a value of None is provided for this field, the values provided for Hours1AnyTime, Hours1From, Hours1To are ignored. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates whether or not a user is available to be contacted 24 hours a day during the range of days specified using the Hours1Days element. True indicates the user is available 24 hours a day, false indicates otherwise. In the case of this field being true, all values provided for Hours1From and Hours1To will be ignored. In the case of this field being false, the values provided Hours1From and Hours1To will be considered. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates the starting time of day this eBay user is available for other eBay members to contact for the range of days specified using Hours1Days. Enter times in 30 minute increments from the top of the hour. That is, enter values either on the hour (:00) or 30 minutes past the hour (:30). Other values will be will be rounded down to the next closest 30 minute increment. Times entered should be local to the value provided for TimeZoneID. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates the ending time of day this eBay user is available for other eBay members to contact them for the range of days specified using Hours1Days. Enter times in 30 minute increments from the top of the hour. That is, enter values either on the hour (:00) or 30 minutes past the hour (:30). Other values will be will be rounded down to the next closest 30 minute increment. Times entered should be local to the value provided for TimeZoneID. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates the range of days for which the secondary contact hours specified by Hours2AnyTime or Hours2From and Hours2To apply. If a value of None is provided for this field, the values provided for Hours2AnyTime, Hours2From, Hours2To are ignored. Note: You cannot set Hours2Days to EveryDay. If Hours1Days is set to EveryDay, secondary contact hours do not apply. Hours2Days cannot be set to the same value as Hours1Days. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates whether or not a user is available to be contacted 24 hours a day during the range of days specified using the Hours2Days element. True indicates the user is available 24 hours a day, false indicates otherwise. In the case of this field being true, all values provided for Hours2From and Hours2To will be ignored. In the case of this field being false, the values provided Hours2From and Hours2To will be considered. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates the starting time of day this eBay user is available for other eBay members to contact for the range of days specified using Hours2Days. Enter times in 30 minute increments from the top of the hour. That is, enter values either on the hour (:00) or 30 minutes past the hour (:30). Other values will be will be rounded down to the next closest 30 minute increment. Times entered should be local to the value provided for TimeZoneID. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This enumerated type is used to indicate which flat-rate shipping cost group that a shipping service option belongs to. This enumeration value indicates that the shipping service option belongs to flat-rate shipping cost group 1. This enumeration value indicates that the shipping service option belongs to flat-rate shipping cost group 2. This enumeration value indicates that the shipping service option belongs to flat-rate shipping cost group 3. Reserved for internal or future use. This enumerated type contains a partial list of ISO 3166 standard two-letter codes that represent countries around the world. It is recommended that users use the GeteBayDetails call to see the full list of currently supported country codes, and the English names associated with each code (e.g., KY="Cayman Islands"). Call GeteBayDetails with DetailName set to Country, and then look for CountryDetails.Country fields in the response. QP Afghanistan. Albania. Algeria. American Samoa. Andorra. Angola. Anguilla. Antarctica. Antigua and Barbuda. Argentina. Armenia. Aruba. Australia. Austria. Azerbaijan. Bahamas. Bahrain. Bangladesh. Barbados. Belarus. Belgium. Belize. Benin. Bermuda. Bhutan. Bolivia. Bosnia and Herzegovina. Botswana. Bouvet Island. Brazil. British Indian Ocean Territory. Brunei Darussalam. Bulgaria. Burkina Faso. Burundi. Cambodia. Cameroon. Canada. Cape Verde. Cayman Islands. Central African Republic. Chad. Chile. China. Christmas Island. Cocos (Keeling) Islands. Colombia. Comoros. Congo. Congo, The Democratic Republic of the. Cook Islands. Costa Rica. Cote d'Ivoire. Croatia. Cuba. Cyprus. Czech Republic. Denmark. Djibouti. Dominica. Dominican Republic. No longer in use. Ecuador. Egypt. El Salvador. Equatorial Guinea. Eritrea. Estonia. Ethiopia. Falkland Islands (Malvinas). Faroe Islands. Fiji. Finland. France. French Guiana. French Polynesia. Includes Tahiti. French Southern Territories. Gabon. Gambia. Georgia. Germany. Ghana. Gibraltar. Greece. Greenland. Grenada. Guadeloupe. Guam. Guatemala. Guinea. Guinea-Bissau. Guyana. Haiti. Heard Island and McDonald Islands. Holy See (Vatican City state). Honduras. Hong Kong. Hungary. Iceland. India. Indonesia. Islamic Republic of Iran. Iraq. Ireland. Israel. Italy. Jamaica. Japan. Jordan. Kazakhstan. Kenya. Kiribati. Democratic People's Republic of Korea. Republic of Korea. Kuwait. Kyrgyzstan. Lao People's Democratic Republic. Latvia. Lebanon. Lesotho. Liberia. Libyan Arab Jamahiriya. Liechtenstein. Lithuania. Luxembourg. Macao. The Former Yugoslav Republic of Macedonia. Madagascar. Malawi. Malaysia. Maldives. Mali. Malta. Marshall Islands. Martinique. Mauritania. Mauritius. Mayotte. Mexico. Federated States of Micronesia. Republic of Moldova. Monaco. Mongolia. Montserrat. Morocco. Mozambique. Myanmar. Namibia. Nauru. Nepal. Netherlands. Netherlands Antilles. New Caledonia. New Zealand. Nicaragua. Niger. Nigeria. Niue. Norfolk Island. Northern Mariana Islands. Norway. Oman. Pakistan. Palau. Palestinian territory, Occupied. Panama. Papua New Guinea. Paraguay. Peru. Philippines. Pitcairn. Poland. Portugal. Puerto Rico. Qatar. Reunion. Romania. Russian Federation. Rwanda. Saint Helena. Saint Kitts and Nevis. Saint Lucia. Saint Pierre and Miquelon. Saint Vincent and the Grenadines. Samoa. San Marino. Sao Tome and Principe. Saudi Arabia. Senegal. Seychelles. Sierra Leone. Singapore. Slovakia. Slovenia. Solomon Islands. Somalia. South Africa. South Georgia and the South Sandwich Islands. Spain. Sri Lanka. Sudan. Suriname. Svalbard and Jan Mayen. Swaziland. Sweden. Switzerland. Syrian Arab Republic. Taiwan, Province of China. Tajikistan. Tanzania, United Republic of. Thailand. Togo. Tokelau. Tonga. Trinidad and Tobago. Tunisia. Turkey. Turkmenistan. Turks and Caicos Islands. Tuvalu. Uganda. Ukraine. United Arab Emirates. United Kingdom. United States. NOTE: United States Minor Outlying Islands was defined in the eBay list previously but is no longer a viable option. This country will remain on eBay country list for backward compatibility. Use 'US' instead. Uruguay. Uzbekistan. Vanuatu. Venezuela. Vietnam. Virgin Islands, British. Virgin Islands, U.S. Wallis and Futuna. Western Sahara. Yemen. No longer in use. See RS for Serbia and ME for Montenegro. Zambia. Zimbabwe. NOTE: APO/FPO was defined in eBay list previously but they are not defined in ISO 3166. This country will remain on eBay country code list for backward compatibility. NOTE : Guernsey was defined in eBay list previously but they are not defined in ISO 3166. This country will remain on eBay country list for backward compatibility. NOTE: Jan Mayen was defined in eBay list previously but they are not defined in ISO 3166. This country will remain on eBay country list for backward compatibility. NOTE: Jersey was defined in eBay list previously but they are not defined in ISO 3166. This country will remain on eBay country list for backward compatibility. Jersey Guernsey Unknown country Serbia Montenegro. (out) Reserved for internal or future use Details about a specific country. Two-letter code representing a country. These two-letter codes are typically used in Add/Revise/Relist calls when referring to a country. Item.Country in AddItem AddItem.html#Request.Item.Country GeteBayDetails Conditionally Full country name for display purposes. May be similar to (but not necessarily identical to) CountryName in addresses (e.g., User.RegistrationAddress.CountryName in GetUser). GeteBayDetails Conditionally Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always This type specifies custom product compliance and/or take-back policies that apply to a specified country. Contains a country and the custom policy/policies for that country. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No This type specifies custom product compliance and/or take-back policies that apply to a specified country. Defines the 2-letter country code set. Use the <a href ="http://developer.ebay.com/DevZone/XML/docs/Reference/eBay/GeteBayDetails.html">GeteBayDetails</a> call to see the list of currently supported codes, and the English names associated with each code (e.g., KY="Cayman Islands"). Most of the codes that eBay uses conform to the ISO 3166 standard, but some of the codes in the ISO 3166 standard are not used by eBay. Plus, there are some non-ISO codes in the eBay list. (Additional codes appear at the end of this code list and are noted as non-ISO.) AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No The policy Id specifying product compliance or take-back policy information. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No Type defining the CrossBorderTradeAustraliaEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as 'CrossBorderTradeEnabled' is included as a FeatureID value in the call request or no FeatureID values are passed into the call request). This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support Cross Border Trade listings on the eBay Australia site. To verify if a specific eBay site supports Cross Border Trade listings on the eBay Australia site (for most categories), look for a 'true' value in the SiteDefaults.CrossBorderTradeAustraliaEnabled field. To verify if a specific category on a specific eBay site supports Cross Border Trade listings on the eBay Australia site, pass in a CategoryID value in the request, and then look for a 'true' value in the CrossBorderTradeAustraliaEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Type defining the CrossBorderTradeGBEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as 'CrossBorderTradeEnabled' is included as a FeatureID value in the call request or no FeatureID values are passed into the call request). This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support Cross Border Trade listings on the eBay UK and eBay Ireland sites. To verify if a specific eBay site supports Cross Border Trade listings on the eBay UK and eBay Ireland sites (for most categories), look for a 'true' value in the SiteDefaults.CrossBorderTradeGBEnabled field. To verify if a specific category on a specific eBay site supports Cross Border Trade listings on the eBay UK and eBay Ireland sites, pass in a CategoryID value in the request, and then look for a 'true' value in the CrossBorderTradeGBEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Type defining the CrossBorderTradeNorthAmericaEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as 'CrossBorderTradeEnabled' is included as a FeatureID value in the call request or no FeatureID values are passed into the call request). This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support Cross Border Trade listings on the eBay US and eBay Canada sites. To verify if a specific eBay site supports Cross Border Trade listings on the eBay US and eBay Canada sites (for most categories), look for a 'true' value in the SiteDefaults.CrossBorderTradeNorthAmericaEnabled field. To verify if a specific category on a specific eBay site supports Cross Border Trade listings on the eBay US and eBay Canada sites, pass in a CategoryID value in the request, and then look for a 'true' value in the CrossBorderTradeNorthAmericaEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). This enumeration type contains a list of standard 3-digit ISO 4217 currency codes for currency used in countries around the world. When adding an item through AddItem (or related API call), the Item.Currency value will default to the currency used on the listing site. Otherwise, only the following currency types may be specified through an Add/Revise/Relist call, since these are the currencies of all the countries where the Trading API is supported: <ul> <li>USD - US Dollar</li> <li>CAD - Canadian Dollar</li> <li>GBP - British Pound</li> <li>AUD - Australian Dollar</li> <li>EUR - Euro</li> <li>CHF - Swiss Franc</li> <li>CNY - Chinese Renminbi</li> <li>HKD - Hong Kong Dollar</li> <li>PHP - Philippines Peso</li> <li>PLN - Polish Zloty</li> <li>SEK - Sweden Krona</li> <li>SGD - Singapore Dollar</li> <li>TWD - Taiwanese Dollar</li> <li>MYR - Malaysian Ringgit</li> </ul> Other currency codes in this enumerated type may be returned in GetItem (and other calls) based on the buyer's and/or seller's registration country. However, only the values listed above will be returned if you call GeteBayDetails with DetailName set to CurrencyDetails. http://www.xe.com/iso4217.htm This value is a 3-digit code for an Afghan afghani, a currency used in Afghanistan. This value is a 3-digit code for an Albanian lek, a currency used in Albania. This value is a 3-digit code for an Algerian dinar, a currency used in Algeria. This value is a 3-digit code for an Andorran peseta, a currency used in Andorra. This value is a 3-digit code for an Angolan kwanza, a currency used in Angola. This value is a 3-digit code for an Argentine peso, a currency used in Argentina. This value is a 3-digit code for an Armenian dram, a currency used in Armenia. This value is a 3-digit code for an Aruban florin, a currency used in Aruba. This value is a 3-digit code for an Azerbaijani manat, a currency used in Azerbaijan. This value is a 3-digit code for a Bahamian dollar, a currency used in the Bahamas. This value is a 3-digit code for a Bahraini dinar, a currency used in the Bahrain. This value is a 3-digit code for a Bangladeshi taka, a currency used in Bangladesh. This value is a 3-digit code for a Barbados dollar, a currency used in Barbados. This value is a 3-digit code for a Belarusian ruble, a currency used in Belarus. This value is a 3-digit code for a Belize dollar, a currency used in Belize. This value is a 3-digit code for a Bermudian dollar, a currency used in Bermuda. This value is a 3-digit code for a Bhutanese ngultrum, a currency used in Bhutan. This value is a 3-digit code for an Indian rupee, a currency used in India. This value is a 3-digit code for a Bolivian Mvdol, a currency used in Bolivia. This value is a 3-digit code for a Boliviano, a currency used in Bolivia. This value is a 3-digit code for a Bosnia and Herzegovina convertible mark, a currency used in Bosnia and Herzegovina. This value is a 3-digit code for a Botswana pula, a currency used in Botswana. This value is a 3-digit code for a Brazilian real, a currency used in Brazil. This value is a 3-digit code for a Brunei dollar, a currency used in Brunei and Singapore. This value is a 3-digit code for the old Bulgarian lev, a currency previously used in Bulgaria. This currency has been replaced by the new Bulgarian lev (3-digit code: BGN). This value is a 3-digit code for a Bulgarian lev, a currency used in Bulgaria. This currency replaced the old Bulgarian lev (3-digit code: BGL). This value is a 3-digit code for a Burundian franc, a currency used in Burundi. This value is a 3-digit code for a Cambodian riel, a currency used in Cambodia. This value is a 3-digit code for a Canadian dollar, a currency used in Canada. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the eBay Canada site (Site ID 2). This value is a 3-digit code for a Cape Verde escudo, a currency used in Cape Verde. This value is a 3-digit code for a Cayman Islands dollar, a currency used in the Cayman Islands. This value is a 3-digit code for a Central African CFA franc, a currency used in Cameroon, Central African Republic, Republic of the Congo, Chad, Equatorial Guinea, and Gabon. This value is a 3-digit code for a Unidad de Fomento, a currency used in Chile. This value is a 3-digit code for a Chilean peso, a currency used in Chile. This value is a 3-digit code for a Chinese yuan (also known as the renminbi), a currency used in China. This value is a 3-digit code for a Columbian peso, a currency used in Columbia. This value is a 3-digit code for a Comoro franc, a currency used in Comoros. This value is a 3-digit code for a Congolese franc, a currency used in Democratic Republic of Congo. This value is a 3-digit code for a Costa Rican colon, a currency used in Costa Rica. This value is a 3-digit code for a Croatian kuna, a currency used in Croatia. This value is a 3-digit code for a Cuban peso, a currency used in Cuba. This value is a 3-digit code for a Cypriot pound, a currency previously used in Cyprus. This currency has been replaced by the Euro (3-digit code: EUR). This value is a 3-digit code for a Czech koruna, a currency used in the Czech Republic. This value is a 3-digit code for a Danish krone, a currency used in Denmark, the Faroe Islands, and Greenland. This value is a 3-digit code for a Djiboutian franc, a currency used in Djibouti. This value is a 3-digit code for a Dominican peso, a currency used in the Dominican Republic. This value is a 3-digit code for a Portuguese Timorese escudo, a currency previously used in Portuguese Timor. This value is an old 3-digit code for a Cape Verde escudo, a currency used in Cape Verde. The 'ECV' code has been replaced by 'CVE'. This value is a 3-digit code for an Ecuadorian sucre, a currency previously used in Ecuador. This currency has been replaced by the US Dollar (3-digit code: USD). This value is a 3-digit code for an Egyptian pound, a currency used in Egypt. This value is a 3-digit code for a Salvadoran colon, a currency previously used in El Salvador. This currency has been replaced by the US Dollar (3-digit code: USD). This value is a 3-digit code for an Eritrean nakfa, a currency used in Eritrea. This value is a 3-digit code for an Estonian kroon, a currency previously used in Estonia. This currency has been replaced by the Euro (3-digit code: EUR). This value is a 3-digit code for an Ethiopian birr, a currency used in Ethiopia. This value is a 3-digit code for a Falkland Islands pound, a currency used in the Falkland Islands. This value is a 3-digit code for a Fiji dollar, a currency used in Fiji. This value is a 3-digit code for a Gambian dalasi, a currency used in Gambia. This value is a 3-digit code for a Georgian Iari, a currency used in the country of Georgia. This value is an old 3-digit code for a Ghanaian cedi, a currency used in Ghana. The 'GHC' code has been replaced by 'GHS'. This value is a 3-digit code for a Gibraltar pound, a currency used in Gibraltar. This value is a 3-digit code for a Guatemalan quetzal, a currency used in Guatemala. This value is a 3-digit code for a Guinean franc, a currency used in Guinea. This value is a 3-digit code for a Guinea-Bissau peso, a currency previously used in Guinea-Bissau. This currency has been replaced by the West African CFA franc (3-digit code: XOF). This value is a 3-digit code for a Guyanese dollar, a currency used in Guyana. This value is a 3-digit code for a Haitian gourde, a currency used in Haiti. This value is a 3-digit code for a Honduran lempira, a currency used in Honduras. This value is a 3-digit code for a Hong Kong dollar, a currency used in Hong Kong and Macau. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the eBay Hong Kong site (Site ID 201). This value is a 3-digit code for a Hungarian forint, a currency used in Hungary. This value is a 3-digit code for an Icelandic krona, a currency used in Iceland. This value is a 3-digit code for an Indonesian rupiah, a currency used in Indonesia. This value is a 3-digit code for an Iranian rial, a currency used in Iran. This value is a 3-digit code for an Iraqi dinar, a currency used in Iraq. This value is a 3-digit code for an Israeli new shekel, a currency used in Israel and in the Palestinian territories. This value is a 3-digit code for a Jamaican dollar, a currency used in Jamaica. This value is a 3-digit code for a Japanese yen, a currency used in Japan. This value is a 3-digit code for a Jordanian dinar, a currency used in Jordan. This value is a 3-digit code for a Kazahhstani tenge, a currency used in Kazakhstan. This value is a 3-digit code for a Kenyan shilling, a currency used in Kenya. This value is a 3-digit code for an Australia dollar, a currency used in Australia. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the eBay Australia site (Site ID 15). This value is a 3-digit code for a North Korean won, a currency used in North Korea. This value is a 3-digit code for a South Korean won, a currency used in South Korea. This value is a 3-digit code for a Kuwaiti dollar, a currency used in Kuwait. This value is a 3-digit code for a Kyrgzstani som, a currency used in Kyrgystan. This value is a 3-digit code for a Lao kip, a currency used in Laos. This value is a 3-digit code for a Latvian lats, a currency used in Latvia. This value is a 3-digit code for a Lebanese pound, a currency used in Lebanon. This value is a 3-digit code for a Lesotho loti, a currency used in Lesotho. This value is a 3-digit code for a Liberian dollar, a currency used in Liberia. This value is a 3-digit code for a Libyan dinar, a currency used in Libya. Swiss Franc. For eBay, you can only specify this currency for listings you submit to the Switzerland site (site ID 193). This value is a 3-digit code for a Lithuanian litas, a currency used in Lithuania. This value is a 3-digit code for a Macanese pataca, a currency used in Macao. This value is a 3-digit code for a Macedonian denar, a currency used in Macedonia. This value is a 3-digit code for a Malagay franc, a currency previously used in Madagascar. This currency has been replaced by the Malagasy ariary (3-digit code: MGA). This value is a 3-digit code for a Malawian kwacha, a currency used in Malawi. This value is a 3-digit code for a Malaysian Ringgit, a currency used in Malaysia. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the eBay Malaysia site (Site ID 207). This value is a 3-digit code for a Maldivian rufiyaaa, a currency used in the Maldives. This value is a 3-digit code for a Maltese lira, a currency previously used in Malta. This currency has been replaced by the Euro (3-digit code: EUR). This value is a 3-digit code for a EURO, a currency used in Andorra, Austria, Belgium, Cyprus, Estonia, Finland, France, Germany, Greece, Ireland, Italy, Kosovo, Luxembourg, Malta, Monaco, Montenegro, Netherlands, Portugal, San Marino, Slovakia, Slovenia, Spain, and Vatican City. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the following sites: Austria (Site ID 16), Belgium_French (Site ID 23), France (Site ID 71), Germany (Site ID 77), Italy (Site ID 101), Belgium_Dutch (Site ID 123), Netherlands (Site ID 146), Spain (Site ID 186), and Ireland (Site ID 205). This value is a 3-digit code for a Mauritanian ouguiya, a currency used in Mauritania. This value is a 3-digit code for a Mauritian rupee, a currency used in Mauritius. This value is a 3-digit code for a Mexican peso, a currency used in Mexico. This value is a 3-digit funds code for a Mexican peso, a currency used in Mexico. This value is a 3-digit code for a Moldovan leu, a currency used in Moldova. This value is a 3-digit code for a Mongolian tugrik, a currency used in Mongolia. This value is a 3-digit code for an Easy Caribbean dollar, a currency used in Anguilla, Antigua and Barbuda, Dominica, Grenada, Montserrat, Saint Kitts and Nevis, Saint Lucia, and Saint Vincent and the Grenadines. This value is an old 3-digit code for a Mozambican metical, a currency used in Mozambique. The 'MZM' code has been replaced by 'MZN'. This value is a 3-digit code for a Myanma kyat, a currency used in Myanmar. This value is a 3-digit code for a South African rand, a currency used in South Africa. This value is a 3-digit code for a Namibian dollar, a currency used in Namibia. This value is a 3-digit code for a Nepalese rupee, a currency used in Nepal. This value is a 3-digit code for a Netherlands Antillean guilder, a currency used in Curacao and Sint Maarten. This value is a 3-digit code for a CFP franc, a currency used in French Polynesia, New Caledonia, and Wallis and Futuna. This value is a 3-digit code for a New Zealand dollar, a currency used in the Cook Islands, New Zealand, Niue, Pitcairn, and Tokelau, Ross Dependency. This value is a 3-digit code for a Nicaraguan cordoba, a currency used in Nicaragua. This value is a 3-digit code for a Nigerian naira, a currency used in Nigeria. This value is a 3-digit code for a Norwegian kron, a currency used in Norway, Svalbard, Jan Mayen, Bouvet Island, Queen Maud Land, and Peter I Island. This value is a 3-digit code for an Omani rial, a currency used in Oman. This value is a 3-digit code for a Pakistani rupee, a currency used in Pakistan. This value is a 3-digit code for a Panamanian balboa, a currency used in Panama. This value is a 3-digit code for a Papua New Guinea kina, a currency used in Papua New Guinea. This value is a 3-digit code for a Paraguayan guarani, a currency used in Paraguay. This value is a 3-digit code for a Peruvian nuevo sol, a currency used in Peru. This value is a 3-digit code for a Philippine peso, a currency used in the Philippines. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the eBay Philippines site (Site ID 211). This value is a 3-digit code for a Polish zloty, a currency used in Poland. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the eBay Poland site (Site ID 212). This value is a 3-digit code for a US dollar, a currency used in the United States, America Samoa, Barbados, Bermuda, British Indian Ocean Territory, British Virgin Islands, Caribbean Netherlands, Ecuador, El Salvador, Guam, Haiti, Marshall Islands, Federated States of Micronesia, Northern Mariana Islands, Palau, Panama, Puerto Rico, Timor-Leste, Turks and Caicos Islands, US Virgin Islands, and Zimbabwe. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the eBay US or US eBay Motors site (Site ID 0). This value is a 3-digit code for a Qatari riyal, a currency used in Qatar. This value is a 3-digit code for the old Romanian leu, a currency previously used in Romania. This currency has been replaced by the Romanian new leu (3-digit code: RON). This value is a 3-digit code for a Russian rouble, a currency used in Russia, Abkhazia, and South Ossetia. This value replace the old 3-digit code for the Russian rouble, 'RUR'. This value is the old 3-digit code for a Russian rouble, a currency used in Russia. This value was replaced by the new 3-digit code for the Russian rouble, 'RUB'. This value is a 3-digit code for a Rwandan franc, a currency used in Rwanda. This value is a 3-digit code for a Saint Helena pound, a currency used in Saint Helena. This value is a 3-digit code for a Samoan tala, a currency used in Samoa. This value is a 3-digit code for a Sao Tome and Principe dobra, a currency used in Sao Tome and Principe. This value is a 3-digit code for a Saudi riyal, a currency used in Saudi Arabia. This value is a 3-digit code for a Seychelles rupee, a currency used in Seychelles. This value is a 3-digit code for a Sierra Leonean leone, a currency used in Sierra Leone. This value is a 3-digit code for a Singapore dollar, a currency used in Singapore and Brunei. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the eBay Singapore site (Site ID 216). This value is a 3-digit code for a Slovak koruna, a currency previously used in Slovakia. This currency has been replaced by the Euro (3-digit code: EUR). This value is a 3-digit code for a Slovenian tolar, a currency previously used in Slovenia. This currency has been replaced by the Euro (3-digit code: EUR). This value is a 3-digit code for a Solomon Islands dollar, a currency used in the Solomon Islands. This value is a 3-digit code for a Somali shilling, a currency used in Somalia. This value is a 3-digit code for a Sri Lankan rupee, a currency used in Sri Lanka. This value is the 3-digit code for a Sudanese dinar, a currency previously used in Sudan. The Sudanese dinar was replaced by the Sudanese pound, which has a 3-digit code of 'SDG'. This value is the 3-digit code for a Suriname guilder, a currency previously used in Suriname. The Surinam guilder was replaced by the Surinamese dollar, which has a 3-digit code of 'SRD'. This value is a 3-digit code for a Swazi lilangeni, a currency used in Swaziland. This value is a 3-digit code for a Swedish krona, a currency used in Swedn. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the eBay Sweden site (Site ID 218). This value is a 3-digit code for a Syrian pound, a currency used in Syria. This value is a 3-digit code for the New Taiwan dollar, a currency used in Taiwan. This value is a 3-digit code for a Tajikistani somoni, a currency used in Tajikistan. This value is a 3-digit code for a Tanzanian shilling, a currency used in Tanzania. This value is a 3-digit code for a Thai baht, a currency used in Thailand. This value is a 3-digit code for a West African CFA franc, a currency used in Benin, Burkina Faso, Cote d'Ivoire, Guinea-Bissau, Mali, Niger, Senegal, and Togo. This value is a 3-digit code for a Tongan pa'anga, a currency used in Tonga. This value is a 3-digit code for a Trinidad and Tobago dollar, a currency used in Trinidad and Tobago. This value is a 3-digit code for a Tunisian dinar, a currency used in Tunisia. This value is the old 3-digit code for a Turkish lira, a currency used in Turkey and Northern Cyprus. This value was replaced by the new 3-digit code for the Turkish lira, 'TRY'. This value is the old 3-digit code for a Turkmenistani manat, a currency used in Turkmenistan. This value was replaced by the new 3-digit code for the Turkmenistani manat, 'TMT'. This value is a 3-digit code for a Ugandan shilling, a currency used in Uganda. This value is a 3-digit code for a Ukrainian hryvnia, a currency used in the Ukraine. This value is a 3-digit code for an United Arab Emirates dirham, a currency used in the United Arab Emirates. This value is a 3-digit code for a Pound sterling, a currency used in the United Kingdom and British Crown dependencies. This is the value that should be passed in the Item.Currency field by the seller when listing an item on the eBay UK site (Site ID 3). This value is a 3-digit code for a same-day transaction involving US dollars. This value is a 3-digit code for a next-day transaction involving US dollars. This value is a 3-digit code for a Uruguayan peso, a currency used in Uruguay. This value is a 3-digit code for a Uzbekistan som, a currency used in the Uzbekistan. This value is a 3-digit code for a Vanuatu vatu, a currency used in Vanuatu. This value is a 3-digit code for a Venezuelan bolivar, a currency previously used in Venezuela. The Venezuela bolivar was replaced by the Venezuelan bolivar fuerte, which has a 3-digit code of 'VEF'. This value is a 3-digit code for a Vietnamese dong, a currency used in Vietnam. This value is a 3-digit code for a Moroccan dirham, a currency used in Morocco. This value is a 3-digit code for a Yemeni rial, a currency used in Yemen. This value is a 3-digit code for a Yugoslav dinar, a currency previously used in Yugoslavia. The Yugoslav dinar was replaced by the Serbian dinar, which has a 3- digit code of 'RSD'. This value is the old 3-digit code for a Zambian kwacha, a currency used in Zambia. The 'ZMK' code has been replaced by 'ZMW'. This value is the old 3-digit code for a Zimbabwean dollar, a currency previously used in Zimbabwe. The US dollar replaced the Zimbabwean dollar as the official currency in Zimbabwe. This value is a 3-digit code for an Austrian schilling, a currency previously used in Austria. This currency has been replaced by the Euro (3-digit code: EUR). This value is a 3-digit code for the new Romanian leu, a currency used in Romania. Reserved for internal or future use. Type defining the CurrencyDetails container that is returned in the GeteBayDetails response if 'CurrencyDetails' is used as a DetailName value in the request, or no DetailName values are used in the request. A CurrencyDetails container is returned for each currency value that is available to use in the Item.Currency field in an Add/Revise/Relist call. Three-digit currency codes as defined in ISO 4217. The currency codes returned in GeteBayDetails can be used as values in the Currency field of the Add/Revise/Relist and other Trading API calls. Item.Currency AddItem.html#Request.Item.Currency Item.StartPrice AddItem.html#Request.Item.StartPrice GeteBayDetails Conditionally Full currency name for display purposes. GeteBayDetails Conditionally Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always This type is used by the CustomPolicies container, which specifies custom policy IDs. A custom policy ID refers to the relevant policy created for product compliance and other purposes. For more information, see the Custom Policies page for your site (for example, <a href="https://www.ebay.fr/help/selling/custom-policies/custom-policies?id=5311" target="_blank">https://www.ebay.fr/help/selling/custom-policies/custom-policies?id=5311</a>). To create and manage custom policies, use the <a href="https://developer.ebay.com/api-docs/sell/account/resources/methods#h2-custom_policy" target="_blank">custom_policy</a> resource of the Account API. This field is used if the seller wants to apply a global take-back policy to the listing. The law in some countries may require sellers to take back a used product when the buyer buys a new product. Use this field to specify one global take-back policy ID for the listing. Note: For countries that support country-specific policies, use RegionalTakeBackPolicies to apply them to a listing. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No The list of unique identifiers indicating the seller-created country-specific take-back policies that will be used for a listing. The law in some countries may require sellers to take back a used product when the buyer buys a new product. Each listing may include one (1) country-specific take-back policy for each of the following countries:<ul><li>United Kingdom [GB]</li><li>Germany [DE]</li><li>France [FR]</li><li>Italy [IT]</li><li>Spain [ES]</li></ul> Note: Take-back policies that apply to all countries to which a seller ships are specified using TakeBackPolicyID. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No This field is used if the seller wants to apply one or more seller-created global product compliance policies that will be used in a listing. A separate ProductCompliancePolicyID field is required for each policy to be applied, and the seller specifies the identifier of each policy in this field. Product compliance policies provide buyers with important information and disclosures about products. For example, if you sell batteries and specific disclosures are required to be shared with all potential buyers, your global product compliance policy could contain the required disclosures. A maximum of six (6) global product compliance policies may be applied to each listing. Note: For countries that support country-specific policies, use RegionalProductCompliancePolicies to apply them to a listing. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No The set of compliance policies for indicating the seller-created country-specific product compliance policies that that will be used for a listing. Product compliance policies provide buyers with important information and disclosures about products. For example, if you sell batteries in a country requiring disclosures that apply only to that country, a country-specific product compliance policy could contain this information. Each listing may include up to six (6) product compliance policies for each of the following countries:<ul><li>United Kingdom [GB]</li><li>Germany [DE]</li><li>France [FR]</li><li>Italy [IT]</li><li>Spain [ES]</li></ul> For example, if a seller offers products in the UK, Germany, and Italy, each of which requires custom product compliance information, up to 18 policies (in other words, 6 policies x 3 countries) may be included for each listing. Note: Product compliance policies that apply to all countries to which a seller ships are specified using ProductCompliancePolicyID. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No Specifies the range of days the seller can be contacted. Seller does not want to be contacted. Contact hours will not be supported for any days. If contact hours are specified, they will be ignored. Seller can be contacted any day during the specified contact hours. Seller can be contacted Monday through Friday during the specified contact hours. Seller can be contacted Saturday or Sunday during the specified contact hours. (out) Reserved for internal or future use. This type is used by the DeliveryDetails container that is returned by GetOrders and other order management calls. The DeliveryDetails container is only applicable and returned if the buyer purchased a digital gift card, and is either keeping the gift card or giving that gift card to another person. This container consists of the name and email of the person who is receiving the digital gift card. If the buyer has purchased the gift card for themselves, the buyer's name and email will appear in this container. If the buyer is giving the gift card to another individual, that individual's name and email will appear in this container. This container is always returned for a digital gift card line item. For GetOrders and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this container will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, real data is only returned to the buyer or seller, and dummy/masked data will be returned to all third parties. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This container consists of the name and email of the person who purchased the digital gift card. This container is only returned if the purchaser of the digital gift card is giving the gift card to someone else, and that individual's name and email will appear in the Recipient container. For GetOrders and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this container will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, real data is only returned to the buyer or seller, and dummy/masked data will be returned to all third parties. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This enumeration type lists the possible delivery methods of a digital gift card. Currently, the only supported delivery method is by email. This value indicates that the link to download the digital gift card will be delivered to the recipient by email. This value is reserved for internal or future use. This enumeration type lists the possible delivery status values of a digital gift card. Currently, the only supported delivery status value is 'Notified', which indicates that the link to download the digital gift card has been sent to the recipient by email. This value indicates that the link to download the digital gift card has been sent to the recipient by email. This value is reserved for internal or future use. This type is used by the DeliveryStatus container, which will list the current status of whatever delivery method is being used (indicated in the DigitalDeliverySelected.DeliveryMethod field). Currently, the only supported delivery method is by email. This value indicates the current delivery status for the digital gift card that is being delivered by email. Currently, the only supported delivery status value is 'Notified', which indicates that the link to download the digital gift card has been sent to the recipient by email. DeliveryStatusEmailCodeType GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Defines settings for a notification URL (including the URL name in DeliveryURLName). The name of a notification delivery URL. You can list up to 25 instances of DeliveryURLName, and then subscribe these URLs to notifications by listing them in comma- separated format in the DeliveryURLName element outside of ApplicationDeliveryPreferences. GetNotificationPreferences Conditionally SetNotificationPreferences No The address of a notification delivery URL. This address applies to the DeliveryURLName within the same ApplicationDeliveryPreferences.DeliveryURLDetails container. For delivery to a server, the URL must begin with "<code>https://</code>" and must be well formed. Use a URL that is functional at the time of the call. SetNotificationPreferences No GetNotificationPreferences Conditionally The status of a notification delivery URL. This status applies to the DeliveryURLName and delivery URL within the same ApplicationDeliveryPreferences.DeliveryURLDetails container. If the status is disabled, then notifications will not be sent to the delivery URL. GetNotificationPreferences Conditionally SetNotificationPreferences No If present, the site defines category settings for whether the seller can specify a vehicle deposit for US eBay Motors listings. This enumerated type is a list of applicable values that indicate how a motor vehicle deposit should be paid. FastDeposit This value indicates that no deposit is required. This value indicates that a deposit is required from the buyer when purchasing a motor vehicle. Deposits for a motor vehicle are either due in 24, 48, or 72 hours after commitment to purchase. Or, in the case of a motor vehicle listing that is requiring immediate payment, the deposit it due immediately after commitment to purchase. This value should be used in an Add/Revise call if the seller is requiring a deposit for a motor vehicle listing. (out) No longer used. (out) Reserved for internal or future use Note: This field should no longer be used since it no longer supports the ability to append or prepend text using the Append or Prepend values, but only supports the Replace value. If this field is used and set to Append or Prepend, it will default to Replace, and whatever text is supplied in the Item.Description field will completely overwrite the current description for the active listing. If you wish to update the description for an active listing using a revise call, just provide the full description in the Item.Description field and do not use this field at all. This field will be completely removed from the WSDL within a few months. Enumerated type containing the list of values that can be used when revising the item description of an active listing through the Revise API calls. Use this value in the Item.DescriptionReviseMode field if you want to completely replace (overwrite) the item description of the active listing. Note: This enumerated value has been deprecated. Note: This enumerated value has been deprecated. Note: This enumerated value has been deprecated. Enumerated type that defines Listing Designer template types. This value indicates that the Listing Designer template is a layout template that controls how pictures and description text are positioned on the View Item page. This value indicates that the Listing Designer template is a theme template that determines which eBay-provided theme (e.g. Valentine's Day) is to be applied for presenting pictures and description text. Reserved for future use. Type that provides detailed information on a Listing Designer Theme or Layout. This integer value is a unique identifier for the Listing Designer Theme group, such as Holiday/Seasonal, Special Events, or Patterns/Textures. This field is not applicable and will not be returned for a Listing Designer Layout. GetDescriptionTemplates Conditionally This integer value is a unique identifier of the Listing Designer Theme or Layout. GetDescriptionTemplates Always This URL is the path to a small image providing a sample of the appearance of a Listing Designer Theme or Layout. GetDescriptionTemplates Always This string value is the name of the Listing Designer Theme or Layout. GetDescriptionTemplates Always This string value is actually a CDATA representation of the Listing Designer template. Image-related elements in a template include <code>ThemeTop</code>, <code>ThemeUserCellTop</code>, <code>ThemeUserContent,</code>, <code>ThemeUserCellBottom</code>, and <code>ThemeBottom</code>. This field is not applicable and will not be returned for a Listing Designer Layout. GetDescriptionTemplates Conditionally This enumeration value indicates that the information returned under the DescriptionTemplate container is related to a Listing Designer Theme or Layout. GetDescriptionTemplates Always This enumerated type contains all data filters that can be used to control which metadata is returned in the response of a GeteBayDetails call. The user can use as little or as many values as desired. If none of these data filters are used, all applicable metadata will be returned. UnitOfMeasurementDetails This enumeration value can be included in a DetailName field if the user wishes to retrieve the two-digit country codes for all countries of the world. Among other things, the two-digit country codes can be used when a seller is creating a 'ship-to' and/or an 'exclude ship-to' location list. The same CountryDetails metadata will be returned regardless of the value that is passed into the X-EBAY-API-SITEID request header. This enumeration value can be included in a DetailName field if the user wishes to retrieve the three-digit currency codes for each country where the Trading API is supported. These three-digit currency codes are used when a seller is expressing a dollar value in Trading API calls. For example, the currencyID attribute value in the StartPrice field of an AddItem call. The same CurrencyDetails metadata will be returned regardless of the value that is passed into the X-EBAY-API-SITEID request header. This enumeration value can be included in a DetailName field if the user wishes to retrieve all payment methods that are accepted on the specified eBay site. Note that the accepted payment methods within an eBay site can vary by category and/or by listing format, so a user may also want to make a GetCategoryFeatures call to retrieve category-level payment method metadata. To retrieve the accepted payment methods for a specific category on a specific site with GetCategoryFeatures, the user specifies the listing category ID through the CategoryID, and sets the FeatureID value to <code>PaymentMethods</code>. This enumeration value can be included in a DetailName field if the user wishes to retrieve the local regions within the specified country. This enumeration value can be included in a DetailName field if the user wishes to retrieve the geographical regions and country codes that can be used when creating a 'ship-to' location list. This enumeration value can be included in a DetailName field if the user wishes to retrieve the domestic and international shipping service options available on the specified eBay site. The returned metadata on each available shipping service will include the full name of the shipping service option (including carrier name), the actual shipping service enumeration value that will be used in an AddItem call, the expected shipping time range, the package types that can be used for that shipping service, and whether the shipping service is for domestic or international shipping. In addition to this information, the seller will have to look for a value of <code>true</code> in the ValidForSellingFlow field. If the value in this field is <code>false</code>, it indicates that the shipping service is no longer available for shipping. This enumeration value can be included in a DetailName field if the user wishes to retrieve the eBay sites that are supported in Trading API calls. The SiteID values that are returned for each country are specified as an HTTP header if the seller wants to see site metadata returned for that particular site. The same SiteDetails metadata will be returned regardless of the value that is passed into the X-EBAY-API-SITEID request header. This enumeration value can be included in a DetailName field if the user wishes to retrieve the different tax jurisdictions (such as states or provinces) within the specified eBay site. The two-digit JurisdictionID codes that are returned are used when a seller is setting/configuring sales tax rates in a Sales Tax Table, or when creating a listing. For example, the SalesTax.SalesTaxState field of an AddItem call. Sales tax jurisdictions are only applicable to the US and Canada, so the TaxJurisdiction metadata will only be returned for these sites: <ul> <li>eBay US: SiteID <code>0</code></li> <li>eBay Motors (US): SiteID <code>100</code></li> <li>eBay Canada (English language): SiteID <code>2</code></li> <li>eBay Canada (French language): SiteID <code>210</code></li> </ul> This enumeration value can be included in a DetailName field if the user wishes to retrieve the different eBay URLs associated with the specified eBay site. This enumeration value can be included in a DetailName field if the user wishes to retrieve the names of the different global time zones. The returned information includes the number of hours that each time zone is either ahead or behind UTC time, and it also indicates if the time zone participates in 'Daylight Savings'. The same TimeZoneDetails metadata will be returned regardless of the value that is passed into the X-EBAY-API-SITEID request header, although the metadata text will be localized for that site's language. This enumeration value can be included in a DetailName field if the user wishes to retrieve the international regions and individual countries. The same RegionOfOriginDetails metadata will be returned regardless of the value that is passed into the X-EBAY-API-SITEID request header. This enumeration value can be included in a DetailName field if the user wishes to retrieve the handling time values (in number of business days) that the seller can set on a listing. The seller must ship an order line item within this time or risk getting a seller defect. For the US, the supported handling times are 0-3 days. Some listing categories support 'extended handling' time, and if this is the case, the handling times will be longer, and the ExtendedHandling field will be returned as <code>true</code>. This enumeration value can be included in a DetailName field if the user wishes to retrieve the maximum thresholds for Item Specifics in listings. These thresholds include the maximum number of item specifics that can be used for an item (or item variation), as well as the maximum number of characters that can be used for Item Specific names and values. This enumeration value is no longer applicable, and should not be used. This enumeration value can be included in a DetailName field if the user wishes to retrieve the shipping package types that are supported by the specified eBay site. A seller can also just use the ShippingServiceDetails filter, and the supported shipping package types for each shipping service option will be returned. Reserved for future use. This enumeration value can be included in a DetailName field if the user wishes to retrieve the shipping carriers supported by the specified eBay site for domestic and international shipping. This enumeration value can be included in a DetailName field if the user wishes to retrieve the minimum starting prices for each applicable listing format for the specified eBay site. The price input into the StartPrice field of an AddItem call must be at or above this minimum threshold value or the listing will be blocked. This enumeration value can be included in a DetailName field if the user wishes to retrieve the return policy values that can be passed in through the ReturnPolicy container of an Add/Revise/Relist API call (or in a Return business policy). These values include the return period, the 'Money back' options that the seller can make available to the buyers, and who pays for return shipping (Buyer or Seller). Note: As of September 2018, the GetCategoryFeatures call started returning category-level metadata for both domestic and international return policies. Due to this update, developers may want to consider using that call for return policy metadata instead, as the GeteBayDetails call only retrieves site-level metadata, and does not distinguish between domestic and international metadata. This enumeration value can be included in a DetailName field if the user wishes to retrieve the Buyer Requirement values that can be passed in through the BuyerRequirementDetails container of an Add/Revise/Relist API call. This enumeration value can be included in a DetailName field if the user wishes to retrieve the listing features/upgrades that are enabled or disabled for the specified site. This enumeration value can be included in a DetailName field if the user wishes to retrieve the maximum thresholds when using multiple-variation listings. This enumeration value can be included in a DetailName field if the user wishes to retrieve the geographical regions and individual countries that can be passed in to the ShippingDetails.ExcludeShipToLocation field in an Add/Revise/Relist API call. Multiple ShippingDetails.ExcludeShipToLocation can be used, and any region or country value that is passed in to one of these fields will exclude that region or country as a "ship-to" location. This enumeration value can be included in a DetailName field if the user wishes to retrieve details on a site's recoupment policy. This enumeration value can be included in a DetailName field if the user wishes to retrieve the shipping service categories (Standard, Expedited, Economy, etc.) supported for the site. This enumeration value can be included in a DetailName field if the user wishes to retrieve the appropriate text to insert into a product identifier field (EAN, ISBN, UPC, MPN/Brand) if eBay is prompting/expecting one of these fields in the call request, but the identifiers do not exist/apply for the product. The ProductDetails.ProductIdentifierUnavailableText field that is returned in the response will contain the actual text that should be passed into the relevant product identification fields when creating a listing. This enumerated type is a list of the systems used to deliver buyer/seller notifications. This enumeration value indicates that buyer/seller notifications will be delivered through the Platform Notifications system. This enumeration value indicates that buyer/seller notifications will be delivered through the SMS system to a wireless device. This enumeration value indicates that buyer/seller notifications will be delivered through the Client Alerts system. Reserved for internal or future use. This type is used by the DigitalDeliverySelected container that is returned by GetOrders and other order management calls. The DigitalDeliverySelected container is only applicable and returned if the buyer purchased a digital gift card for themselves, or is giving the digital gift card to someone else as a gift. This value indicates the method in which the digital gift card will be delivered to the buyer or to the person whom the purchaser is giving the digital gift card to. Currently, the only supported delivery method is by email. DeliveryMethodCodeType GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This container consists of the current status of whatever delivery method is being used (indicated in the DigitalDeliverySelected.DeliveryMethod field). Currently, the only supported delivery method is by email. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This container is returned by GetOrders and other order management calls to provide details on the recipient of a digital gift card that was purchased. The DeliveryDetails container is only returned if the buyer is buying a digital gift card and giving that gift card to another person. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This type is used to provide the name and email of both the purchaser of a digital gift card, and the recipient of the digital gift card. This field displays the actual name (not the eBay user ID) of the sender/purchaser of the digital gift card (applicable for the Sender container) or the actual name of the recipient of the digital gift card (applicable for the Recipient container). Both the sender and recipient name is provided by the purchaser of the digital gift card at time of purchase. For GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, real data is only returned to the buyer or seller, and a string value of <code>Unavailable</code> will be returned to all third parties. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This field displays the email address of the sender/purchaser of the digital gift card (applicable for the Sender container) or the email address of the recipient of the digital gift card (applicable for the Recipient container). Both the sender and recipient email address is provided by the purchaser of the digital gift card at time of purchase. For GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, real data is only returned to the buyer or seller, and a string value of <code>Unavailable</code> will be returned to all third parties. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Type defining the DigitalGoodDeliveryEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as DigitalGoodDeliveryEnabled is included as a FeatureID value in the call request or no FeatureID values are passed into the call request). The DigitalGoodDeliveryEnabled field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support digital gift card listings. To verify if a specific eBay site supports digital gift card listings (for most categories), look for a <code>true</code> value in the SiteDefaults.DigitalGoodDeliveryEnabled field. To verify if a specific category on a specific eBay site supports digital gift card listings, pass in a DigitalGoodDeliveryEnabled value in the request, and then look for a <code>true</code> value in the DigitalGoodDeliveryEnabled field of the corresponding Category node (match up the CategoryID values if more than one category ID was passed in the request). This type is used by the DigitalGoodInfo container, which is used in Add/Relist/Revise/Verify listing calls to designate the listing as a digital gift card listing. This field must be included in the request and set to <code>true</code> if the seller plans to list a digital gift card in a category that supports digital gift cards. To verify if a specific category on a specific eBay site supports digital gift card listings, use the <a href="https://developer.ebay.com/DevZone/XML/docs/Reference/eBay/GetCategoryFeatures.html">GetCategoryFeatures</a> call, passing in a CategoryID value and a DigitalGoodDeliveryEnabled value in the FeatureID field. Look for a <code>true</code> value in the DigitalGoodDeliveryEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem Conditionally This enumeration type lists the possible states of a purchased digital delivery card. This enumeration value indicates that the digital gift card has yet to be activated by the buyer or recipient of gift card. This enumeration value indicates that the digital gift card has been activated by the buyer or recipient of gift card. This enumeration value indicates that the digital gift card has been downloaded by the buyer or recipient of gift card. The next step would be to activate the gift card. This enumeration value indicates that the digital gift card has been deactivated. This value is reserved for internal or future use. This type is used by the DiscountDetail container, which is returned if a discount is applicable to an account entry. This container indicates the discount type and amount applied to an account entry. Note: The discount type will be shown for any account entry where a discount applies, but the discount amount will only be shown if the corresponding fee was deducted from a seller payout. GetAccount Conditionally This enumerated type is used by the seller to set the shipping discount type. Some of these shipping discount types apply to flat-rate shipping and others apply to calculated shipping. The cost to ship each item beyond the first item (where the item with the highest shipping cost is selected by eBay as the first item). Let's say the buyer purchases three items, each set to ship for $8, and the seller set EachAdditionalAmount to $6. The cost to ship three items would normally be $24, but since the seller specified $6, the total shipping cost would be $8 + $6 + $6, or $20. For flat shipping discount profile only. The amount by which to reduce the cost to ship each item beyond the first item (where the item with the highest shipping cost is selected by eBay as the first item). Let's say the buyer purchases three items, each set to ship for $8, and the seller set EachAdditionalAmountOff to $2. The cost to ship three items would normally be $24, but since the seller specified $2, the total shipping cost would be $24 - (two additional items x $2), or $20. For flat shipping discount profile only. The percentage by which to reduce the cost to ship each item beyond the first item (where the item with the highest shipping cost is selected by eBay as the first item). Let's say the buyer purchases three items, each set to ship for $8, and the seller set EachAdditionalPercentOff to 0.25. The cost to ship three items would normally be $24, but since the seller specified 0.25 ($2 out of 8), the total shipping cost would be $24 - (two additional items x $2), or $20. For flat rate shipping discount profile only. Shipping cost is the total of what it would cost to ship each item individually. This is simply a way to define how shipping is to be calculated--there is no discount for the buyer with this selection. For calculated shipping discount profile only. Shipping cost is based on the total weight of all individual items. This is simply a way to define how shipping is to be calculated--there is no discount for the buyer with this selection. For calculated shipping discount profile only. The amount of weight to subtract for each item beyond the first item before shipping costs are calculated. For example, there may be less packing material when the items are combined in one box than if they were shipped individually. Let's say the buyer purchases three items, each 10 oz. in weight, and the seller set WeightOff to 2 oz. The combined weight would be 30 oz., but since the seller specified 2 oz. off, the total weight for shipping cost calculation would be 30 oz. - (two additional items x 2 oz.), or 26 oz. For calculated shipping discount profile only. Shipping cost X applies if the total cost of items purchased is Y. For promotional discount only. Shipping cost X applies if the total number of items purchased is N. For promotional discount only. The shipping cost will not exceed this. For promotional discount only. Reserved for internal or future use. Using this container, a seller can supply original retail price and discount price for an item to clarify the discount treatment (also known as strike-through pricing). This only applies to fixed-price listings and auction listings with the Buy It Now option. This feature is available for large enterprise sellers via white list. A seller can provide discount treatment regardless of whether the listing includes a SKU. The actual retail price set by the manufacturer (OEM). eBay does not maintain or validate the OriginalRetailPrice supplied by the seller. OriginalRetailPrice should always be more than StartPrice. Compare the StartPrice/BuyItNowPrice to OriginalRetailPrice to determine the amount of savings to the buyer. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem ReviseItem RelistItem VerifyAddItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Minimum Advertised Price (MAP) is an agreement between suppliers (or manufacturers (OEM)) and the retailers (sellers) stipulating the lowest price an item is allowed to be advertised at. Sellers can offer prices below MAP by means of other discounts. This only applies to fixed-price listings and auction listings with the Buy It Now option. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem ReviseItem RelistItem VerifyAddItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally For MinimumAdvertisedPrice (MAP) listings only. A seller cannot show the actual discounted price on eBay's View Item page. Instead, the buyer can either click on a pop-up on eBay's View Item page, or the discount price will be shown during checkout. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem ReviseItem RelistItem VerifyAddItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Based on OriginalRetailPrice, MinimumAdvertisedPrice, and StartPrice values, eBay identifies whether the listing falls under MAP or STP (aka OriginalRetailPrice). GetItem returns this for items listed with one of these discount pricing treatments. GetSellerList returns the DiscountPriceInfo container. This field is not applicable for Add/Revise/Relist calls. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally false Used by the eBay UK and eBay Germany (DE) sites, this flag indicates that the discount price (specified as StartPrice) is the price for which the seller offered the same (or similar) item for sale on eBay within the previous 30 days. The discount price is always in reference to the seller's own price for the item. If this field is set to <code>true</code>, eBay displays 'Was' in the UK and 'Ursprunglich' in Germany, next to the discounted price of the item. In the event both SoldOffeBay and SoldOneBay fields are set to <code>true</code>, SoldOneBay takes precedence. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem ReviseItem RelistItem VerifyAddItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally false Used by the eBay UK and eBay Germany (DE) sites, this flag indicates that the discount price (specified as StartPrice) is the price for which the seller offered the same (or similar) item for sale on a Web site or offline store other than eBay in the previous 30 days. The discount price is always in reference to the seller's own price for the item. If this field is set to <code>true</code>, eBay displays 'Was*' in the UK and 'Ursprunglich*' in Germany, next to the discounted price of the item. In the event both SoldOffeBay and SoldOneBay fields are set to <code>true</code>, SoldOneBay takes precedence. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem ReviseItem RelistItem VerifyAddItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally false Applicable only if the item was specifically made for sale through dedicated eBay outlet pages (e.g., eBay Fashion Outlet). The comparison price is the price of a comparable product sold through non-outlet channels on eBay (or elsewhere), or not specifically made for the outlet. In fashion, a "comparable" product shares the same design, but is not considered an identical product. Some products are specifically made for outlets, and may have a different SKU than the "comparable" product. These made-for-outlet products may be manufactured in a different place, with different materials, or according to different specifications (i.e. different stitch pattern, seam reinforcement, button quality, etc.) AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem ReviseItem RelistItem VerifyAddItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Details of a flat or calculated shipping discount rule. Shipping Discount Rules can be set up through the SetShippingDiscountProfiles call or through My eBay. The unique eBay-created unique identifier for the shipping discount, assigned when the shipping discount rule is created. In a SetShippingDiscountProfiles call, <ul> <li>If the value of ModifyActionCode is set to <code>Add</code>, this field is not applicable and is ignored <li>If provided.</li> <li>If the value of Mod <li>IfyActionCode is set to <code>Update</code>, all fields of the modified rule must be provided, even if the values are not changing.</li> <li>If the value of ModifyActionCode is set to <code>Delete</code>, either the DiscountProfileID value or is DiscountProfileName value is required, the MappingDiscountProfileID is optional, and all other fields of the DiscountProfile container are ignored.</li> </ul> GetShippingDiscountProfiles Always SetShippingDiscountProfiles Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally The seller-provided title for the shipping discount rule. In a SetShippingDiscountProfiles call, <ul> <li>If the value of ModifyActionCode is set to <code>Add</code>, this field is ignored (if provided) if this is the first shipping discount rule being created, but this field is required if there is more than one existing shipping discount rule of that type (flat rate or calculated)</li> <li>If the value of ModifyActionCode is set to <code>Update</code>, all fields of the modified rule must be provided, even if the values are not changing</li> <li>If the value of ModifyActionCode is set to <code>Delete</code>, the DiscountProfileID is required, the MappingDiscountProfileID is optional, and all other fields of the DiscountProfile container are ignored</li> <li>If the value of ModifyActionCode is set to <code>Delete</code>, either the DiscountProfileID value or is DiscountProfileName value is required, the MappingDiscountProfileID is optional, and all other fields of the DiscountProfile container are ignored</li> </ul> GetShippingDiscountProfiles Conditionally SetShippingDiscountProfiles Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally The cost to ship each item beyond the first item (where the item with the highest shipping cost is selected by eBay as the first item). Let's say the buyer purchases three items, each set to ship for $8, and the seller set the EachAdditionalAmount to $6. The cost to ship three items would normally be $24, but since the seller specified $6, the total shipping cost would be $8 + $6 + $6, or $20. This field is only applicable for flat-rate shipping. GetShippingDiscountProfiles FlatShippingDiscount Conditionally SetShippingDiscountProfiles FlatShippingDiscount Conditionally GetItem FlatShippingDiscount InternationalFlatShippingDiscount

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally The amount by which to reduce the cost to ship each item beyond the first item (where the item with the highest shipping cost is selected by eBay as the first item). Let's say the buyer purchases three items, each set to ship for $8, and the seller set EachAdditionalAmountOff to $2. The cost to ship three items would normally be $24, but since the seller specified $2, the total shipping cost would be $24 - (two additional items x $2), or $20. This field is only applicable for flat-rate shipping. GetShippingDiscountProfiles FlatShippingDiscount Conditionally SetShippingDiscountProfiles FlatShippingDiscount Conditionally GetItem FlatShippingDiscount InternationalFlatShippingDiscount

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally The percentage by which to reduce the cost to ship each item beyond the first item (where the item with the highest shipping cost is selected by eBay as the first item). Let's say the buyer purchases three items, each set to ship for $8, and the seller set EachAdditionalPercentOff to 0.25. The cost to ship three items would normally be $24, but since the seller specified 0.25 ($2 out of $8), the total shipping cost would be $24 - (two additional items x $2), or $20. This field is only applicable for flat-rate shipping. GetShippingDiscountProfiles FlatShippingDiscount Conditionally SetShippingDiscountProfiles FlatShippingDiscount Conditionally GetItem FlatShippingDiscount InternationalFlatShippingDiscount

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally The amount of weight to subtract for each item beyond the first item before shipping costs are calculated. For example, there may be less packing material when the items are combined in one box than if they were shipped individually. Let's say the buyer purchases three items, each 10 oz. in weight, and the seller set WeightOff to 2 oz. The combined weight would be 30 oz., but since the seller specified 2 oz. off, the total weight for shipping cost calculation would be 30 oz. - (two additional items x 2 oz.), or 26 oz. This field is only applicable for calculated shipping. GetShippingDiscountProfiles CalculatedShippingDiscount Conditionally SetShippingDiscountProfiles CalculatedShippingDiscount Conditionally GetItem CalculatedShippingDiscount InternationalCalculatedShippingDiscount

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally For SetShippingDiscountProfiles, if MappedDiscountProfileID is omitted when ModifyActionCode is set to <code>Delete</code>, any listings currently using the profile identified by DiscountProfileID will have that profile removed. GetShippingDiscountProfiles CalculatedShippingDiscount Conditionally SetShippingDiscountProfiles CalculatedShippingDiscount Conditionally GetItem CalculatedShippingDiscount InternationalCalculatedShippingDiscount

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This enumerated type is used in the response of Add/Revise/Relist item calls to indicate if eBay has applied a Special offer or Promotional discount to the order line item. An offer that applies to a limited number of listings during the offering period. Example: "There is no insertion fee for up to 5 auctions when listing between 12/1 and 12/10." An offer that applies to an unlimited number of listings during the offering period. Example: "Get subtitle for $0.10 in Tech category when listing between 12/25 and 12/28. No limit to the number of items listed during this period." Reserved for future use The type is used to indicate the discount type and amount applied to an account entry. Note: The discount amount will only be shown if the corresponding fee was deducted from a seller payout. The value in this field indicates the type of discount applied to the corresponding account entry. GetAccount Conditionally The amount of the discount in the currency indicated in the currencyID attribute. Note: The discount amount will only be shown if the corresponding fee was deducted from a seller payout. GetAccount Conditionally Contains a seller's cut off time preferences for same day handling for item shipping. If the seller specifies a DispatchTimeMax value of <code>0</code> to indicate same-day handling for an item, the seller's shipping commitment depends on the value of CutoffTime for the eBay site on which the item is listed. For orders placed (and cleared payment received) before the indicated cut off time, the item must be shipped by the end of the current day. For orders completed on or after the cut off time, the item must be shipped by the end of the following day (excluding weekends and local holidays). Note: For sellers opted in to the feature that supports different order cutoff times for each business day, the order cutoff time is not applicable. This cutoff time cannot be changed with the SetUserPreferences call, and the value returned in the GetUserPreferences call may not be accurate if the seller has customized this cutoff time for one or more business days. In order for the seller to change and/or confirm the actual order cutoff times for same-day handling, that seller should go to Shipping Preferences in My eBay. CutoffTime has a default initial value for each eBay site, but you can use SetUserPreferences to override the default for individual sellers. The default value for most eBay sites is 2:00PM local time. Enter times in 30 minute increments from the top of the hour. That is, enter values either on the hour (:00) or 30 minutes past the hour (:30). Other values will be rounded down to the next closest 30 minute increment. Times entered should be local to the value provided for TimeZoneID. SetUserPreferences Conditionally GetUserPreferences Conditionally Same day handling https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-handling-same-day.html details about dispatch cut off times Details about the maximum number of business days required to ship an item to domestic buyers after receiving a cleared payment. Integer value that indicates the maximum number of business days that the eBay site allows as a seller's handling time. The clock starts ticking when the buyer pays for the order. This means that if a buyer pays for the order on a Wednesday, the seller would have to ship the item by the next day (Thursday) if the DispatchTimeMax value is set to <code>1</code>. Typical values for this field are 0, 1, 2, 3, 4, 5, 10, 15, or 20. A DispatchTimeMax value of <code>0</code> indicates same day handling for an item. In this case, the seller's handling time commitment depends on the order cut off time set in the seller's user preferences. This defaults to 2:00 PM local time on most eBay sites. For orders placed (and cleared payment received) before the local order cut off time, the item must be shipped by the end of the current day. For orders completed on or after the order cut off time, the item must be shipped by the end of the following day (excluding weekends and local holidays). Note: If a same day shipping carrier is selected, and the carrier delivers on one or both weekend days, sellers on the eBay US site are assumed to be open for business on the same days, and those days will be used when calculating total shipping time. If using GeteBayDetails specifically to return this value, the caller sets the DetailName field in the request to DispatchTimeMaxDetails. When creating, revising, or relisting an item, the seller cannot set the Item.DispatchTimeMax value higher than the value returned in this field. GeteBayDetails Conditionally Same day handling https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-handling-same-day.html details about dispatch cut off times Value and unit (e.g., 10 Days) for the maximum dispatch time. Useful for display purposes. GeteBayDetails Conditionally Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always A value of <code>true</code> indicates that the seller has specified a handling time of 4 business days or more (an exception handling time). Sellers should be aware that long handling times might adversely affect the buying decisions of potential customers. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always This enumerated type is deprecated, as the seller no longer has control over the 'Buy It Now' button displayed on a listing. This enumeration value was formerly used to display the "Pay Now" button regardless of the buyer's payment method. This enumeration value is deprecated. Reserved for internal or future use Type defining the unique identifier of a regulatory document associated with the listing. The unique identifier of a regulatory document associated with the listing. This value can be found in the response of the <a href = "/api-docs/commerce/media/resources/document/methods/createDocument" target="_blank">createDocument</a> method of the Media API. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally Type that provides an array of one or more regulatory documents associated with a listing for Regulatory Compliance. Note: As a part of General Product Safety Regulation (GPSR) requirements effective from December 13th, 2024, sellers operating in, or shipping to, EU-based countries or Northern Ireland are conditionally required to provide document information in their eBay listings. For more information on GPSR, see <a href = "https://www.ebay.com/sellercenter/resources/general-product-safety-regulation" target="_blank">General Product Safety Regulation (GPSR)</a>. A regulatory document associated with the listing. Regulatory documents can be created and uploaded using the <a href = "/api-docs/commerce/media/resources/document/methods/createDocument" target="_blank">createDocument</a> method of the Media API. A variety of document types can be provided for regulatory compliance. For a list of supported document types, see <a href = "/api-docs/commerce/media/types/api:DocumentTypeEnum" target="_blank">DocumentTypeEnum</a>. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally This type defines the available options the seller has for handling domestic returns. Defines the available options the seller has for handling domestic returns in the specified marketplace and category. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally On the EBAY_US marketplace only, sellers can offer item replacement in addition to offering money back returns. This flag defines the availability of such options for the given US marketplace category. Sellers can offer item replacements only if returns are enabled (returnPolicyEnabled is set to <code>true</code>) for the item. You can specify item replacement in the AddItem family of calls and in the return policy settings of the Account API. This type defines the available options the seller has for accepting domestic returns. Defines the available options the seller has for accepting domestic returns in the specified marketplace and category. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally The values returned in this field indicate whether or not the seller accepts domestic returns for items listed in the associated marketplace and category. While most categories return the ReturnsAccepted flag (indicating the category supports returns), some categories will also return the ReturnsNotAccepted flag to indicate the seller can choose to not accept returns for an item listed in that category. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated category, which indicates that items listed in the category must include a return policy. Here, it's worth noting that not accepting returns is a return policy. The values returned in this field are valid in AddItem and its related family of calls, and in the return policies you configure for use with the Account API. This type defines the available options for the return durations for domestic returns. Defines the available options for the return durations for domestic returns in the specified marketplace and category. This is the time the buyer has to initiate a return once they receive the item. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally The values returned in this field indicate the return-duration options that are available for domestic returns for items listed in the associated marketplace and category. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated category, which indicates that items listed in the category must include a return policy. The values returned in this field are valid in AddItem and its related family of calls, and in the return policies you configure for use with the Account API. This type defines the available options for who pays the return shipping costs for domestic returns. Defines the available options for who pays the return shipping costs for domestic returns in the specified marketplace and category. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally The values returned in this field indicate the available options for who pays the return shipping for domestic returns. Possible values are <code>BUYER</code> and <code>SELLER</code>. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated category, which indicates that items listed in the category must include a return policy. The values returned in this field are valid in AddItem and its related family of calls, and in the return policies you configure for use with the Account API. This type is deprecated. Type defining the EANEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as 'EANEnabled' is included as a FeatureID value in the call request or no FeatureID values are passed into the call request). This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the EAN product identifying feature. To verify if a specific eBay site supports the EAN product identifying feature (for most categories), look for a 'true' value in the SiteDefaults.EANEnabled field. To verify if a specific category on a specific eBay site supports the EAN product identifying feature, pass in a CategoryID value in the request, and then look for a 'true' value in the EANEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). This enumerated type contains a list of eBay subscriptions that an eBay user may be subscribed to. PictureManagerLevel1, PictureManagerLevel2, PictureManagerLevel3, PictureManagerLevel4, PictureManagerLevel5, PictureManagerLevel6, PictureManagerLevel7, SellerAssistant, SellerAssistantPro, SellerReportsBasic, SellingManager, SellingManagerPro This eBay subscription is no longer available. This eBay subscription is no longer available. This value indicates that the user has a Basic eBay Store membership. See the <a href="http://pages.ebay.com/sellerinformation/stores/Subscriptions.html" target="_blank">Welcome to eBay Stores</a> help page for more information on eBay Store subscriptions. This value indicates that the user has a Premium eBay Store membership. See the <a href="http://pages.ebay.com/sellerinformation/stores/Subscriptions.html" target="_blank">Welcome to eBay Stores</a> help page for more information on eBay Store subscriptions. This value indicates that the user has a Anchor eBay Store membership. See the <a href="http://pages.ebay.com/sellerinformation/stores/Subscriptions.html" target="_blank">Welcome to eBay Stores</a> help page for more information on eBay Store subscriptions. This enumeration value is deprecated. This enumeration value is deprecated. This value is no longer applicable because Picture Manager has been EOLed. This value is no longer applicable because Picture Manager has been EOLed. This value is no longer applicable because Picture Manager has been EOLed. This value is no longer applicable because Picture Manager has been EOLed. This value is no longer applicable because Picture Manager has been EOLed. This value is no longer applicable because Picture Manager has been EOLed. This value is no longer applicable because Picture Manager has been EOLed. Basic Sales Reports are no longer available. Sellers should subscribe to Sales Reports Plus instead. This value indicates that the user has a Sales Reports Plus subscription. A user can subscribe to Sales Report Plus through the Subscriptions section of My eBay. This value indicates that the user has opted in to Seller Hub Reports (formerly known as File Exchange). Users can opt in to Seller Hub Reports through the Reports section on Seller Hub. See the <a href="https://www.ebay.com/help/selling/selling-tools/file-exchange?id=4096" target="_blank">Seller Hub Reports</a> help page for more information. This value indicates that the Motors Dealer has a Local Market Specialty subscription. This type of account is used to sell in the Motorcycles, Powersports, and Other Vehicles and Trailers categories. Not Cars and Trucks. This value indicates that the Motors Dealer has a Local Market Regular subscription. This type of account is used to sell in all eBay Motors categories. This value indicates that the Motors Dealer has a Local Market Premium subscription. This type of account is used to sell in all eBay Motors categories. This enumeration type is used to indicate whether an application/URL/device is enabled to receive notifications, or to indicate whether a specific notification event is enabled. This enumeration value indicates that an application/URL/device is enabled to receive notifications, or to indicate that a specific notification event is enabled. This enumeration value indicates that an application/URL/device is disabled, or being blocked from receiving notifications, or to indicate that a specific notification event is disabled. Reserved for future use. A container to specify a single eBay item to end. The unique identifier of the eBay listing to end. EndItems Yes The seller's reason for ending the listing early is input into this required field. The seller is not allowed to use the <code>ProductDeleted</code> value, as this ending reason can only be used internally by eBay to administratively end a listing due to the associated Catalog product being removed from the eBay Catalog. EndItems Yes ProductDeleted Most Trading API calls support a MessageID element in the request and a CorrelationID element in the response. With EndItems, the seller can pass in a different MessageID value for each EndItemRequestContainer container that is used in the request. The CorrelationID value returned under each EndItemResponseContainer container is used to correlate each End Item request container with its corresponding End Item response container. The same MessageID value that you pass into a request will be returned in the CorrelationID field in the response. If you do not pass in a MessageID value in the request, CorrelationID is not returned. EndItems No This type includes the acknowledgement of the date and time when an eBay listing was ended due to the call to EndItems. This timestamp indicates the date and time (returned in GMT) when the specified eBay listing was ended. EndItem EndItems Always Most Trading API calls support a MessageID element in the request and a CorrelationID element in the response. With EndItems, the seller can pass in a different MessageID value for each EndItemRequestContainer container that is used in the request. The CorrelationID value returned under each EndItemResponseContainer container is used to correlate each End Item request container with its corresponding End Item response container. The same MessageID value that you pass into a request will be returned in the CorrelationID field in the response. If you do not pass in a MessageID value in the request, CorrelationID is not returned. EndItems Conditionally A list of application-level errors or warnings (if any) that were raised when eBay processed the request. Application-level errors occur due to problems with business-level data on the client side or on the eBay server side. For example, an error would occur if the request contains an invalid combination of fields, or it is missing a required field, or the value of the field is not recognized. An error could also occur if eBay encountered a problem in our internal business logic while processing the request. Only returned if there were warnings or errors. Conditionally Contains the seller's preferences for the email that can be sent to the winner of an auction listing. The seller can customize the text of the email that is sent to the winner of an auction listing. The text of the email is provided in this field. If the seller is going to customize the text of the email through this field, the seller must also include the TextCustomized field and set its value to <code>true</code>.The text of the custom message for the email. This field is only returned if set for the account. 3948 GetUserPreferences Conditionally SetUserPreferences No The seller can include a customized logo in the email that is sent to the winner of an auction listing. The full URI to this logo image should be applied in this field. If the seller is going to include a customized logo in the email through this field, the seller must also include the LogoCustomized field and set its value to <code>true</code>, and include the LogoType field and set its value to <code>Customized</code>. This field is only returned if a customized logo is being used for the customized email. GetUserPreferences Conditionally SetUserPreferences No This field is needed in the SetUserPreferences call if the seller would like to use a customized or eBay Store logo. If the seller would like to use a customized logo, this field's value will be set to <code>Customized</code>. If the seller would like to use their eBay Store logo (if it exists), this field's value will be set to <code>Store</code>. This field is always returned, and its value will be <code>None</code> if no logo is used in the customized email. GetUserPreferences Always SetUserPreferences None Conditionally This field is used in a SetUserPreferences call to set/change the setting of whether a customized email will be sent to the winning bidder or not. This field is always returned to indicate whether or not a customized email will be sent to the winning bidder. GetUserPreferences Always SetUserPreferences No This field is used in a SetUserPreferences call to set/change the setting of whether customized text will be used or not in the customized email that is sent to the winning bidder. Customized text is provided through the LogoURL field. This field is always returned to indicate whether or not customized text is used in a customized email that is sent to the winning bidder. GetUserPreferences Conditionally SetUserPreferences No This field is used in a SetUserPreferences call to set/change the setting of whether a customized logo will be used or not in the customized email that is sent to the winning bidder. The URI to a customized logo is provided through the TemplateText field. If the seller would like to use a customized logo, the LogoType field must also be included, and its value will be set to <code>Customized</code>. This field is always returned to indicate whether or not a customized logo is used in a customized email that is sent to the winning bidder. GetUserPreferences Conditionally SetUserPreferences No This field is deprecated. 889 NoOp 993 This enumeration type is used to indicate the type of logo that will be included in the customized email that will be sent by the seller to the winning bidder in an auction listing. This enumeration value indicates that the Winning Bidder Notice logo will be used in the end of auction email to winning bidder. This enumeration value indicates that the eBay seller's Store logo will be used in the end of auction email to winning bidder. This enumeration value indicates that a custom logo will be used in the end of auction email to winning bidder. The location (URL) of this custom logo can be given through the LogoURL field of the SetUserPreferences call. Just like any URL that is provided through eBay API calls, the URL for the custom logo must use 'https' (and not 'http'). Reserved for internal or future use. This enumeration value indicates that no logo will be used in the end of auction email to winning bidder. This type defines the reasons that a seller can end an item listing early. This value is required if the seller ends a listing early. This can be on an item that hasn't sold and has no bids or on an item that has bids and the seller wants to sell the item to the high bidder now. Use this enumeration value in an End listing call if the seller is ending a listing because the item was lost or is broken. Use this enumeration value in an End listing call if the seller is ending a listing because the item is no longer available for sale. Use this enumeration value in an End listing call if the seller is ending a listing because the start price or reserve price is incorrect. Use this enumeration value in an End listing call if the seller is ending a listing because the listing contained an error (other than start price or reserve price). Reserved for internal or future use. Use this enumeration value in an End listing call if the seller is ending a listing because they want to sell an auction item to the current high bidder. A seller can end a listing early in order to sell to the current high bidder when the listing has qualifying bids (i.e., there is a current high bid that, when applicable, meets the minimum reserve price) and there is more than 12 hours before the listing ends. Note: In the last 12 hours of an item listing, you cannot end an item early if it has bids. The vehicle was sold. Applies to local classified listings for vehicles only. For internal use only. This enumeration value cannot be used by the seller in an End listing call, but it will get returned in GetItem if a listing was administratively ended by eBay if the item in a listing becomes unpurchasable due to the eBay Catalog product associated with the listing being removed from the catalog. Type defining the ImageURL, ImageDescription, and ProductInformationsheet regulatory fields that are used at the listing level to provide Energy Efficiency Label related information. Important: When providing energy efficiency information on an appliance or smartphones and tablets listing, the energy efficiency rating and range of the item must be specified through the <a href = "/devzone/xml/docs/reference/ebay/additem.html#Request.Item.ItemSpecifics" target="_blank">ItemSpecifics</a> container. Use the <a href = "/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory" target="_blank">getItemAspectsForCategory</a> method of the Taxonomy API to retrieve applicable rating and range values for a specified category. The URL to the Energy Efficiency Label image that is applicable to an item. This field is required if an Energy Efficiency Label is provided. The URL provided must be an eBay Picture Services (EPS) URL only. You can upload pictures to eBay Picture Services via the UploadSiteHostedPictures call. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally A brief verbal summary of the information included on the Energy Efficiency Label for an item. For example, On a scale of A to G the rating is E. As with all strings, you need to escape reserved characters such as ampersand. This field is required if an Energy Efficiency Label is provided. 280 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally The URL to the Product Information Sheet that provides complete manufacturer-provided efficiency information about an item. This field is required if an Energy Efficiency Label is provided. The URL provided must be an eBay Picture Services (EPS) URL only. You can upload pictures to eBay Picture Services via the UploadSiteHostedPictures call. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally Type defining the EpidSupported field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as EpidSupported is included as a FeatureID value in the call request, or no FeatureID values are passed into the call request). The EpidSupported field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support specifying parts compatibility through an eBay product ID (ePID). At this time, this feature is only supported for motorcycle and scooter listings on the Germany and UK sites. To verify if a specific category supports specifying parts compatibility through an ePID, pass in a EpidSupported value in the request, and then look for a <code>true</code> value in the EpidSupported field of the corresponding Category node (match up the CategoryID values if more than one category ID was passed in the request). Type used by the ExcludeShippingLocationDetails containers that are returned in the GeteBayDetails response. The values returned in the ExcludeShippingLocationDetails.Location fields are the values that can be specified when specifying excluded shipping locations in an Add/Revise/Relist item call, or in a shipping business policy. The localized location name. GeteBayDetails Conditionally The location or region code to be used with the AddItem family of calls. These codes are also returned by GetItem. This code reflects the <a href= "http://www.iso.org/iso/country_codes/iso_3166_code_lists/english_country_names_and_code_elements.htm" >ISO 3166</a> codes. GeteBayDetails Conditionally The region code to which the location belongs. GeteBayDetails Conditionally Returns the current version number of the ExcludeShippingLocation data. Use the version number to determine if you need to refresh your cached client data. GeteBayDetails Conditionally The time in GMT that the feature flags for the details were last updated. Use this timestamp to determine if you need to refresh your cached client data. GeteBayDetails Conditionally This type is deprecated. 579 681 NoOp This type is deprecated. 579 681 NoOp This type is deprecated. 579 681 NoOp This type is used to provide contact hours for a seller of a Classified Ad listing, including motor vehicles. There is also a boolean field in this type that indicates whether or not potential buyer can contact the seller by email. This containers consists of fields that allows the seller of a Classified Ad listing to tell potential buyers what days and times they may be contacted to inquire about the listing. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally A value of <code>true</code> in this field indicates that potential buyers can contact the seller of the Classified Ad listing by email. AddItem AddItems ReviseItem VerifyAddItem RelistItem VerifyRelistItem No GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This type is used by the ExtendedPictureDetails container, which is no longer returned under any circumstances, including when self-hosted pictures are used for the item. When self-hosted pictures are used by the seller, only the external URL of the gallery image is shown in the PictureDetails.ExternalPictureURL field, and only the equivalent eBay Picture Server (EPS) URLs are shown for the rest of the item's images in separate PictureDetails.PictureURL fields. The ExtendedPictureDetails container and its child fields are no longer returned under any circumstances, including when self-hosted pictures are used for the item. When self-hosted pictures are used by the seller, only the external URL of the gallery image is shown in the PictureDetails.ExternalPictureURL field, and only the equivalent eBay Picture Server (EPS) URLs are shown for the rest of the item's images in separate PictureDetails.PictureURL fields. 1375 NotReturned PictureDetails.ExternalPictureURL GetItem Conditionally This type is used by the ExtendedProducerResponsibility container, which provides IDs for the producer or importer related to the new item, packaging, added documentation, or an eco-participation fee. In some markets, such as in France, this may be the importer of the item. For more information, see the Extended Producer Responsibility for business sellers page for your site (for example, <a href="https://www.ebay.com/help/selling/all-about-selling/selling-internationally/extended-producer-responsibility-for-business-sellers?id=5314" target="_blank">https://www.ebay.com/help/selling/all-about-selling/selling-internationally/extended-producer-responsibility-for-business-sellers?id=5314</a>). For GetItem calls, this container is only returned to the listing owner, if the container is available. This is the fee paid for new items to the eco-organization (for example, "eco-organisme" in France). It is a contribution to the financing of the elimination of the item responsibly. For multiple-variation listings, the EcoParticipationFee in the VariationExtendedProducerResponsibility container is used for each variation in the listing, and not the EcoParticipationFee in the ExtendedProducerResponsibility container. 16 0.0 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This type is used by the FeatureDefinitions container that is returned in the GetCategoryFeatures response to indicate which eBay features are available on one more eBay marketplaces. If no FeatureID field is included in the call request, all eBay features available for one more eBay marketplaces are returned. If one or more FeatureID fields are included in the call request, only those eBay features specified in each FeatureID field are returned in the response. ProductCreationEnabled This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support multiple listing durations. Listing durations will vary based on the selling format (auction, fixed-price, or classified ad) and the eBay category. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ListingDurations</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces require shipping terms at listing time, which includes at least one domestic shipping service option and its associated costs. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ShippingTermsRequired</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the Best Offer feature. The Best Offer feature allows buyers and sellers to negotiate the price of the item. This field will not be returned if one or more FeatureID fields are included in the call request and <code>BestOfferEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is no longer applicable as Dutch auctions are no longer supported on any eBay marketplace. This field is deprecated. This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the temporary display of a seller's listing on a section of the eBay Home Page. This field will not be returned if one or more FeatureID fields are included in the call request and <code>HomePageFeaturedEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the Pro Pack listing upgrade bundle. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ProPackEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is deprecated. This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the Value Pack listing upgrade bundle. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ValuePackEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the Pro Pack Plus listing upgrade bundle. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ProPackPlusEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support Classified Ad listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>AdFormatEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support counter offers to Best Offers. The Best Offer feature allows buyers and sellers to negotiate the price of the item, and once a Best Offer price is proposed, the seller can send the buyer a counter offer, and a buyer may even send another counter offer to the seller's counter offer. This field will not be returned if one or more FeatureID fields are included in the call request and <code>BestOfferCounterEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the Best Offer Auto-Decline feature. The Best Offer Auto-Decline feature allows a seller to set a lower threshold dollar value on a listing, and any Best Offer amount below this amount is automatically declined by the eBay system. This field will not be returned if one or more FeatureID fields are included in the call request and <code>BestOfferAutoDeclineEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support Motors Local Market listings for dealership subscribers with a specialty subscription. This field will not be returned if one or more FeatureID fields are included in the call request and <code>LocalMarketSpecialitySubscription</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally TThis field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support Motors Local Market listings for dealership subscribers with a regular subscription. This field will not be returned if one or more FeatureID fields are included in the call request and <code>LocalMarketRegularSubscription</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support Motors Local Market listings for dealership subscribers with a premium subscription. This field will not be returned if one or more FeatureID fields are included in the call request and <code>LocalMarketPremiumSubscription</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support Motors Local Market listings for dealerships without a subscription. This field will not be returned if one or more FeatureID fields are included in the call request and <code>LocalMarketNonSubscription</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is deprecated. 579 681 NoOp This field is deprecated. 579 681 NoOp This field is deprecated. 579 681 NoOp This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces require a minimum reserve price for an auction item. This feature is only applicable to auction listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>MinimumReservePrice</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is deprecated. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces allow the seller to provide contact information at listing time for a classified ad listing. This feature is only applicable to classified ad listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>SellerContactDetailsEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is deprecated. This field is deprecated. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is deprecated. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support allow dealership subscribers with a regular subscription to specify local market radius for Motors Local Market listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>LocalListingDistancesRegular</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces allow dealership subscribers with a specialty subscription to specify local market radius for Motors Local Market listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>LocalListingDistancesSpecialty</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces allow dealership subscribers without a subscription to specify local market radius for Motors Local Market listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>LocalListingDistancesNonSubscription</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces allow for the display of acceptable payment methods for classified ad listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ClassifiedAdPaymentMethodEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces allow for the display of shipping service options for classified ad listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ClassifiedAdShippingMethodEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the Best Offer feature for classified ad listings. The Best Offer feature allows buyers and sellers to negotiate the price of the item. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ClassifiedAdBestOfferEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support counter offers to Best Offers for classified ad listings. The Best Offer feature allows buyers and sellers to negotiate the price of the item, and once a Best Offer price is proposed, the seller can send the buyer a counter offer, and a buyer may even send another counter offer to the seller's counter offer. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ClassifiedAdCounterOfferEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the Best Offer Auto-Decline feature for classified ad listings. The Best Offer Auto-Decline feature allows a seller to set a lower threshold dollar value on a listing, and any Best Offer amount below this amount is automatically declined by the eBay system. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ClassifiedAdAutoDeclineEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of a phone number when contacting the seller about a classified ad listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ClassifiedAdContactByPhoneEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of an email address when contacting the seller about a classified ad listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ClassifiedAdContactByEmailEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally eBay controls all forms of electronic payment methods that are avaialable to buyers, so this field is no longer applicable. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is deprecated. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of Item Specifics in listings. Item Specifics are typical aspects that items in a specific category tend to have, and they allow sellers to provide descriptive details of an item in a structured manner. For example, in a jewelry category, sellers might describe lockets with Item Specifics name-value pairs like "Chain Length=18 in." and "Main Shape=Heart", or in a Washers & Dryers category, sellers might include "Type=Top-Loading". This field will not be returned if one or more FeatureID fields are included in the call request and <code>ItemSpecificsEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally PaisaPay is a deprecated payment method, so this field is no longer applicable. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of Brand and MPN (Manufacturer Part Number) to identify a product. This field will not be returned if one or more FeatureID fields are included in the call request and <code>BrandMPNIdentifierEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the Best Offer Auto-Accept feature. The Best Offer Auto-Accept feature allows a seller to set a threshold dollar value on a listing, and any Best Offer amount at or above this amount is automatically accepted by the eBay system. This field will not be returned if one or more FeatureID fields are included in the call request and <code>BestOfferAutoAcceptEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the Best Offer Auto-Accept feature for classified ad listings. The Best Offer Auto-Accept feature allows a seller to set a threshold dollar value on a listing, and any Best Offer amount at or above this amount is automatically accepted by the eBay system. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ClassifiedAdAutoAcceptEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support cross-border trading on the US and CA (English) sites. In cross-border trading, also referred to as International site visibility, a seller is able to post a listing to an additional eBay site for an additional small fee. This field will not be returned if one or more FeatureID fields are included in the call request and <code>CrossBorderTradeNorthAmericaEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support cross-border trading on the UK and Ireland sites. In cross-border trading, also referred to as International site visibility, a seller is able to post a listing to an additional eBay site for an additional small fee. This field will not be returned if one or more FeatureID fields are included in the call request and <code>CrossBorderTradeGBEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is for future use, as cross-border trading (aka International site visibility) is not currently supported for Australia. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is deprecated. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is deprecated. This field is deprecated. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally PaisaPay is a deprecated payment method, so this field is no longer applicable. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support motor vehicle classified ad listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>eBayMotorsProAdFormatEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of a phone number when contacting the seller about a motor vehicle classified ad listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>eBayMotorsProContactByPhoneEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of multiple phone numbers for the seller for a motor vehicle classified ad listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>eBayMotorsProContactByPhoneEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally TThis field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of an address when contacting the seller about a motor vehicle classified ad listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>eBayMotorsProContactByAddressEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of multiple street address for the seller for a motor vehicle classified ad listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>eBayMotorsProContactByAddressEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of a company name when contacting the seller about a motor vehicle classified ad listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>eBayMotorsProCompanyNameEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of an email address when contacting the seller about a motor vehicle classified ad listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>eBayMotorsProContactByEmailEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the Best Offer feature is for motor vehicle classified ad listings. The Best Offer feature allows buyers and sellers to negotiate the price of the item. This field will not be returned if one or more FeatureID fields are included in the call request and <code>eBayMotorsProBestOfferEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the Best Offer Auto-Accept feature for motor vehicle classified ad listings. The Best Offer Auto-Accept feature allows a seller to set a threshold dollar value on a listing, and any Best Offer amount at or above this amount is automatically accepted by the eBay system. This field will not be returned if one or more FeatureID fields are included in the call request and <code>eBayMotorsProAutoAcceptEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the Best Offer Auto-Decline feature for motor vehicle classified ad listings. The Best Offer Auto-Decline feature allows a seller to set a lower threshold dollar value on a listing, and any Best Offer amount below this amount is automatically declined by the eBay system. This field will not be returned if one or more FeatureID fields are included in the call request and <code>eBayMotorsProAutoDeclineEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces allow for the display of acceptable payment methods for motor vehicle classified ad listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>eBayMotorsProPaymentMethodCheckOutEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces allow for the display of shipping service options for motor vehicle classified ad listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>eBayMotorsProShippingMethodEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support counter offers to Best Offers for motor vehicle classified ad listings. The Best Offer feature allows buyers and sellers to negotiate the price of the item, and once a Best Offer price is proposed, the seller can send the buyer a counter offer, and a buyer may even send another counter offer to the seller's counter offer. This field will not be returned if one or more FeatureID fields are included in the call request and <code>eBayMotorsProCounterOfferEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces allow the seller to provide contact information at listing time for a motor vehicle classified ad listing. This feature is only applicable to motor vehicle classified ad listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>eBayMotorsProSellerContactDetailsEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support Motors Local Market listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>LocalMarketAdFormatEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces allow the use of a phone number when contacting the seller about a Motors Local Market listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>LocalMarketContactByPhoneEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces allow the use of multiple phone numbers for the seller for a Motors Local Market listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>LocalMarketPhoneCount</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces allow the use of an address when contacting the seller about a Motors Local Market listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>LocalMarketContactByAddressEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces allow the use of multiple street address for the seller for a Motors Local Market listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>LocalMarketStreetCount</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of a company name when contacting the seller about a Motors Local Market listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>LocalMarketCompanyNameEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of an email address when contacting the seller about a Motors Local Market listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>LocalMarketContactByEmailEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the Best Offer feature is for Motors Local Market listings. The Best Offer feature allows buyers and sellers to negotiate the price of the item. This field will not be returned if one or more FeatureID fields are included in the call request and <code>LocalMarketBestOfferEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the Best Offer Auto-Accept feature for Motors Local Market listings. The Best Offer Auto-Accept feature allows a seller to set a threshold dollar value on a listing, and any Best Offer amount at or above this amount is automatically accepted by the eBay system. This field will not be returned if one or more FeatureID fields are included in the call request and <code>LocalMarketAutoAcceptEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the Best Offer Auto-Decline feature for Motors Local Market listings. The Best Offer Auto-Accept feature allows a seller to set a threshold dollar value on a listing, and any Best Offer amount at or above this amount is automatically accepted by the eBay system. This field will not be returned if one or more FeatureID fields are included in the call request and <code>LocalMarketAutoDeclineEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces allow for the display of acceptable payment methods for Motors Local Market listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>LocalMarketPaymentMethodCheckOutEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces allow for the display of shipping service options for Motors Local Market listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>LocalMarketShippingMethodEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support counter offers to Best Offers for Motors Local Market listings. The Best Offer feature allows buyers and sellers to negotiate the price of the item, and once a Best Offer price is proposed, the seller can send the buyer a counter offer, and a buyer may even send another counter offer to the seller's counter offer. This field will not be returned if one or more FeatureID fields are included in the call request and <code>LocalMarketCounterOfferEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces allow the seller to provide contact information at listing time for Motors Local Market listings. This feature is only applicable to motor vehicle classified ad listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>LocalMarketSellerContactDetailsEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of multiple phone numbers for the seller for a classified ad listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ClassifiedAdPhoneCount</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of an address when contacting the seller about a classified ad listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ClassifiedAdContactByAddressEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of multiple street addresses for the seller for a classified ad listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ClassifiedAdStreetCount</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of a company name when contacting the seller about a classified ad listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ClassifiedAdCompanyNameEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is deprecated. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is deprecated. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is deprecated. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is deprecated. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of return policies in listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ReturnPolicyEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of a stated handling time in listings. The handling time is the maximum number of business days the seller commits to for preparing an item to be shipped after receiving a cleared payment. The seller's handling time does not include the shipping time (the carrier's transit time). This field will not be returned if one or more FeatureID fields are included in the call request and <code>HandlingTimeEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is deprecated. This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces allow the quantity of a listing to be revised during the life of the listing. This feature is not applicable to auction listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ReviseQuantityAllowed</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces allow the price of a listing to be revised during the life of the listing. This feature is not applicable to auction listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>RevisePriceAllowed</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support extended listing durations for eBay Business Sellers with eBay Stores. This field will not be returned if one or more FeatureID fields are included in the call request and <code>RevisePriceAllowed</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is deprecated. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces allow for the display of acceptable payment methods in listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>PaymentMethod</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. Note: eBay now controls all electronic payment methods available to buyers, but sellers still need to specify offline payment methods for listings that require/support offline payment such as motor vehicle listings. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces allow for the applicable max cap per shipping cost for shipping service group1. This field will not be returned if one or more FeatureID fields are included in the call request and <code>Group1MaxFlatShippingCost</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces allow for the applicable max cap per shipping cost for shipping service group2. This field will not be returned if one or more FeatureID fields are included in the call request and <code>Group2MaxFlatShippingCost</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally TThis field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces allow for the applicable max cap per shipping cost for shipping service group3. This field will not be returned if one or more FeatureID fields are included in the call request and <code>Group3MaxFlatShippingCost</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces do not impose a maximum flat-rate shipping cost if the item is being shipped internationally. This field will not be returned if one or more FeatureID fields are included in the call request and <code>MaxFlatShippingCostCBTExempt</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces do not impose a maximum flat-rate shipping cost. This field will not be returned if one or more FeatureID fields are included in the call request and <code>MaxFlatShippingCost</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support multiple-variation listings for some categories. Multiple-variation listings contain items that are logically the same product, but that vary in color, size, or other aspect. For example, a particular brand and style of shirt could be available in different sizes and colors, such as "large blue" and "medium black" variations. This feature is only applicable to fixed-price listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>VariationsEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is deprecated. This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support free, automatic upgrades for Gallery Plus for some categories. This field will not be returned if one or more FeatureID fields are included in the call request and <code>FreeGalleryPlusEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support a free Picture Pack upgrade for some categories. This field will not be returned if one or more FeatureID fields are included in the call request and <code>FreePicturePackEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support Parts Compatibility for some Parts & Accessories categories. Parts compatibility allows a seller to show a list of all the vehicles that a part or accessory is compatible with in a listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ItemCompatibilityEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces define a maximum limit for the number of compatible applications for items listed with parts compatibilities by application. Parts compatibility allows a seller to show a list of all the vehicles that a part or accessory is compatible with in a listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>MaxItemCompatibility</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces define a minimum amount for the number of compatible applications for items listed with parts compatibilities by application. Parts compatibility allows a seller to show a list of all the vehicles that a part or accessory is compatible with in a listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>MinItemCompatibility</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the textual description of an item's condition at listing time. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ConditionEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support Condition IDs to specify an item's condition at listing time. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ConditionValues</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support value categories. A Value category will typically have lower listing fees or another eBay promotion. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ValueCategory</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is no longer applicable. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the EAN product identifying feature. This field will be returned as long as EANEnabled is included as a FeatureID value in the call request or no FeatureID values are passed into the call request. To verify if a specific eBay site supports the EAN product identifying feature (for most categories), look for a <code>true</code> value in the SiteDefaults.EANEnabled field. To verify if a specific category on a specific eBay site supports the EAN product identifying feature, pass in a CategoryID value in the request, and then look for a <code>true</code> value in the EANEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the ISBN product identifying feature. This field will be returned as long as ISBNEnabled is included as a FeatureID value in the call request or no FeatureID values are passed into the call request. To verify if a specific eBay site supports the ISBN product identifying feature (for most categories), look for a <code>true</code> value in the SiteDefaults.ISBNEnabled field. To verify if a specific category on a specific eBay site supports the ISBN product identifying feature, pass in a CategoryID value in the request, and then look for a <code>true</code> value in the ISBNEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the UPC product identifying feature. This field will be returned as long as UPCEnabled is included as a FeatureID value in the call request or no FeatureID values are passed into the call request. To verify if a specific eBay site supports the UPC product identifying feature (for most categories), look for a <code>true</code> value in the SiteDefaults.UPCEnabled field. To verify if a specific category on a specific eBay site supports the UPC product identifying feature, pass in a CategoryID value in the request, and then look for a <code>true</code> value in the UPCEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the Parts Compatibility feature for motor vehicles. This field will not be returned if one or more FeatureID fields are included in the call request and <code>CompatibleVehicleType</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces define a maximum limit for the number of fine-grained item compatibilities that can be applied to a listing. This field will not be returned if one or more FeatureID fields are included in the call request and <code>MaxGranularFitmentCount</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of category groups in shipping business policies. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ShippingProfileCategoryGroup</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally TThis field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of category groups in payment business policies. This field will not be returned if one or more FeatureID fields are included in the call request and <code>PaymentProfileCategoryGroup</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of category groups in return business policies. This field will not be returned if one or more FeatureID fields are included in the call request and <code>ReturnPolicyProfileCategoryGroup</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of the VIN (Vehicle Identification Number) field to identify a motor vehicle and create a listing is supported. VINs are supported on the US, Canada, Canada-French, and Australia sites. This field will not be returned if one or more FeatureID fields are included in the call request and <code>VINSupported</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of the VRM (Vehicle Registration Mark) field to identify a motor vehicle and create a listing is supported. VRMs are only supported on the UK site. This field will not be returned if one or more FeatureID fields are included in the call request and <code>VRMSupported</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support seller-provided titles in motor vehicle listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>SellerProvidedTitleSupported</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support deposits for motor vehicle listings. This field will not be returned if one or more FeatureID fields are included in the call request and <code>DepositSupported</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the Global Shipping Program (GSP) as the method for shipping orders internationally. This field will not be returned if one or more FeatureID fields are included in the call request and <code>GlobalShippingEnabled</code> is not one of the values passed into those <a href="types/FeatureIDCodeType.html">FeatureID</a> fields. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the Boat and Motorcycle Parts Compatibility feature. This field will be returned as long as AdditionalCompatibilityEnabled is included as a FeatureID value in the call request or no <a href="types/FeatureIDCodeType.html">FeatureID</a> values are passed into the call request. To verify if a specific eBay site supports Boat or Motorcycle Parts Compatibility (for most categories), look for a <code>true</code> value in the SiteDefaults.AdditionalCompatibilityEnabled field. To verify if a specific category on a specific eBay site supports Boat and Motorcycle Parts Compatibility, pass in a CategoryID value in the request, and then look for a <code>true</code> value in the AdditionalCompatibilityEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the Click and Collect feature. This field will be returned as long as PickupDropOffEnabled is included as a FeatureID value in the call request or no <a href="types/FeatureIDCodeType.html">FeatureID</a> values are passed into the call request. To verify if a specific eBay site supports the Click and Collect feature (for most categories), look for a <code>true</code> value in the SiteDefaults.PickupDropOffEnabled field. To verify if a specific category on a specific eBay site supports the Click and Collect feature, pass in a CategoryID value in the request, and then look for a <code>true</code> value in the PickupDropOffEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Note: For Click and Collect eligible sellers, the Click and Collect feature can only be enabled at the account level, and then each of the seller's listings within an Click and Collect enabled category will be automatically evaluated for Click and Collect eligibility. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support digital gift card listings. This field will be returned as long as DigitalGoodDeliveryEnabled is included as a FeatureID value in the call request or no <a href="types/FeatureIDCodeType.html">FeatureID</a> values are passed into the call request. To verify if a specific eBay site supports digital gift card listings (for most categories), look for a <code>true</code> value in the SiteDefaults.DigitalGoodDeliveryEnabled field. To verify if a specific category on a specific eBay site supports digital gift card listings, pass in a CategoryID value in the request, and then look for a <code>true</code> value in the DigitalGoodDeliveryEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Digital gift cards are currently only supported on the US site. There are some restrictions when it comes to selling gift cards, including the following: <ul> <li>Each seller can only have one gift card listing at any given time </li> <li>The maximum dollar value of the gift card may not exceed 500.00</li> <li>Prepaid credit cards from American Express, Discover, MasterCard, or Visa are not allowed</li> </ul> For more information on eBay's Gift Card policy, see the <a href=" https://www.ebay.com/help/policies/prohibited-restricted-items/gift-cards-policy?id=4294" target="_blank">Gift cards policy</a> help page. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of an eBay Product ID (e.g. ePID) in an Add/Revise/Relist API call to identify which motorcycles and/or scooters are compatible with a motor vehicle part or accessory. ePIDs can only be used to identify motorcycles and scooters on the Germany and UK sites. This field will be returned as long as EpidSupported is included as a FeatureID value in the call request or no <a href="types/FeatureIDCodeType.html">FeatureID</a> values are passed into the call request. For more information on using an ePID to identify a compatible motorcycle or scooter through an Add/Revise/Relist API call on the Germany or UK site, see the documentation for the <a href=" https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/AddItem.html#Request.Item.ItemCompatibilityList.Compatibility.NameValueList">Compatibility.NameValueList</a> container. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally TThis field is returned as an empty element (a boolean value is not returned) if one or more eBay marketplaces support the use of a K Type vehicle number in an Add/Revise/Relist API call to identify which cars and/or trucks are compatible with a motor vehicle part or accessory. K type vehicle numbers can only be used to identify cars and trucks on the Germany site. This field will be returned as long as KTypeSupported is included as a FeatureID value in the call request or no <a href="types/FeatureIDCodeType.html">FeatureID</a> values are passed into the call request. For more information on using a K Type vehicle number to identify a compatible car or truck through an Add/Revise/Relist API call on the Germany site, see the documentation for the <a href=" https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/AddItem.html#Request.Item.ItemCompatibilityList.Compatibility.NameValueList">Compatibility.NameValueList</a> container. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This field is deprecated. No eBay categories require listings based on an eBay catalog product. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally If present, this flag indicates the seller can set how to handle domestic returns. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally If present, this flag indicates the seller can set how to handle international returns. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally If present, this flag indicates the seller can set the time duration for domestic returns. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally If present, this flag indicates the seller can set the time duration for international returns. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally If present, this flag indicates the seller can set who pays the shipping for domestic returns. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally If present, this flag indicates the seller can set who pays the shipping for international returns. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally If present, this flag indicates the seller can set the method they use to refund domestic returns. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally If present, this flag indicates the seller can set the method they use to refund international returns. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally If present, this flag indicates the seller can choose to describe the return policy they offer (providing return-policy details is required in some EU countries). GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the seller making the request can list with certain features. A seller's eligibility is determined by their Feedback score. Indicates whether the seller is eligible to create auction listings enabled with the 'Buy It Now' option. A value of <code>true</code> means that the seller is eligible; a value of <code>false</code> indicates that they are not eligible. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Indicates whether the seller is eligible to specify the 'Buy It Now' option for multiple-quantity listings. A value of <code>true</code> means that the seller is eligible; a value of <code>false</code> indicates that they are not eligible. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Indicates whether the seller is eligible to create fixed-price listings with a one-day listing duration. A value of <code>true</code> means that the seller is eligible; a value of <code>false</code> indicates that the seller is not eligible. Note that this field only controls user eligibility. The listing type and category must support this feature for this field to be applicable. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Indicates whether or not the seller is eligible to create multiple-variation, fixed-price listings. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Always Indicates whether the seller is eligible to create an auction listing with a one-day duration. Limitation: the Adult-Only and Motor Vehicle categories do not support one-day auctions, so the seller cannot create one-day auction listings in these categories, even if the seller has the eligibility. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Enumerated type that lists all possible values that can be passed into the FeatureID field in a GetCategoryFeatures call. The FeatureID field is to used to check if specific listing features are enabled at the site or category level. Multiple FeatureID fields can be used in the request. If no FeatureID fields are used, the call retrieves data for all features defined within this enumerated type. DutchBINEnabled, DigitalDeliveryEnabled, BasicUpgradePack, ExpressEnabled, ExpressPicturesRequired, ExpressConditionRequired, TransactionConfirmationRequestEnabled, StoreInventoryEnabled, MaximumBestOffersAllowed, ClassifiedAdMaximumBestOffersAllowed, ClassifiedAdContactByEmailAvailable, ClassifiedAdPayPerLeadEnabled, ISBNIdentifierEnabled, UPCIdentifierEnabled, EANIdentifierEnabled, CombinedFixedPriceTreatment, PayPalRequiredForStoreOwner, AttributeConversionEnabled, PaymentOptionsGroup, VINSupported, VRMSupported, DepositSupported, SkypeMeTransactionalEnabled, SkypeMeNonTransactionalEnabled, PaisaPayFullEscrowEnabled, INEscrowWorkflowTimeline, UserConsentRequired, SafePaymentRequired, PayPalBuyerProtectionEnabled, BuyerGuaranteeEnabled, PayPalRequired, SpecialitySubscription, RegularSubscription, PremiumSubscription, NonSubscription, IntangibleEnabled, ProductCreationEnabled, GalleryFeaturedDurations, Group1MaxFlatShippingCost, Group2MaxFlatShippingCost, Group3MaxFlatShippingCost, HomePageFeaturedEnabled, ProductRequiredEnabled, ProPack, ProPackPlus, StoreOwnerExtendedListingDurations, StoreOwnerExtendedListingDurationsEnabled, ValuePack If this value is specified, supported site-default and category-specific listing durations values for each listing type are returned in the SiteDefaults.ListingDuration and Category.ListingDuration fields of the GetCategoryFeatures response. If this value is specified, the SiteDefaults.BestOfferEnabled and Category.BestOfferEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site supports the Best Offer feature, and which categories allow the Best Offer feature. This value is deprecated, as Dutch-style auctions are no longer available on any eBay sites. If this value is specified, the SiteDefaults.ShippingTermsRequired and Category.ShippingTermsRequired boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site, and individual categories on that site, require at least one domestic shipping service option (with cost) to be specified before an item is listed. This value is deprecated and should not be used. The feature associated with this value is deprecated, so specifying this value as a FeatureID value has no practical use. If this value is specified, the SiteDefaults.AdFormatEnabled and Category.AdFormatEnabled fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support Classified Ad listings. This value is deprecated and should no longer be used. If this value is specified, the SiteDefaults.BestOfferCounterEnabled and Category.BestOfferCounterEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site supports the Best Offer counter offers, and which categories allow the Best Offer counter offers. If this value is specified, the SiteDefaults.BestOfferAutoDeclineEnabled and Category.BestOfferAutoDeclineEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support the Best Offer auto decline feature. With the Best Offer auto decline feature, the seller sets a price threshold, and all Best Offers and counter offers below this price value are automatically declined without any seller action. The feature associated with this value is deprecated, so specifying this value as a FeatureID value has no practical use. This value is deprecated and should no longer be used. The feature associated with this value is deprecated, so specifying this value as a FeatureID value has no practical use. The feature associated with this value is deprecated, so specifying this value as a FeatureID value has no practical use. If this value is specified, the SiteDefaults.LocalMarketSpecialitySubscription boolean field in the GetCategoryFeatures response will indicate whether or not the specified eBay site supports Local Market listings for sellers with a specialty subscription to Local Market for Vehicles. If this value is specified, the SiteDefaults.LocalMarketRegularSubscription boolean field in the GetCategoryFeatures response will indicate whether or not the specified eBay site supports Local Market listings for sellers with a regular subscription to Local Market for Vehicles. If this value is specified, the SiteDefaults.LocalMarketPremiumSubscription boolean field in the GetCategoryFeatures response will indicate whether or not the specified eBay site supports Local Market listings for sellers with a premium subscription to Local Market for Vehicles. If this value is specified, the SiteDefaults.LocalMarketNonSubscription boolean field in the GetCategoryFeatures response will indicate whether or not the specified eBay site supports Local Market listings for sellers without a subscription to Local Market for Vehicles. This value is deprecated and should no longer be used. This value is deprecated and should no longer be used. This value is deprecated and should no longer be used. If this value is specified, the SiteDefaults.SellerContactDetailsEnabled and Category.SellerContactDetailsEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories allow the seller to provide contact information within a Classified Ad listing. This feature is only applicable to Classified Ad listings. Reserved for internal or future use. If this value is specified, the SiteDefaults.MinimumReservePrice and Category.MinimumReservePrice fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories require a minimum Reserve Price for auction listings. This feature is only applicable to Auction listings and only if the seller decides to set a Reserve Price for the auction. This value is deprecated and should no longer be used. This value is deprecated and should no longer be used. If this value is specified, the integer values in the LocalListingDistancesRegular, LocalListingDistancesSpecialty, and LocalListingDistancesNonSubscription fields in the GetCategoryFeatures response will indicate the radius (in miles) of the selling area for Local Market Vehicle listings, based on Local Market subscription status of the motor vehicle seller (specialty subscription, regular subscription, or no subscription). This enumeration value is no longer applicable, as Skype communication between eBay members is no longer supported. This enumeration value is no longer applicable, as Skype communication between eBay members is no longer supported. If this value is specified, the SiteDefaults.ClassifiedAdPaymentMethodEnabled and Category.ClassifiedAdPaymentMethodEnabled fields in the GetCategoryFeatures response will indicate whether or not (and when) accepted payment methods are displayed to buyers for the specified eBay site and for individual categories. This feature is only applicable for Classified Ad listings. If this value is specified, the SiteDefaults.ClassifiedAdShippingMethodEnabled and Category.ClassifiedAdShippingMethodEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support the display of available shipping methods to buyers. This feature is only applicable for Classified Ad listings. If this value is specified, the SiteDefaults.ClassifiedAdBestOfferEnabled and Category.ClassifiedAdBestOfferEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support the Best Offer feature for Classified Ad listings. If this value is specified, the SiteDefaults.ClassifiedAdCounterOfferEnabled and Category.ClassifiedAdCounterOfferEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support Best Offer counter offers for Classified Ad listings. This feature is only applicable for Classified Ad listings. If this value is specified, the SiteDefaults.ClassifiedAdAutoDeclineEnabled and Category.ClassifiedAdAutoDeclineEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support the Best Offer auto decline feature for Classified Ad listings. With the Best Offer auto decline feature, the seller sets a price threshold, and all Best Offers and counter offers below this price value are automatically declined without any seller action. This feature is only applicable for Classified Ad listings. If this value is specified, the SiteDefaults.ClassifiedAdContactByEmailEnabled and Category.ClassifiedAdContactByEmailEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories allow the seller to provide a contact email address within a Classified Ad listing. This feature is only applicable to Classified Ad listings. If this value is specified, the SiteDefaults.ClassifiedAdContactByPhoneEnabled and Category.ClassifiedAdContactByPhoneEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories allow the seller to provide a contact phone number within a Classified Ad listing. This feature is only applicable to Classified Ad listings. This value is deprecated and should not be used. This value is deprecated and should no longer be used. This value is deprecated and should no longer be used. This value is deprecated and should no longer be used. To verify if the seller's contact information can be shared with prospective buyers in the listing, use the SellerContactDetailsEnabled enumeration value instead. This value is deprecated and should no longer be used. If this value is specified, the SiteDefaults.ItemSpecificsEnabled and Category.ItemSpecificsEnabled fields in the GetCategoryFeatures response will indicate if the eBay site and individual categories support the use of Item Specifics in listings. This value is deprecated and should not be used. This value is deprecated and should no longer be used. Use ISBNEnabled instead. This value is deprecated and should no longer be used. Use UPCEnabled instead. This value is deprecated and should no longer be used. Use EANEnabled instead. If this value is specified, the Category.BrandMPNIdentifierEnabled boolean field in the GetCategoryFeatures response will indicate whether or not individual categories on the specified site support the ability of a seller to identify a product through a Brand/Manufacturer Part Number (MPN) combination. If this value is specified, the SiteDefaults.ClassifiedAdAutoAcceptEnabled and Category.ClassifiedAdAutoAcceptEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support the Best Offer auto accept feature for Classified Ad listings. With the Best Offer auto accept feature, the seller sets a price threshold, and all Best Offers and counter offers at or above this price value are automatically accepted without any seller action. This feature is only applicable for Classified Ad listings. If this value is specified, the SiteDefaults.BestOfferAutoAcceptEnabled and Category.BestOfferAutoAcceptEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support the Best Offer auto accept feature. With the Best Offer auto accept feature, the seller sets a price threshold, and all Best Offers and counter offers at or above this price value are automatically accepted without any seller action. If this value is specified, the CrossBorderTradeNorthAmericaEnabled, CrossBorderTradeGBEnabled, and CrossBorderTradeAustraliaEnabled fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support the International Site Visibility (Cross-Border Trade) feature, and on which sites. With the International Site Visibility feature, the seller is able to create a listing and make this listing available on multiple eBay sites (not just their domestic eBay site). This value is deprecated and should not be used. This value is deprecated and should not be used. This value is deprecated since it is only applicable to the eBay India site, and this marketplace is no longer available. This value is deprecated and should no longer be used. The Featured Gallery feature is deprecated, so specifying this value as a FeatureID value has no practical use. This value is deprecated and should not be used. If this value is specified, the SiteDefaults.eBayMotorsProAdFormatEnabled and Category.eBayMotorsProAdFormatEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories allow motor vehicles to be sold through Classified Ads. This value is only applicable for eBay Motors Pro users. If this value is specified, the SiteDefaults.eBayMotorsProContactByPhoneEnabled and Category.eBayMotorsProContactByPhoneEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories allow eBay Motors Pro users to provide contact phone numbers within a Motor Vehicles Classified Ad listing. The Category.eBayMotorsProPhoneCount field indicates how many contact phone numbers are supported in each listing. This feature is only applicable to Motor Vehicles Classified Ad listings. If this value is specified, the SiteDefaults.eBayMotorsProContactByAddressEnabled and Category.eBayMotorsProContactByAddressEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories allow eBay Motors Pro users to provide contact street addresses within a Motor Vehicles Classified Ad listing. The Category.eBayMotorsProStreetCount field indicates how many contact street addresses are supported in each listing. This feature is only applicable to Motor Vehicles Classified Ad listings. If this value is specified, the SiteDefaults.eBayMotorsProCompanyNameEnabled and Category.eBayMotorsProCompanyNameEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories allow eBay Motors Pro users to provide a company name within a Motor Vehicles Classified Ad listing. This feature is only applicable to Motor Vehicles Classified Ad listings. If this value is specified, the SiteDefaults.eBayMotorsProContactByEmailEnabled and Category.eBayMotorsProContactByEmailEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories allow eBay Motors Pro users to provide a contact email address within a Motor Vehicles Classified Ad listing. This feature is only applicable to Motor Vehicles Classified Ad listings. If this value is specified, the SiteDefaults.eBayMotorsProBestOfferEnabled and Category.eBayMotorsProBestOfferEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support the Best Offer feature for Motor Vehicles Classified Ad listings. If this value is specified, the SiteDefaults.eBayMotorsProAutoAcceptEnabled and Category.eBayMotorsProAutoAcceptEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support the Best Offer auto accept feature for Motor Vehicles Classified Ad listings. With the Best Offer auto accept feature, the seller sets a price threshold, and all Best Offers and counter offers at or above this price value are automatically accepted without any seller action. This feature is only applicable for Motor Vehicles Classified Ad listings, and is only available to eBay Motors Pro users. If this value is specified, the SiteDefaults.eBayMotorsProAutoDeclineEnabled and Category.eBayMotorsProAutoDeclineEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support the Best Offer auto decline feature for Motor Vehicles Classified Ad listings. With the Best Offer auto decline feature, the seller sets a price threshold, and all Best Offers and counter offers below this price value are automatically declined without any seller action. This feature is only applicable for Motor Vehicles Classified Ad listings, and is only available to eBay Motors Pro users. If this value is specified, the SiteDefaults.eBayMotorsProPaymentMethodCheckOutEnabled and Category.eBayMotorsProPaymentMethodCheckOutEnabled fields in the GetCategoryFeatures response will indicate whether or not (and when) accepted payment methods are displayed to buyers for the specified eBay site and for individual categories. This feature is only applicable for Motor Vehicles Classified Ad listings, and is only available to eBay Motors Pro users. If this value is specified, the SiteDefaults.eBayMotorsProShippingMethodEnabled and Category.eBayMotorsProShippingMethodEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support the display of available shipping methods to buyers. This feature is only applicable for Motor Vehicles Classified Ad listings, and is only available to eBay Motors Pro users. If this value is specified, the SiteDefaults.eBayMotorsProCounterOfferEnabled and Category.eBayMotorsProCounterOfferEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support Best Offer counter offers for Motor Vehicles Classified Ad listings. This feature is only applicable for Motor Vehicles Classified Ad listings, and is only available to eBay Motors Pro users. If this value is specified, the SiteDefaults.eBayMotorsProSellerContactDetailsEnabled and Category.eBayMotorsProSellerContactDetailsEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories allow the seller to provide contact information within a Motor Vehicles Classified Ad listing. This feature is only applicable for Motor Vehicles Classified Ad listings, and is only available to eBay Motors Pro users. If this value is specified, the SiteDefaults.LocalMarketAdFormatEnabled and Category.LocalMarketAdFormatEnabled fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories allow motor vehicles to be sold through Local Market Classified Ads. Motors Local Market listings are only available to eBay sellers who are Licensed Vehicle Dealers on eBay. If this value is specified, the SiteDefaults.LocalMarketContactByPhoneEnabled and Category.LocalMarketContactByPhoneEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories allow eBay Licensed Vehicle Dealers to provide contact phone numbers within a Motors Local Market listing. The Category.LocalMarketPhoneCount field indicates how many contact phone numbers are supported in each listing. This feature is only applicable to Motors Local Market listings. If this value is specified, the SiteDefaults.LocalMarketContactByAddressEnabled and Category.LocalMarketContactByAddressEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories allow eBay Licensed Vehicle Dealers to provide contact street addresses within a Motors Local Market listing. This feature is only applicable to Motors Local Market listings. If this value is specified, the SiteDefaults.LocalMarketCompanyNameEnabled and Category.LocalMarketCompanyNameEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories allow eBay Licensed Vehicle Dealers to provide a company name within a Motors Local Market listing. This feature is only applicable to Motors Local Market listings. If this value is specified, the SiteDefaults.LocalMarketContactByEmailEnabled and Category.LocalMarketContactByEmailEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories allow eBay Licensed Vehicle Dealers to provide contact email addresses within a Motors Local Market listing. This feature is only applicable to Motors Local Market listings. If this value is specified, the SiteDefaults.LocalMarketBestOfferEnabled and Category.LocalMarketBestOfferEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support the Best Offer feature for Motors Local Market listings. If this value is specified, the SiteDefaults.LocalMarketAutoAcceptEnabled and Category.LocalMarketAutoAcceptEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support the Best Offer auto accept feature for Motors Local Market listings. With the Best Offer auto accept feature, the seller sets a price threshold, and all Best Offers and counter offers at or above this price value are automatically accepted without any seller action. This feature is only applicable for Motors Local Market listings, and is only available to eBay Licensed Vehicle Dealers. If this value is specified, the SiteDefaults.LocalMarketAutoDeclineEnabled and Category.LocalMarketAutoDeclineEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support the Best Offer auto decline feature for Motors Local Market listings. With the Best Offer auto decline feature, the seller sets a price threshold, and all Best Offers and counter offers below this price value are automatically declined without any seller action. This feature is only applicable for Motors Local Market listings, and is only available to eBay Licensed Vehicle Dealers. If this value is specified, the SiteDefaults.LocalMarketPaymentMethodCheckOutEnabled and Category.LocalMarketPaymentMethodCheckOutEnabled fields in the GetCategoryFeatures response will indicate whether or not (and when) accepted payment methods are displayed to buyers for the specified eBay site and for individual categories. This feature is only applicable for Motors Local Market listings, and is only available to eBay Licensed Vehicle Dealers. If this value is specified, the SiteDefaults.LocalMarketShippingMethodEnabled and Category.LocalMarketShippingMethodEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support the display of available shipping methods to buyers. This feature is only applicable for Motors Local Market listings, and is only available to eBay Licensed Vehicle Dealers. If this value is specified, the SiteDefaults.LocalMarketCounterOfferEnabled and Category.LocalMarketCounterOfferEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support Best Offer counter offers for Motors Local Market listings. This feature is only applicable for Motors Local Market listings, and is only available to eBay Licensed Vehicle Dealers. If this value is specified, the SiteDefaults.LocalMarketSellerContactDetailsEnabled and Category.LocalMarketSellerContactDetailsEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories allow the seller to provide contact information within a Motors Local Market listing. This feature is only applicable for Motors Local Market listings, and is only available to eBay Licensed Vehicle Dealers. If this value is specified, the SiteDefaults.ClassifiedAdContactByAddressEnabled and Category.ClassifiedAdContactByAddressEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories allow sellers to provide contact street addresses within a Classified Ad listing. The Category.ClassifiedAdStreetCount field indicates how many street addresses are allowed in each listing. This feature is only applicable to Classified Ad listings. If this value is specified, the SiteDefaults.ClassifiedAdCompanyNameEnabled and Category.ClassifiedAdCompanyNameEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories allow sellers to provide a company name within a Classified Ad listing. This feature is only applicable to Classified Ad listings. This value is deprecated and should no longer be used. This value is deprecated and should no longer be used. This value is deprecated and should no longer be used. This value is deprecated and should no longer be used. This value is deprecated and should no longer be used. This value is deprecated and should no longer be used. If this value is specified, the SiteDefaults.ReviseQuantityAllowed and Category.ReviseQuantityAllowed boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories allow sellers to revise quantity in a multi-quantity, fixed-price listing while the listing is in a semi- or fully-restricted mode (such as when the listing already has sales or when the listing is scheduled to end within 12 hours). This value is only applicable to fixed-price listings. If this value is specified, the SiteDefaults.RevisePriceAllowed and Category.RevisePriceAllowed boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories allow sellers to revise the price in a fixed-price listing while the listing is in a semi- or fully-restricted mode (such as when the listing already has sales or when the listing is scheduled to end within 12 hours). This value is only applicable to fixed-price listings. The feature associated with this value is deprecated, so specifying this value as a FeatureID value has no practical use. The feature associated with this value is deprecated, so specifying this value as a FeatureID value has no practical use. If this value is specified, the SiteDefaults.ReturnPolicyEnabled and Category.ReturnPolicyEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories allow eBay sellers to create a return policy for the listing. If this value is specified, the SiteDefaults.HandlingTimeEnabled and Category.HandlingTimeEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories require eBay sellers to set a handling time for products sold within the listing. The handling time is the maximum number of business days the seller commits to for preparing an item to be shipped after receiving a cleared payment. The seller's handling time does not include the shipping time (the carrier's transit time). If this value is specified, the SiteDefaults.PaymentMethod and SiteDefaults.PaymentMethod fields in the GetCategoryFeatures response will indicate the accepted payment methods at the eBay site level and within the individual categories. If this value is specified, the Category.MaxFlatShippingCost fields in the GetCategoryFeatures response will indicate the maximum flat-rate shipping costs that the seller may charge the buyer to ship one item domestically. At least one available shipping service option has to be under this value. Handling cost (if any) goes toward this maximum cost threshold. If this value is specified, the SiteDefaults.MaxFlatShippingCostCBTExempt boolean field in the GetCategoryFeatures response will indicate whether or not sellers, who sell items to domestic buyers, but are shipping the item from another country, are exempt from the MaxFlatShippingCost threshold. The feature associated with this value is deprecated, so specifying this value as a FeatureID value has no practical use. The feature associated with this value is deprecated, so specifying this value as a FeatureID value has no practical use. The feature associated with this value is deprecated, so specifying this value as a FeatureID value has no practical use. If this value is specified, the SiteDefaults.VariationsEnabled and Category.VariationsEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support multi-variation listings. Variations are items within the same listing that are logically the same product, but differ slightly in size, color, or other aspect. This value is deprecated and should no longer be used. If this value is specified, the SiteDefaults.FreeGalleryPlusEnabled and Category.FreeGalleryPlusEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support a free Gallery Plus upgrade. The Gallery Plus feature includes the picture zoom-in option (when you hover the mouse over the picture) and the ability to enlarge the photo by clicking a link. If this value is specified, the SiteDefaults.FreePicturePackEnabled and Category.FreePicturePackEnabled boolean fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support a free Picture Pack upgrade. The Picture Pack feature is only available for eBay Motors vehicle listings. The Picture Pack feature includes up to 12 supersized photos with the zoom-in feature enabled for each one. If this value is specified, the SiteDefaults.ItemCompatibilityEnabled and Category.ItemCompatibilityEnabled fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support the Parts Compatibility feature, and if so, the mode of compatibility that is used (by application or by specification). The Parts Compatibility feature allows sellers to list their motor vehicles parts and accessories items with parts compatibility name-value pairs specific to motor vehicles, and allows potential buyers to search for these items using parts compatibility search fields. If this value is specified, the Category.MinCompatibleApplications fields in the GetCategoryFeatures response will indicate the minimum number of compatible applications that must be specified when listing a motor vehicle part or accessory in the given category. If this value is specified, the Category.MaxCompatibleApplications fields in the GetCategoryFeatures response will indicate the maximum number of compatible applications that can be specified when listing a motor vehicle part or accessory in the given category. If this value is specified, the Category.ConditionEnabled fields in the GetCategoryFeatures response will indicate which individual categories support (and even require) the use of ConditionID values to specify the condition of an item within a listing. If this value is specified, the Category.Condition containers in the GetCategoryFeatures response will include Condition ID values and item conditions like 'Very Good', 'Acceptable', 'Used', etc. for all categories that support the use of Condition ID values. If this value is specified, the Category.ValueCategory boolean fields in the GetCategoryFeatures response will indicate the categories that are considered by eBay to be 'Value Categories'. 'Value Categories' are generally categories where buyers can find good deals on items. If sellers decide to list within a value category, only this category may be used, and a secondary category is not supported. This value is deprecated and should no longer be used. If this value is specified, the Category.EANEnabled fields in the GetCategoryFeatures response will indicate whether or not items listed in the corresponding category may utilize EANs to identify a product. A value of <code>Disabled</code> indicates that EANs cannot be used for the category, a value of <code>Enabled</code> indicates that EANs can be used for the category, and a value of <code>Required</code> indicates that an EAN is required when listing a product in this category. If this value is specified, the Category.ISBNEnabled fields in the GetCategoryFeatures response will indicate whether or not items listed in the corresponding category may utilize ISBNs to identify a product. A value of <code>Disabled</code> indicates that ISBNs cannot be used for the category, a value of <code>Enabled</code> indicates that ISBNs can be used for the category, and a value of <code>Required</code> indicates that an ISBN is required when listing a product in this category. If this value is specified, the Category.UPCEnabled fields in the GetCategoryFeatures response will indicate whether or not items listed in the corresponding category may utilize UPCs to identify a product. A value of <code>Disabled</code> indicates that UPCs cannot be used for the category, a value of <code>Enabled</code> indicates that UPCs can be used for the category, and a value of <code>Required</code> indicates that a UPC is required when listing a product in this category. If this value is specified, the Category.MaxGranularFitmentCount fields in the GetCategoryFeatures response will indicate how many Parts Compatibility name-value pairs may be passed in for each motor vehicle aspect (Year, Make, and Model) in a motor vehicle parts and accessory listing. granularity. This field is only applicable to motor vehicle parts and accessory listings. If this value is specified, the Category.CompatibleVehicleType fields in the GetCategoryFeatures response will indicate the type of vehicle that parts compatibility name-value pairs in a listing will be referring to, such as 'cars and trucks', 'all-terrain vehicles (ATV)', 'boats', and 'motorcycles'. This field is only applicable to motor vehicle parts and accessory listings. This value is deprecated and should no longer be used. If this value is specified, the Category.ShippingProfileCategoryGroup fields in the GetCategoryFeatures response will indicate which shipping business policy category group that each category will inherit as the default category group. Currently, there are only two Business Policies category groups - 'MOTORS_VEHICLE' covers all motor-vehicle related categories, and 'ALL' covers all other categories. If this value is specified, the Category.PaymentProfileCategoryGroup fields in the GetCategoryFeatures response will indicate which payment business policy category group that each category will inherit as the default category group. Currently, there are only two Business Policies category groups - 'MOTORS_VEHICLE' covers all motor-vehicle related categories, and 'ALL' covers all other categories. If this value is specified, the Category.ReturnPolicyProfileCategoryGroup fields in the GetCategoryFeatures response will indicate which return policy business policy category group that each category will inherit as the default category group. Currently, there are only two Business Policies category groups - 'MOTORS_VEHICLE' covers all motor-vehicle related categories, and 'ALL' covers all other categories. This value is deprecated and should no longer be used. This value is deprecated and should no longer be used. If this value is specified, the SiteDefaults.SellerProvidedTitleSupported and Category.SellerProvidedTitleSupported fields in the GetCategoryFeatures response will indicate if the eBay site and individual categories support the use of a seller-provided title for a motor vehicle listing on the US or Canada Motors marketplaces. A seller-provided title is a descriptive title, given by the seller, that appears below eBay's pre-filled listing title for the motor vehicle. This value is deprecated and should no longer be used. If this value is specified, the SiteDefaults.GlobalShippingEnabled and Category.GlobalShippingEnabled fields in the GetCategoryFeatures response will indicate if the eBay site and individual categories support the Global Shipping Program (GSP) as a means for shipping items internationally. The GSP feature is only applicable to shipping items internationally. If this value is specified, the SiteDefaults.AdditionalCompatibilityEnabled and Category.AdditionalCompatibilityEnabled fields in the GetCategoryFeatures response will indicate whether or not the specified eBay site and individual categories support the second-generation Parts Compatibility feature where parts-compatibility name-value pairs can be passed in for boats, motorcycles, and other vehicles instead of just cars and trucks. This feature is only applicable to motor vehicle parts and accessory listings. If this value is specified, the Category.PickupDropOffEnabled fields in the GetCategoryFeatures response will indicate that items listed in the corresponding category may be enabled with the 'Click and Collect' feature. With the 'Click and Collect' feature, a buyer can purchase certain items on the eBay site and collect them at a local store. Buyers are notified by eBay once their items are available. A <code>false</code> value in this field indicates that items listed in the category are not eligible for the 'Click and Collect' feature. The 'Click and Collect' feature is only available to large merchants on the eBay UK (site ID - 3), eBay Australia (Site ID - 15), and eBay Germany (Site ID - 77) sites. If this value is specified, the Category.DigitalGoodDeliveryEnabled fields in the GetCategoryFeatures response will indicate that digital gift cards can be listed in the corresponding category. A <code>false</code> value in this field indicates that digital gift cards may not be listed in the category. Digital gift cards are currently only supported on the US site. There are some restrictions when it comes to selling gift cards, including the following:
<ul> <li>Each seller can only have one gift card listing at any given time;</li> <li>The maximum dollar value of the gift card may not exceed 500.00; and</li> <li>prepaid credit cards from American Express, Discover, MasterCard, or Visa are not allowed.</li> </ul> For more information on eBay's Gift Card policy, see the <a href="http://pages.ebay.com/help/policies/gift.html">Gift cards policy</a> Help page. This value is used to see if an eBay Product ID (e.g. ePID) can be used in an Add/Revise/Relist API call to identify which motorcycles and/or scooters are compatible with a motor vehicle part or accessory is supported. ePIDs can only be used to identify motorcycles and scooters on the Germany and UK sites. For more information on using an ePID to identify a compatible motorcycle or scooter through an Add/Revise/Relist API call on the Germany or UK site, see the documentation for the <a href=" https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/AddItem.html#Request.Item.ItemCompatibilityList.Compatibility.NameValueList">Compatibility.NameValueList</a> container. This value is used to see if a K Type vehicle number in an Add/Revise/Relist API call to identify which cars and/or trucks are compatible with a motor vehicle part or accessory is supported. K type vehicle numbers can only be used to identify cars and trucks on the Germany site. For more information on using a K Type vehicle number to identify a compatible car or truck through an Add/Revise/Relist API call on the Germany site, see the documentation for the <a href=" https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/AddItem.html#Request.Item.ItemCompatibilityList.Compatibility.NameValueList">Compatibility.NameValueList</a> container. The feature associated with this value is deprecated, so specifying this value as a FeatureID value has no practical use. Use this ID to return the values you can specify for whether or not a seller accepts domestic returns. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated marketplace and category. Note: Sellers have the option of using the same return policy settings for both domestic and international returns, or different settings for domestic and international return policies. To see the supported returns accepted options for international returns, the InternationalReturnsAcceptedValues enum should be used. Use this ID to return the values you can specify for whether or not a seller accepts international returns. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated marketplace and category. Note: Sellers have the option of using the same return policy settings for both domestic and international returns, or different settings for domestic and international return policies. To see the supported returns accepted options for domestic returns, the DomesticReturnsAcceptedValues enum should be used. Use this ID to return the values you can specify for the return duration for domestic returns. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated marketplace and category. Note: Sellers have the option of using the same return policy settings for both domestic and international returns, or different settings for domestic and international return policies. To see the supported return windows for international returns, the InternationalReturnsDurationValues enum should be used. Use this ID to return the values you can specify for the return duration for international returns. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated marketplace and category. Note: Sellers have the option of using the same return policy settings for both domestic and international returns, or different settings for domestic and international return policies. To see the supported return windows for domestic returns, the DomesticReturnsDurationValues enum should be used. Use this ID to return the values you can specify for who pays any return shipping costs for domestic returns. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated marketplace and category. Note: Sellers have the option of using the same return policy settings for both domestic and international returns, or different settings for domestic and international return policies. To see the supported return shipment payee values for international returns, the InternationalReturnsShipmentPayeeValues enum should be used. Use this ID to return the values you can specify for who pays any return shipping costs for international returns. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated marketplace and category. Note: Sellers have the option of using the same return policy settings for both domestic and international returns, or different settings for domestic and international return policies. To see the supported return shipment payee values for domestic returns, the DomesticReturnsShipmentPayeeValues enum should be used. In US, sellers can offer item replacement in addition to offering a money-back refund for domestic returns. Use this ID to return whether or not the seller can offer <code>MoneyBackorReplacement</code> for the specified category. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated marketplace and category. Note: Sellers have the option of using the same return policy settings for both domestic and international returns, or different settings for domestic and international return policies. To see the supported refund method options for international returns, the InternationalRefundMethodValues enum should be used. In US, sellers can offer item replacement in addition to offering a money-back refund for international returns. Use this ID to return whether or not the seller can offer <code>MoneyBackorReplacement</code> for the specified category. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated marketplace and category. Note: Sellers have the option of using the same return policy settings for both domestic and international returns, or different settings for domestic and international return policies. To see the supported refund method options for domestic returns, the DomesticRefundMethodValues enum should be used. In some EU countries, sellers are legally required to describe the return policy they offer. The value returned by this field indicates if sellers can provide such description within the given marketplace and category. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated marketplace and category. Enumerated type that indicates if the Featured First listing upgrade is enabled for the specified site, and whether it is restricted to a specific seller level. Note: The Featured First listing upgrade can no longer be added for new listings in any eBay marketplace. This enumeration value indicates that the Featured First listing upgrade is enabled for all sellers on the site. This enumeration value indicates that the Featured First listing upgrade is not available for any sellers on the site. This enumeration value indicates that the Featured First listing upgrade is only enabled for Power Sellers on the site. This enumeration value indicates that the Featured First listing upgrade is only enabled for Top-Rated Sellers on the site. Reserved for internal or future use. Enumerated type that indicates if the Featured Plus listing upgrade is enabled for the specified site, and whether it is restricted to a specific seller level. This enumeration value indicates that the Featured Plus listing upgrade is enabled for all sellers on the site. This enumeration value indicates that the Featured Plus listing upgrade is not available for any sellers on the site. This enumeration value indicates that the Featured Plus listing upgrade is only enabled for Power Sellers on the site. This enumeration value indicates that the Featured Plus listing upgrade is only enabled for Top-Rated Sellers on the site. Reserved for internal or future use. This enumerated type consists of the different Federal Express shipping rates that sellers can offer to buyers. The shipping rates for the major US shipping carriers can be selected in the Shipping rate preferences in My eBay, or through the SetUserPreferences call. This enumeration value indicates that the seller offers buyers the standard Federal Express shipping rates. This enumeration value indicates that the seller offers buyers Federal Express counter rates. This enumeration value indicates that the seller offers buyers discounted Federal Express shipping rates. Buyers will get these discounted shipping rates as long as they use the eBay-generated shipping labels. Reserved for internal or future use Identifies the name and cost of a listing feature that a member pays to eBay. These listing feature names, fees, and possible discounts are intended only as an aid to help estimate the fees for a listing. This is the name of the listing feature, such as <code>ListingFee</code>, <code>SubtitleFee</code>, or <code>BoldFee</code>. Fees https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/fees.html AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseInventoryStatus ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Always Amount of the fee that eBay will charge the member for the associated listing feature. eBay.com Fees http://pages.ebay.com/help/sell/fees.html a current list of listing features and their associated fees. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseInventoryStatus ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Always This field exists in the response when the user has selected a feature that participates in a promotional discount. Note: Verify calls might not return the PromotionalDiscount fee in the response. Standard selling fees http://pages.ebay.com/help/sell/fees.html A current schedule of listing features and their associated fees. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem ReviseInventoryStatus RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Always This type is used by the FeedbackDetailArray container that is returned in the GetFeedback call. The FeedbackDetailArray container consists of an array of one or more Feedback entries. The Feedback entries that are returned will depend on the fields/values included in the call request. This container consists of detailed information for a Feedback entry on a specific order line item. For Feedback entries that were left for the buyer by the seller, some of the fields in this container will not be returned to users who were not involved in the transaction as either the buyer or seller. GetFeedback

DetailLevel: ReturnAll

Conditionally Type used by the FeedbackDetail containers that are returned in the GetFeedback response. Each FeedbackDetail container consists of detailed information on one Feedback entry for a specific order line item. This container will only be returned if uses the DetailLevel field and sets its value to <code>ReturnAll</code>. Note: Although it is possible for users to retrieve Feedback entries for order line items in which they are not the buyer or seller, some of the fields of the FeedbackDetail container will not be returned or masked. More details on the fields that will not be returned or masked are discussed in this type's individual fields. The eBay User ID of the user who left the Feedback entry. Note: This field is returned, but masked to users who are not either the buyer or seller of the order line item. GetFeedback

DetailLevel: ReturnAll

Conditionally This enumeration value is the Feedback Rating Star of the user indicated in the CommentingUser field. See <a href="types/FeedbackRatingStarCodeType.html">FeedbackRatingStarCodeType</a> for the full list of Feedback Rating Stars, and the Feedback score ranges associated with those stars. GetFeedback

DetailLevel: ReturnAll

Conditionally This integer value is the Feedback score of the user indicated in the CommentingUser field. GetFeedback

DetailLevel: ReturnAll

Conditionally This free-form text is the actual comment that the commenting user left for their order partner. The Feedback comment's purpose is to explain, clarify, or justify the Feedback rating specified in the CommentType field. The comment is returned as text in the language that the comment was originally left in. This comment will still be displayed even if a submitted Feedback entry is withdrawn. 500 GetFeedback

DetailLevel: ReturnAll

Conditionally This timestamp (in GMT) indicates the date/time that the Feedback entry was submitted to eBay. GetFeedback

DetailLevel: ReturnAll

Conditionally This value indicates the rating of the Feedback left by the user identified in the CommentingUser field. A Positive rating increases a user's Feedback score, a Negative rating decreases a user's Feedback score, and a Neutral rating does not affect a user's Feedback score. Sellers cannot leave Neutral or Negative ratings for buyers. GetFeedback

DetailLevel: ReturnAll

Conditionally This free-form text is the comment that the recipient of the Feedback may leave in response or rebuttal to the Feedback. Responses to Feedback comments cannot be submitted or edited via the API. 500 GetFeedback

DetailLevel: ReturnAll

Conditionally This free-form text is the explanation that a user can give to a response. Follow-ups to Feedback comments cannot be submitted or edited via the API. 500 GetFeedback

DetailLevel: ReturnAll

Conditionally The unique identifier of the eBay listing associated with the Feedback entry. Note: For Feedback entries that were submitted less than five years ago, this field is returned to users who are not the buyer or seller of the order line item, but a dummy value such as '111111111' will be displayed. For Feedback entries that were submitted more than five years ago, this field will not be returned at all to users who do not have a relationship (as a buyer or seller) to the Feedback entry. GetFeedback

DetailLevel: ReturnAll

Conditionally Indicates whether the recipient of the Feedback entry is the buyer or the seller for the corresponding order line item. GetFeedback

DetailLevel: ReturnAll

Conditionally The title of the item listing for which Feedback was provided. The title is returned as CDATA. This value can be returned as part of the Detailed Seller Ratings feature. Not returned if a listing ended more than 90 days ago. For Feedback entries that were left for the buyer by the seller, an ItemTitle value will not be returned to a user that was not involved in the transaction as either the buyer or seller. 80 Seller ratings https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/feedback-seller-ratings.html GetFeedback

DetailLevel: ReturnAll

Conditionally The purchase price for the item that was associated with the Feedback entry. This value can be returned as part of the Detailed Seller Ratings feature. Not returned if a listing ended more than 90 days ago. For Feedback entries that were left for the buyer by the seller, an ItemPrice value will not be returned to a user that was not involved in the transaction as either the buyer or seller. Seller ratings https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/feedback-seller-ratings.html GetFeedback

DetailLevel: ReturnAll

Conditionally Unique identifier for the Feedback entry. GetFeedback

DetailLevel: ReturnAll

Conditionally Unique identifier for an eBay order line item for which the Feedback entry was left. This field is not returned if the Feedback entry was left for an auction listing, since all auction listings have a TransactionID value of 0. Note: Historically, TransactionID values have been '0' for auction listings, and some developers may have built logic around this. However, non-zero TransactionID values for auction listings started being used for some eBay marketplaces beginning in July 2024, and all eBay marketplaces are expected to start using non-zero TransactionID values for auction listings in the near future. If necessary, developers should update code to handle non-zero transaction IDs for auction transactions. Note: For Feedback entries that were submitted less than five years ago, this field is returned to users who are not the buyer or seller of the order line item, but a dummy value such as '111111111' will be displayed. For Feedback entries that were submitted more than five years ago, this field will not be returned at all to users who do not have a relationship (as a buyer or seller) to the Feedback entry. GetFeedback

DetailLevel: ReturnAll

Conditionally This boolean value indicates whether or not eBay replaced the Feedback comment with a message that the Feedback comment was removed. GetFeedback

DetailLevel: ReturnAll

Conditionally This boolean value indicates whether or not eBay replaced the response to the Feedback comment with a message that the response to the Feedback comment was removed. GetFeedback

DetailLevel: ReturnAll

Conditionally This boolean value indicates whether or not eBay replaced the follow-up to the Feedback comment with a message that the follow-up to the Feedback comment was removed. GetFeedback

DetailLevel: ReturnAll

Conditionally This boolean value indicates whether or not the Feedback entry will affect the user's Feedback score. Only Feedback left by verified users can count toward the aggregate score of another user. If a unverified user leaves a Feedback entry, then later becomes verified, that Feedback entry will still have no affect on the recipient user's Feedback score. Or, if a user is verified and at some later date changes to unverified status, the Feedback entry left while the user was verified remains in effect. true GetFeedback

DetailLevel: ReturnAll

Conditionally (GetUser) ItemDetails GetUser.html#Response.User.SiteVerfied This flag indicates whether or not a Feedback entry was revised (rating was changed). GetFeedback

DetailLevel: ReturnAll

Conditionally The unique identifier for an eBay order line item. For Feedback entries that were left for the buyer by the seller, an OrderLineItemID value will not be returned to a user that was not involved in the transaction as either the buyer or seller. Note: For Feedback entries that were submitted less than five years ago, this field is returned to users who are not the buyer or seller of the order line item, but a dummy value such as '11111111-0' will be displayed. For Feedback entries that were submitted more than five years ago, this field will not be returned at all to users who do not have a relationship (as a buyer or seller) to the Feedback entry. GetFeedback

DetailLevel: ReturnAll

Conditionally Type defining the Feedback details for an order line item, including the eBay User ID of the user the feedback is intended for, the Feedback rating, and the Feedback comment. Textual comment that explains, clarifies, or justifies the Feedback rating specified in CommentType. This field is required in CompleteSale if the FeedbackInfo container is used. This comment will still be displayed even if submitted Feedback is withdrawn. 500 CompleteSale Conditionally GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This value indicates the Feedback rating for the user specified in the TargetUser field. This field is required in CompleteSale if the FeedbackInfo container is used. A Positive rating increases the user's Feedback score, a Negative rating decreases the user's Feedback score, and a Neutral rating does not affect the user's Feedback score. eBay users also have the right to withdraw feedback for whatever reason. Sellers cannot leave Neutral or Negative ratings for buyers. CompleteSale Positive Conditionally GetItemsAwaitingFeedback Conditionally FeedbackReceived GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally This eBay User ID identifies the recipient user for whom the feedback is being left. This field is required in CompleteSale if the FeedbackInfo container is used. Note: Effective September 26, 2025, both usernames and public user IDs will be accepted in this field. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. CompleteSale No GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Container for a set of feedback statistics. Contains zero one or multiple FeedbackPeriod objects. Output only, for the summary feedback data returned by GetFeedback. Contains one feedback statistic giving length of the period being reported (e.g. last 7 days prior to the call), and total number of feedback entries (of the type given by the container, e.g. positive feedback) submitted during the indicated period. Returned if no detail level is specified. GetFeedback

DetailLevel: none, ReturnAll

Conditionally This type is used by the FeedbackPeriod containers that are returned in the GetFeedback call to indicate how many Negative, Neutral, Positive, Retracted, and Total Feedback entries a user has received within different periods of time, typically 30 days, 180 days, and 365 days. This integer value indicates the total number of days in the time period for the Feedback count. Typically, the returned time periods are 30 days, 180 days, and 365 days. This field is always returned with the FeedbackPeriod container. GetFeedback

DetailLevel: none, ReturnAll

Conditionally This integer value indicates the total number of Feedback entries that occurred within the time period specified in the PeriodInDays field. This field is always returned with the FeedbackPeriod container. GetFeedback

DetailLevel: none, ReturnAll

Conditionally Applicable to sites that support the Detailed Seller Ratings feature. The FeedbackRatingDetailCodeType is the list of areas for detailed seller ratings. When buyers leave an overall Feedback rating (positive, neutral, or negative) for a seller, they also can leave ratings in four areas: item as described, communication, shipping time, and charges for shipping and handling. Users retrieve detailed ratings as averages of the ratings left by buyers. Detailed seller rating in the area of "item as described." Detailed seller rating in the area of "communication." Detailed seller rating in the area of "shipping time." Inapplicable to motor vehicle items. Detailed seller rating in the area of "charges for shipping and handling." Inapplicable to motor vehicle items. (out) Reserved for internal or future use. The color of a feedback score star visually denotes the range in which the member's summary feedback score falls. The score is the net positive feedback minus the net negative feedback left for the member. No graphic displayed, feedback score 0-9. Yellow Star, feedback score 10-49. Blue Star, feedback score 50-99. Turquoise Star, feedback score 100-499. Purple Star, feedback score 500-999. Red Star, feedback score 1,000-4,999 Green Star, feedback score 5,000-9,999. Yellow Shooting Star, feedback score 10,000-24,999. Turquoise Shooting Star, feedback score 25,000-49,999. Purple Shooting Star, feedback score 50,000-99,999. Red Shooting Star, feedback score 100,000-499,999. Green Shooting Star, feedback score 500,000-999,999. Silver Shooting Star, feedback score 1,000,000 and above. Reserved for internal or future use. This enumerated type is used to indicate the type of response to a Feedback entry. This enumeration value is used in the ResponseType field of a RespondToFeedback call if the user is replying to a Feedback entry left by another user. This enumeration value is used in the ResponseType field of a RespondToFeedback call if the user is following up on a Feedback entry comment left by another user. Reserved for future use. This enumerated type is used to indicate the length of the time period for which Detailed Seller Ratings are evaluated under the AverageRatingSummary container returned in the GetFeedback call. This enumeration value indicates that the Detailed Seller Rating statistics shown under each AverageRatingDetails container were compiled over the last 30 days. This enumeration value indicates that the Detailed Seller Rating statistics shown under each AverageRatingDetails container were compiled over the last 52 weeks, or one year. Reserved for internal or future use. Specifies all feedback summary information (except Score). Contains FeedbackPeriodArrayType objects that each convey feedback counts for positive, negative, neutral, and total feedback counts - for various time periods each. Also conveys counts of bid retractions for the predefined time periods. Bid retractions count, for multiple predefined time periods preceding the call. Returned if no detail level is specified. GetFeedback

DetailLevel: none, ReturnAll

Conditionally Negative feedback entries count, for multiple predefined time periods preceding the call. Returned if no detail level is specified. GetFeedback

DetailLevel: none, ReturnAll

Conditionally Neutral feedback entries count, for multiple predefined time periods preceding the call. Returned if no detail level is specified. GetFeedback

DetailLevel: none, ReturnAll

Conditionally Positive feedback entries count, for multiple predefined time periods preceding the call. Returned if no detail level is specified. GetFeedback

DetailLevel: none, ReturnAll

Conditionally Total feedback score, for multiple predefined time periods preceding the call. Returned if no detail level is specified. GetFeedback

DetailLevel: none, ReturnAll

Conditionally Number of neutral comments received from suspended users. Returned if no detail level is specified. GetFeedback

DetailLevel: none, ReturnAll

Conditionally Total number of negative Feedback comments, including weekly repeats. Returned if no detail level is specified. GetFeedback

DetailLevel: none, ReturnAll

Conditionally Total number of positive Feedback comments, including weekly repeats. Returned if no detail level is specified. GetFeedback

DetailLevel: none, ReturnAll

Conditionally Total number of neutral Feedback comments, including weekly repeats. Returned if no detail level is specified. GetFeedback

DetailLevel: none, ReturnAll

Conditionally Container for information about detailed seller ratings (DSRs) that buyers have left for a seller. Sellers have access to the number of ratings they've received, as well as to the averages of DSRs they've received in each DSR area (i.e., to the average of ratings in the item-description area, etc.). The DSR feature is available everywhere on API-enabled country sites, including the US site (site ID 0). Seller ratings https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/feedback-seller-ratings.html GetFeedback Conditionally

DetailLevel: none, ReturnAll

Container for information about 1 year feedback metric as seller. GetFeedback Conditionally

DetailLevel: none, ReturnAll

Container for information about 1 year feedback metric as buyer. GetFeedback Conditionally

DetailLevel: none, ReturnAll

This enumerated type consists of the values that may be used in the request of a GetFeedback call in order to retrieve a specific type of Feedback. This enumeration value will be used in the FeedbackType field of a GetFeedback call if the user only wants to retrieve the Feedback data that they have received acting as a seller. This enumeration value will be used in the FeedbackType field of a GetFeedback call if the user only wants to retrieve the Feedback data that they have received acting as a buyer. This enumeration value will be used in the FeedbackType field of a GetFeedback call if the user wants to retrieve the Feedback data that they have received acting as a seller and buyer. This enumeration value will be used in the FeedbackType field of a GetFeedback call if the user wants to retrieve the Feedback they have left for their order partners while acting as a seller or buyer. Reserved for internal or future use. This enumerated type contains values that indicate the current status of the seller's account for the fee netting mechanism. With fee netting, some selling fees like final value fee and payment processing fee will be deducted from seller payouts instead of eBay invoicing the seller for the fees. This value indicates that the account is enabled for the fee netting mechanism. If a user sees this value, the GetAccount response will include the AccountSummary.NettedTransactionSummary container and the AccountEntry.Netted boolean field for each account entry. This value indicates that the account is not enabled for the fee netting mechanism. . This value indicates that the account is exempted from the fee netting mechanism. Type used to express all fees associated with listing an item. These are the fees that the seller will pay to eBay. A Fee container is returned for each listing fee associated with listing an item. Each Fee container consists of the fee type, the amount of the fee, and any applicable eBay promotional discount on that listing fee. A Fee container is returned for each listing feature, even if the associated cost is 0. AddFixedPriceItem AddItem AddItems AddLiveAuctionItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem ReviseLiveAuctionItem VerifyAddFixedPriceItem VerifyAddItem ReviseInventoryStatus VerifyRelistItem Always Details of an individual discount profile defined by the user for flat-rate shipping. The type of discount or rule that is being used by the profile. The value corresponding to the selected rule is set in the same-named field of FlatShippingDiscount.DiscountProfile. GetShippingDiscountProfiles EachAdditionalAmount, EachAdditionalAmountOff, EachAdditionalPercentOff Conditionally SetShippingDiscountProfiles EachAdditionalAmount, EachAdditionalAmountOff, EachAdditionalPercentOff Conditionally GetItem EachAdditionalAmount, EachAdditionalAmountOff, EachAdditionalPercentOff

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Shipping discount profiles https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-discount-profiles.html Details of this particular flat-rate shipping discount profile. If the value of ModifyActionCode is <code>Modify</code>, all details of the new version of the profile must be provided. If ModifyActionCode is <code>Delete</code>, DiscountProfileID is required, MappingDiscountProfileID is optional, and all other fields of DiscountProfile are ignored. GetShippingDiscountProfiles Conditionally SetShippingDiscountProfiles EachAdditionalAmount, EachAdditionalAmountOff, EachAdditionalPercentOff Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Shipping discount profiles https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-discount-profiles.html Type defining the FreeGalleryPlusEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as <code>FreeGalleryPlusEnabled</code> is included as a FeatureID value in the call request, or no FeatureID values are passed into the call request). This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the Free Gallery Plus feature for one or multiple categories. Type defining the FreePicturePackEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as <code>FreePicturePackEnabled</code> is included as a FeatureID value in the call request, or no FeatureID values are passed into the call request). This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the Free Picture Pack feature for one or multiple categories. This type is used to provide details about an order line item being fulfilled by eBay or an eBay fulfillment partner. The value returned in this field indicates the party that is handling fulfillment of the order line item. For eBay Vault scenarios, for the GetOrders GetItemTransactions, and GetSellerTransactions calls, this value is returned as <code>EBAY</code> for either of the following fulfillment options:<ul><li>Vault to Vault</li><li>Vault to Buyer</li></ul> GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The value in this field identifies the warehouse where the order line item is located. For eBay Vault scenarios: GetOrders and GetSellerTransactions calls, if FulfillmentBy is returned as <code>EBAY</code>, FulfillmentRefId is not returned. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Enumeration type that returns the status of the gallery image generation. That status returns either a value of 'Success' or a value that indicates why the gallery image has not been generated. The Gallery image was successfully generated. The Gallery image has not yet been generated. The URL for the image file is not valid. The URL does not start with <code>http:// </code> or <code>https:// </code>. There is a problem with the image file. The server containing the image file was unavailable. The image file could not be found. The image file failed to transfer. The image file is not in JPG, BMP, GIF, TIF, or PNG format. We were not able to process the image file. Reserved for internal only. Indicates which Gallery image enhancements to apply to the listing. Featured Gallery is supported free on all sites. So this field is useful only for removing an existing feature setting when using RelistItem. Highlights the listing by randomly placing it at the top of the search results. When the Featured First listing upgrade is selected for an item listing, the listing also automatically gets the Gallery and Plus functionality at no extra cost. A user can see if a site supports the Featured First listing upgrade by using the GeteBayDetails call and passing in <code>ListingFeatureDetails</code> in the DetailName field. In the response, the value of the ListingFeatureDetails.FeaturedFirst field will show a value other than <code>Disabled</code> if the eBay site supports the Featured First listing upgrade. Note: The Featured First listing upgrade can no longer be used for new listings or revising existing listings in any eBay marketplace. If this value is used in an Add/Revise/Relist call, sellers will get a warning message about this value/feature being deprecated. This feature, which is free on all sites, adds a Gallery image in the search results. A Gallery image is an image that was uploaded and copied to EPS (eBay Picture Service). This copy is stored for 30 days or until the image is associated with a listing. Once the image is associated with a listing, the period is extended to 90 days after the item's sale_end date and is extended again if the item is relisted or used in subsequent listings. As part of storing a copy, EPS also makes additional sizes available (thumbnail, main image, supersize, popup, etc.), which are used by the various Gallery enhancements. All images must comply to the <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/pictures.html" target="_blank">Picture Requirements.</a> Adds a Gallery Plus icon to the listing. When Plus is selected in a request that specifies at least two images (using ItemType.PictureDetailsType.PictureURL), the Gallery Plus feature automatically includes a Gallery Showcase of all the listing's images. The Gallery Showcase displays when hovering over or clicking on the listing's Gallery Plus icon in the search results. The Showcase window displays a large (400px x 400px) preview image which is first image specified PictureURL, as well as up to 11 (64 px x 64 px) selectable thumbnails for the remaining EPS images. Clicking on the preview image displays the item's listing page. If Plus is selected and the request includes only one EPS image or any self-hosted images, the listing includes a Gallery Plus icon that, when hovered over or clicked, displays a large (400px x 400px) preview image of the item. Clicking the image displays the View Item page for that listing. When using RelistItem or ReviseItem (item has no bids and more than 12 hours before the listing's end), Plus can be unselected in the request. However, the Plus fee will still apply if a previous request selected Plus. There is at most one Plus fee per listing. When "Plus" is included in an item listing, the listing also automatically gets the Gallery functionality at no extra cost. "Gallery" does not need to be specified separately in the listing. Listing images that are originally smaller than 400px x 400px are centered in the preview frame. Images that are originally larger than 400px x 400px are scaled down to 400px on their longest side (maintaining their original aspect ratio). Reserved for internal use only. This enumerated type is used to indicate if an eBay site or category supports Motors National Listings and/or Motors Local Market listings. If this enumeration value is returned, the eBay site or category only supports Motors National Listings for the corresponding Motors dealer subscription level/type. If this enumeration value is returned, the eBay site or category only supports Motors Local Market Listings for the corresponding Motors dealer subscription level/type. If this enumeration value is returned, the eBay site or category supports Motors National Listings and Motors Local Market listing for the corresponding Motors dealer subscription level/type. Reserved for internal or future use. This enumerated type defines the values that can be used in the CallMode field of the GetAllBidders call request to control which type of auction bidders are returned in the response. This enumeration value is used if the user wants to retrieve all bidders on an active or recently-ended auction listing. This value can be used by any user, and it is the default value if the CallMode field is not included in the call request. This enumeration value is used if the user wants to retrieve all non-winning bidders for a recently-ended auction listing. This value can be only be used by the seller of the item. This enumeration value is used if the user wants to retrieve all non-winning bidders, for a recently-ended auction listing, who are eligible for, and who accept Second Chance Offers. This value can be only be used by the seller of the item. See <a href="http://pages.ebay.com/help/sell/second_chance_offer.html#when" target="_blank">When to use a Second Chance Offer</a> for more information on Second Chance Offers. Reserved for internal or future use. Note: This enumerated type is deprecated as the Gift Icon feature is no longer available on any eBay Marketplace sites. The listing feature is enabled for the site. The listing feature is disabled for the site. Reserved for internal or future use. This type is used by the GiftSummary container that is returned in GetOrders and other order management calls if a buyer has purchased a digital gift card but has sent it to another individual as a gift. The GiftSummary container consists of the message that the buyer wrote for the recipient of the digital gift card. This free-form text contains the message that the purchaser of the digital gift card left for the recipient of the gift card. For GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, real data is only returned to the buyer or seller, and a string value of <code>Unavailable</code> will be returned to all third parties. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Specifies whether the Global Shipping Program (GSP) is enabled or not. The field is returned as an empty element (i.e., a boolean value is not returned). Specifies a predefined subset of fields to return. The predefined set of fields can vary for different calls. Only applicable to certain calls (see request types that include a GranularityLevel property). For calls that support this filter, see the <a href="https://developer.ebay.com/api-docs/user-guides/static/make-a-call/tapi-input-data.html#details">Standard input data</a> section of the Making a Trading API call guide for a list of the output fields that are returned for each level. Only one level can be specified at a time. For GetSellerList, use DetailLevel or GranularityLevel in a given request, but not both. For GetSellerList, if GranularityLevel is specified, DetailLevel is ignored. (in) For each record in the response, retrieves less data than Medium. See the <a href="https://developer.ebay.com/api-docs/user-guides/static/make-a-call/tapi-input-data.html#details">Standard input data</a> section of the Making a Trading API call guide for a list of the output fields that are returned when this level is specified. For each record in the response, retrieves more data than Medium. See the <a href="https://developer.ebay.com/api-docs/user-guides/static/make-a-call/tapi-input-data.html#details">Standard input data</a> section of the Making a Trading API call guide for a list of the output fields that are returned when this level is specified. For each record in the response, retrieves more data than Coarse and less data than Fine. See the <a href="https://developer.ebay.com/api-docs/user-guides/static/make-a-call/tapi-input-data.html#details">Standard input data</a> section of the Making a Trading API call guide for a list of the output fields that are returned when this level is specified. About shipping service group 1. About shipping service group 2. About shipping service group 3. How packaging/handling cost is to be determined for <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manage-fulfill-combine-invoices.html">Combined Invoice</a> orders. After eBay assigns the highest packaging/handling cost to the first item, the packaging/handling cost for each additional item is $n. After eBay assigns the highest packaging/handling cost to the first item, the packaging/handling cost for each additional item is to be reduced by amount N. After eBay assigns the highest packaging/handling cost to the first item, the packaging/handling cost for each additional item is to be reduced by N percent. The total packaging/handling cost is to be the sum of the packaging/handling costs of the individual items. The packaging/handling cost is to be N for the entire order. Reserved for internal or future use. Defines the feature that specifies whether a handling time (dispatch time) could be enabled on the site. Type defining the Pictograms and Statements containers, and the Component and SignalWord fields, that provide hazardous material related information. For additional information, see <a href="https://developer.ebay.com/api-docs/sell/static/metadata/feature-regulatorhazmatcontainer.html#Signal" target="_blank">Signal word information</a>. This container is used by the seller to provide pictograms for the listing. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem GetItems Conditionally This field sets the signal word for hazardous materials in the listing. If your product contains hazardous substances or mixtures, please select a value corresponding to the signal word that is stated on your product's Safety Data Sheet. The selected hazard information will be displayed on your listing. Example values include: <ul><li> <code>Danger</code></li><li> <code>Warning</code></li></ul>Note: Use the <a href="https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getHazardousMaterialsLabels">getHazardousMaterialsLabels</a> method in the <a href="https://developer.ebay.com/api-docs/sell/metadata/resources/methods">Metadata API</a> to find supported values for a specific marketplace/site. For additional information, see <a href="https://developer.ebay.com/api-docs/sell/static/metadata/feature-regulatorhazmatcontainer.html#Signal" target="_blank">Signal word information</a>. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem GetItems Conditionally This container is used by the seller to provide hazard statements for the listing. This field is required if hazmat information is supplied. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally This field is used by the seller to provide component information for the listing. For example, component information can provide the specific material of Hazmat concern. 120 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem GetItems Conditionally Note: This enumerated type is deprecated as the Highlighted listing feature is no longer available on any eBay Marketplace sites. The listing feature is enabled for the site. The listing feature is disabled for the site. Reserved for internal or future use. Specifies whether a listing feature is available for the site specified in the request. The listing feature is enabled for the site. The listing feature is disabled for the site. Reserved for internal or future use. Defines whether Home Page Featured is available on the site. Note: This enumerated type is deprecated since it is only applicable to the eBay India site, and this marketplace is no longer available. Default Escrow timelines apply. Special Escrow timelines for Workflow A applies. Special Escrow timelines for Workflow B applies. (out) Reserved for internal or future use. Note: This type is deprecated since it is only applicable to the eBay India site, and this marketplace is no longer available. Type defining the ISBNEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as 'ISBNEnabled' is included as a FeatureID value in the call request or no FeatureID values are passed into the call request). This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the ISBN product identifying feature. To verify if a specific eBay site supports the ISBN product identifying feature (for most categories), look for a 'true' value in the SiteDefaults.ISBNEnabled field. To verify if a specific category on a specific eBay site supports the ISBN product identifying feature, pass in a CategoryID value in the request, and then look for a <code>true</code> value in the ISBNEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Enumerated type that defines the possible states of a buyer's Item Not Received (INR) inquiry. This value indicates that the INR inquiry is invalid. This value indicates that the INR inquiry is not applicable. This value indicates that the INR inquiry is pending a response from the buyer. This value indicates that the INR inquiry is pending a response from the seller. This value indicates that the INR inquiry was closed with a refund issued to the buyer. This value indicates that the INR inquiry was closed with no refund issued to the buyer. This value indicates that the INR inquiry was escalated to an eBay Money Back Guarantee case, and it is pending a response from the buyer. This value indicates that the INR inquiry was escalated to an eBay Money Back Guarantee case, and it is pending a response from the seller. This value indicates that the INR inquiry was escalated to an eBay Money Back Guarantee case, and it is pending a response from eBay Customer Support. This value indicates that the INR inquiry was escalated to an eBay Money Back Guarantee case, but it was closed with a refund issued to the buyer. This value indicates that the INR inquiry was escalated to an eBay Money Back Guarantee case, but it was closed with no refund issued to the buyer. Reserved for internal or future use. This type is no longer applicable as eBay sellers can no longer use iMCC gateway accounts to handle buyer payments, and the SellerInfo.IntegratedMerchantCreditCardInfo container is no longer returned in GetUser response. The SellerInfo.IntegratedMerchantCreditCardInfo container (and this field) are no longer returned in GetUser response, as eBay sellers can no longer use iMCC gateway accounts to handle buyer payments. GetUser Conditionally This type defines the available options the seller has for handling international returns. Defines the available options the seller has for handling international returns in the specified marketplace and category. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally In US, sellers can offer an item replacement for returns, in addition to offering money back returns. The values returned in this field indicate the availability of such options for the given marketplace and category. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated category, which indicates that items listed in the category must include a return policy. The values returned in this field are valid in AddItem and its related family of calls, and in the return policies you configure for use with the Account API. This type defines the available options the seller has for accepting international returns. Defines the available options the seller has for accepting international returns in the specified marketplace and category. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally The values returned in this field indicate whether or not the seller can offer international returns. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated category, which indicates that items listed in the category must include a return policy. The values returned in this field are valid in AddItem and its related family of calls, and in the return policies you configure for use with the Account API. This type defines the available options for the return durations for international returns. Defines the available options for the return durations for international returns in the specified marketplace and category. This is the time the buyer has to initiate a return once they receive the item. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally The values returned in this field indicate the return-duration options that are available for international returns for items listed in the associated marketplace and category. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated category, which indicates that items listed in the category must include a return policy. The values returned in this field are valid in AddItem and its related family of calls, and in the return policies you configure for use with the Account API. This type defines the available options for who pays the return shipping costs for international returns. Defines the available options for who pays the return shipping costs for international returns in the specified marketplace and category. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally The values returned in this field indicate the available options for who pays the return shipping for international returns. Possible values are <code>BUYER</code> and <code>SELLER</code>. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated category, which indicates that items listed in the category must include a return policy. The values returned in this field are valid in AddItem and its related family of calls, and in the return policies you configure for use with the Account API. Container consisting of shipping costs and other details related to an international shipping service. If one or more international shipping services are provided, the seller must specify at least one domestic shipping service as well. An international shipping service being offered by the seller to ship an item to a buyer. For a list of valid values, call GeteBayDetails with DetailName set to ShippingServiceDetails. To view the full list of International shipping service options in the response, look for the ShippingService fields in the ShippingServiceDetails containers that contain a InternationalService = <code>true</code> field, as this indicates that the ShippingService value is an International shipping service option. 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. For flat and calculated shipping. ShippingServiceCodeType SendInvoice No AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally GeteBayDetails https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GeteBayDetails.html The base cost of shipping the item using the shipping service specified in the ShippingService field. In the case of a multiple-quantity, fixed-price listing, the ShippingServiceAdditionalCost field shows the cost to ship each additional item if the buyer purchases multiple quantity of the same line item. When returned by GetItemShipping, it includes the packaging and handling cost. For flat and calculated shipping. If a shipping service has been specified (even LocalPickup), GetItem returns the shipping service cost, even if the cost is zero. Otherwise, cost is not returned. If this is for calculated shipping for a listing that has not yet ended, note that the cost cannot be determined until the listing has ended and the buyer has specified a postal code. For GetItemShipping, promotional shipping savings is reflected in the cost, if applicable. If the promotional shipping option is lower than other shipping services being offered, the savings is reflected in the returned shipping cost. The shipping service named Promotional Shipping Service (or whatever is the localized name for it) is included among the shipping services. If the promotional shipping cost is lower than the cost of other shipping services being offered, it is presented first in the list. (The LOWEST shipping service cost is always presented first, regardless of whether there is promotional shipping.) SendInvoice No AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList GetItemShipping Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally Shipping types https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-types-rates.html The cost of shipping each additional item if the same buyer purchases multiple quantity of the same line item. This field is required when creating a multiple-quantity, fixed-price listing. Generally, the seller will give the buyer a shipping discount if that buyer purchases multiple quantity of the item, so this value should usually be less than the value set for ShippingServiceCost. The value of this field can even be set to <code>0</code> if the seller wants to encourage buyers to buy multiple quantity of the item, or it could be that the seller can fit multiple quantities of the line item in a single shipping package, so the seller is just passing this shipping savings onto the buyer. This field is not applicable for single-quantity listings. SendInvoice No AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList GetItemShipping Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally This integer value controls the order (relative to other shipping services) in which the corresponding ShippingService will appear in the View Item and Checkout page. Sellers can specify up to five international shipping services (with five InternationalShippingServiceOption containers), so valid values are 1, 2, 3, 4, and 5. A shipping service with a ShippingServicePriority value of <code>1</code> appears at the top. Conversely, a shipping service with a ShippingServicePriority value of 5 appears at the bottom of a list of five shipping service options. If the Global Shipping Program is enabled on the listing for international shipping, only four additional shipping services may be specified. If this field is omitted from international shipping service options, the order of the shipping service options in View Item and Checkout pages will be determined by the order that these shipping service options are presented in the request payload of an Add/Revise/Relist call. SendInvoice No AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally An international location or region to where the item seller will ship the item. Use GeteBayDetails with DetailName set to ShippingLocationDetails to determine which locations are valid per site. In the GeteBayDetails response, look for the ShippingLocationDetails.ShippingLocation fields. For the AddItem family of calls, this field is required if any international shipping service is specified. For GetOrders and GetItemTransactions only: If using Trading WSDL Version 1019 or above, ShipToLocation fields will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, ShipToLocation fields are only returned to the buyer or seller, and a string value of <code>Unavailable</code> will be returned to all third parties. ShippingRegionCodeType, CountryCodeType SendInvoice No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-info.html Shipping information The total cost of customs and taxes for the international leg of an order shipped using the Global Shipping Program. This amount is calculated and supplied for each item by the international shipping provider when a buyer views the item properties. 0 GetItemShipping Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally The last time of day that an order using the specified shipping service will be accepted by the seller. The cut off time applies and is returned only when the ShippingService field contains the name of a qualifying time-sensitive shipping service, such as <code>eBayNowImmediateDelivery</code>. The cut off time is set by eBay and determined in part by the policies and locations of the seller and the shipping carrier. GetItemShipping Conditionally This is used in the ReviseInventoryStatus response to provide the set of fees associated with each unique ItemID. The unique identifier of the listing being changed. The ReviseInventoryStatus response includes a separate set of fees for each item that was successfully revised. Use the ItemID to correlate the Fees data with the Inventory Status data in the response. ReviseInventoryStatus Always Contains the data for one fee (such as name and amount). ReviseInventoryStatus Always This type is used by the ReviseInventoryStatus call to update the price and/or quantity of an item or an item variation within a single-variation or multiple-variation, fixed-price listing. This value is the seller-defined SKU value of the item being revised. For a single-variation listing, either the ItemID of the listing or the SKU value of the item (if it exists) is required, and which one to use will depend on the value of the InventoryTrackingMethod setting. If the value of InventoryTrackingMethod is <code>ItemID</code>, the ItemID field should be used. If the value of InventoryTrackingMethod is <code>SKU</code>, the SKU field should be used. <code>ItemID</code> is the default value of InventoryTrackingMethod, and its value can only be set/changed to <code>SKU</code> through either an AddFixedPriceItem or RelistFixedPriceItem call. For a multiple-variation listing, the SKU value of the item variation is required in order to identify a specific item variation. An ItemID field is also required if the InventoryTrackingMethod value is set to <code>ItemID</code>. However, if the InventoryTrackingMethod value is set to <code>SKU</code>, only the SKU value of the item variation is needed to identify a specific item variation. Note that a seller-defined SKU value is required when a seller creates a multiple-variation listing, regardless of whether they decide to track inventory by Item ID or SKU. Note: When using an LMS_REVISE_INVENTORY_STATUS upload feed in Sell Feed API to revise the price and/or quantity for multiple SKUs for a multiple-SKU listing, you must include both the ItemID and SKU values for each variation. See the <a href="https://developer.ebay.com/api-docs/sell/static/feed/trading-upload-flow.html#upload-flow">Upload flow</a> and <a href="https://developer.ebay.com/api-docs/sell/static/feed/lms-feeds-quick-reference.html#Trading">Inventory upload feed types</a> for more information. The SKU field is always returned in the response, and if a SKU value doesn't exist for a single-variation listing, it is returned as an empty tag. ReviseInventoryStatus Conditionally ReviseInventoryStatus Always The unique identifier of the listing being revised. For a single-variation listing, either the ItemID of the listing or the SKU value of the item (if it exists) is required, and which one to use will depend on the value of the InventoryTrackingMethod setting. If the value of InventoryTrackingMethod is <code>ItemID</code>, the ItemID field should be used. If the value of InventoryTrackingMethod is <code>SKU</code>, the SKU field should be used. <code>ItemID</code> is the default value of InventoryTrackingMethod, and its value can only be set/changed to <code>SKU</code> through either an AddFixedPriceItem or RelistFixedPriceItem call. For a multiple-variation listing, the SKU value of the item variation is required in order to identify a specific item variation. An ItemID field is also required if the InventoryTrackingMethod value is set to <code>ItemID</code>. However, if the InventoryTrackingMethod value is set to <code>SKU</code>, only the SKU value of the item variation is needed to identify a specific item variation. Note that a seller-defined SKU value is required when a seller creates a multiple-variation listing, regardless of whether they decide to track inventory by Item ID or SKU. Note: When using an LMS_REVISE_INVENTORY_STATUS upload feed in Sell Feed API to revise the price and/or quantity for multiple SKUs for a multiple-SKU listing, you must include both the ItemID and SKU values for each variation. See the <a href="/api-docs/sell/static/feed/trading-upload-flow.html#upload-flow">Upload flow</a> and <a href="/api-docs/sell/static/feed/lms-feeds-quick-reference.html#Trading">Inventory upload feed types</a> for more information. Please note that the same ItemID value can be used multiple times in the same call if you revise several item variations from the same multiple-variation listing. The ItemID field is always returned in the response, even if an ItemID value was not included in the request. ReviseInventoryStatus Conditionally ReviseInventoryStatus Always This field is used to update the price of a fixed-price item, or to update the price of an item variation within a multiple-variation listing. To update the price of an item variation, both the ItemID and SKU fields are required to identify the listing and the specific variation within that listing, respectively. In each InventoryStatus container, either StartPrice or Quantity (or both) are required. Note: The StartPrice field should no longer appear in the response payload. If it does appear, it can be ignored. Sellers can leverage the <a href="https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetItem.html">GetItem</a> call to verify that the requested price updates were successful. Insertion Fees http://pages.ebay.com/help/sell/insertion-fee.html eBay.com Listing Fees http://pages.ebay.com/help/sell/fees.html ReviseInventoryStatus Conditionally This field is used to update the quantity of a fixed-price listing, or to update the quantity of a variation within a multiple-variation listing. To update a variation, both the ItemID and SKU fields are required to identify the listing and the specific variation within that listing, respectively. In each InventoryStatus container, either StartPrice or Quantity (or both) are required. Note: The Quantity field should no longer appear in the response payload. If it does appear, it can be ignored. Sellers can leverage the <a href="https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetItem.html">GetItem</a> call to verify that the requested quantity updates were successful. ReviseInventoryStatus Conditionally Defines options to track a listing by the eBay item ID or the seller's SKU. In some calls, elements of this type are only returned in the response when the value is set to SKU on the item. Indicates the seller prefers to track the listing by its eBay item ID. This is the default for all listings. Indicates the seller prefers to track the listing by their own SKU. When you track by SKU, it means you can pass in your SKU instead of the eBay item ID in other calls that support SKU as an input field. If you choose SKU as your tracking preference for a listing, the value in Item.SKU must be unique across your active listings. You cannot create new listings with the same Item.SKU value while the listing is active (that is, until the existing listing with that SKU has ended). However, you can use ReviseInventoryStatus to update the quantity and/or price for the existing SKU as needed. When revising a listing where the InventoryTrackingMethod was set to SKU, you must pass in both the InventoryTrackingMethod tag (with the value set to SKU) and the SKU tag with the SKU value from your original listing. Reserved for internal or future use. Container for a list of items. Can contain zero, one, or multiple ItemType objects, each of which conveys the data for one item listing. Contains the data properties that define one item listing. GetSellerEvents and GetSellerList only return items if any are available for the seller within the time window specified in the request. Some optional fields are only returned if the seller defined them for the item. Some fields are only returned under particular conditions specified in the individual field descriptions. For example, a buyer's contact information might only be returned if the member who is making the request (as identified in the eBayAuthToken) has an order relationship with that buyer. For calls that support detail levels, the set of fields returned is also controlled by the value of DetailLevel in the request. For some calls, other parameters in the request can also control the data returned for each item. For example, GranularityLevel controls the fields to return for each item in the GetSellerList response. Note: When making a GetSellerList call, items that are on-hold due to an eBay policy violation will not be returned in the response. GetBidderList Always GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally 3000 GetMyeBayBuying BestOfferList BidList LostList UserDefinedList WatchList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList ScheduledList UnsoldList BidList

DetailLevel: none, ReturnAll

Conditionally This enumerated type list the possible status values regarding whether or not a buyer received an order line item within the estimated delivery date timeframe. BuyerIndicatedItemArrivedWithinEDDRange, BuyerIndicatedItemNotArrivedWithinEDDRange This value is for internal use only. This value is for internal use only. This value indicates that the buyer indicated that the order line item did arrive within the estimated delivery date when they left feedback for the transaction. This value indicates that the buyer indicated that the order line item did not arrive within the estimated delivery date when they left feedback for the transaction. Reserved for internal or future use. A collection of details about the Best Offers received for a specific item. Empty if there are no Best Offers. Includes the buyer and seller messages only if the <code>ReturnAll</code> detail level is used. A collection of details about the Best Offers received for a specific item. Empty if there are no Best Offers. Includes the buyer and seller messages only if the <code>ReturnAll</code> detail level is used. GetBestOffers

DetailLevel: none, ReturnAll

Conditionally 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. Indicates whether the eBay user is in the Buyer or Seller role for the corresponding Best Offer. GetBestOffers

DetailLevel: none, ReturnAll

Conditionally 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 detail level <code>ReturnAll</code> is used. Only returned if a Best Offer has been made. GetBestOffers

DetailLevel: none, ReturnAll

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

DetailLevel: none, ReturnAll

Conditionally This type is used by the ItemBidDetails container that is returned in GetAllBidders. The ItemBidDetails container shows a few details about a user's bid on an auction listing. An ItemBidDetails container is returned for each bid that a user makes during the life of an auction listing. An ItemBidDetails container will only be returned to the seller of the auction listing or to an actual bidder for the listing. The unique identifier of an item listed on the eBay site. Since a bidder's user information is anonymous, this tag will contain the real ID value only for that bidder, and the seller of an item that the user is bidding on. For all other users, the real ID value will be replaced with the anonymous value, according to these rules: When bidding on items listed on the US site: UserID is replaced with the value "a****b" where a and b are random characters from the UserID. For example, if the UserID = IBidALot, it might be displayed as, "I****A". Note that in this format, the anonymous bidder ID stays the same for every auction. (GetMyeBayBuying only) when bidding on items listed on the US site: UserID is replaced with the value "a****b" where a and b are random characters from the UserID. When bidding on items listed on the UK and AU sites: UserID is replaced with the value "Bidder X" where X is a number indicating the order of that user's first bid. For example, if the user was the third bidder, UserID = Bidder 3. Note that in this format, the anonymous bidder ID stays the same for a given auction, but is different for different auctions. For example, a bidder who is the third and then the seventh bidder in an auction will be listed for both bids as "Bidder 3". However, if that same bidder is the first bidder on a different auction, the bidder will be listed for that auction as "Bidder 1", not "Bidder 3". (GetMyeBayBuying only) when bidding on items listed on the UK and AU sites: UserID is replaced with the string "High Bidder". (GetBestOffers only) - all sites: The last part of the user ID is replaced with asterisks for users that submit best offers on an item. The seller of the item will be able to see the full User ID. https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/user-mgmt-anonymous-info.html Anonymous user information GetAllBidders Conditionally Unique identifier of the eBay category that the auction item is listed under. GetAllBidders Conditionally The total number of bids that the user has placed on the auction item. GetAllBidders Conditionally The eBay ID of the seller who listed the item. This will be returned with the anonymous value "Seller X", where X indicates where the seller falls in the sequence of sellers that the user has purchased items from. For example, if the seller is the third seller that the user has purchased items from, the value "Seller 3" is returned. Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/user-mgmt-anonymous-info.html Anonymous user information GetAllBidders Conditionally This timestamp indicates the date/time at which the user placed the last bid on the auction item. GetAllBidders Conditionally Used to indicate whether the parts compatibility feature is enabled for a category. Parts Compatibility is not supported for the given category. Parts Compatibility may be entered by application only for the given category. Entering parts compatibility by application specifies the assemblies (e.g., a specific year, make, and model of car) to which the item applies. Parts compatibility by application can be specified by listing with a catalog product that supports parts compatibility or by specifying parts compatibility by application manually ( Item.ItemCompatibilityList). Parts Compatibility may be entered by specification only for the given category. Entering parts compatibility by specification involves specifying the part's relevant dimensions or characteristics (e.g., Section Width, Aspect Ratio, Rim Diammeter, Load Index, and Speed Rating values for a tire) using attributes. (out) Reserved for internal or future use. Defines the parts compatibility feature. If the field is present, the corresponding feature applies to the site. The field is returned as an empty element (e.g., a boolean value is not returned). Parts compatibility listings contain information to determine the assemblies with which a part is compatible. For example, an automotive part or accessory listed witih parts compatibility can be matched with vehicles (e.g., specific years, makes, and models) with which the part or accessory can be used. There are two ways to enter parts compatibility: by application and by specification. <ul> <li> Entering parts compatibility by application specifies the assemblies (e.g., a specific year, make, and model of car) to which the item applies. This can be done automatically by listing with a catalog product that supports parts compatibility, or manually, using Item.ItemCompatibilityList when listing or revising an item. </li> <li>Entering parts compatibility by specification involves specifying the part's relevant dimensions and characteristics necessary to determine the assemblies with which the part is compatible (e.g., Section Width, Aspect Ratio, Rim Diammeter, Load Index, and Speed Rating values for a tire) using attributes.</li> </ul> A list of compatible applications specified as name and value pairs. Describes an assembly with which a part is compatible (i.e., parts compatibility by application). For example, to specify a part's compatibility with a vehicle, the name would map to standard vehicle characteristics (e.g., Year, Make, Model, Trim, and Engine). The values would describe the specific vehicle, such as a 2006 Honda Accord. Details for an individual compatible application, consisting of the name-value pair and related parts compatibility notes. When revising or relisting, the Delete field can be used to delete individual parts compatibility nodes. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally Product API ProductCompatibilities call reference https://developer.ebay.com/Devzone/product/CallRef/getProductCompatibilities.html information about retrieving parts compatibility details that correspond to eBay catalog products Set this value to true to delete or replace all existing parts compatibility information when you revise or relist an item. If set to true, all existing item parts compatibility nodes are removed from the listing. If new item compatibilities are specified in the request, they replace the removed compatibilities. Note: To ensure that buyer expectations are upheld, you cannot delete or replace an item parts compatibility list if the listing has bids or if the auction ends within 12 hours. false RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem Conditionally All information corresponding to an individual parts compatibility by application. Removes individual parts compatibility nodes from the compatibility list. Set to <code>true</code> within the compatibility to delete. Note: This field can only be used with Revise calls or when revising a template. If the listing has bids or ends within 12 hours, you cannot delete item parts compatibilities. false ReviseFixedPriceItem ReviseItem Conditionally A name-value pair describing a single compatible application. The allowed names and values are specific to the primary category in which the item is listed. For example, when listing in a Parts & Accessories category, where the applications are vehicles, the allowed names might include Year, Make, and Model, and the values would correspond to specific vehicles in eBay's catalog. For details and examples, see <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manually-specify-compatibility.html" target="_blank">Specify parts compatibility manually</a>. The eBay Germany, UK, France, Italy, Spain, and Australia sites support the use of K type vehicle numbers to specify vehicle parts compatibility. To use a K type number, set the Name field to "<code>KType</code>" and set the corresponding Value field to the appropriate K type number. The DE and UK eBay sites also support the use of an eBay Product ID (or ePID) number/value pair to specify motorcycle and scooter parts compatibility (currently, only DE supports scooter parts compatibily). To use an ePID number to specify part compatibilities, set the Name field to "<code>ePID</code>" and the corresponding Value field to the ePID number that matches the motorcycle for the part(s) you are listing. Motorcycle ePID numbers are provided by the Master Motorcycle List (MML) file, which contains the ePID numbers and their associated vehicle mappings). For motorcycles, an ePID number contains the vehicle make, model, CCM, year, and submodel data. Please use the following links to obtain the DE and UK MML data files: - DE seller help page: http://verkaeuferportal.ebay.de/fahrzeugteile-und-zubehoer-optimal-einstellen - UK seller help page: http://pages.ebay.co.uk/help/sell/contextual/master-motorcycle-list-manually.html AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally Product Metadata API Call Reference https://developer.ebay.com/DevZone/product-metadata/CallRef/index.html information on retrieving parts compatibility search names and corresponding values needed to specify compatibility by application manually GetItem Conditionally The seller may optionally enter any notes pertaining to the parts compatibility being specified. Use this field to specify the placement of the part on a vehicle or the type of vehicle a part fits. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally Specifies a predefined subset of item conditions. The predefined set of fields can vary for different calls. The seller specified the Item Condition as New, or did not specify a condition. (Excludes items that the seller listed as Used.) The seller specified the Item Condition as Used, or did not specify a condition. (Excludes items that the seller listed as New.) (out) Reserved for internal or future use. Type that represents the unique identifier for an eBay listing. Defines how a list of items should be returned. Specifies whether or not to include the container in the response. Set the value to true to return the default set of fields for the container. Not needed if you set a value for at least one other field in the container. If you set DetailLevel to ReturnAll, set Include to false to exclude the container from the response. GetMyeBayBuying GetMyeBaySelling No Specifies the listing type of items in the returned list. GetMyeBayBuying BestOfferList No Auction, FixedPriceItem, StoresFixedPrice, AdType GetMyeBaySelling ActiveList No Auction, FixedPriceItem, StoresFixedPrice, AdType Specifies the sort order of the result. Default is Ascending. GetMyeBayBuying BestOfferList BidList DeletedFromLostList DeletedFromWonList LostList WatchList WonList No GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList No GetItemsAwaitingFeedback No Specifies the time period during which an item was won or lost. Similar to the period drop-down menu in the My eBay user interface. For example, to return the items won or lost in the last week, specify a DurationInDays of 7. 0 60 GetMyeBayBuying BestOfferList DeletedFromLostList DeletedFromWonList LostList WonList No GetMyeBaySelling SoldList UnsoldList No Specifies whether or not to include Item.PrivateNotes and Item.eBayNotes in the response. GetMyeBayBuying BestOfferList BidList DeletedFromWonList DeletedFromLostList LostList WatchList WonList No GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList No false Specifies how to create virtual pages in the returned list. Default for EntriesPerPage with GetMyeBayBuying is 200. GetMyeBayBuying BestOfferList BidList DeletedFromLostList DeletedFromWonList LostList WatchList WonList No GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList No Filter to reduce the SoldList response based on whether the seller (or eBay) marked the applicable order as Paid and/or Shipped in My eBay. Sellers can use CompleteSale or My eBay to mark an order as Paid or Shipped. GetMyeBaySelling SoldList All No Specifies the details of policy violations if the item was administratively canceled. The details are the policy ID and the policy text. Policy ID of the violated policy which resulted in item being administratively canceled. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Brief information of the violated policy which resulted in item being administratively canceled. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Type used by the SellerItemRatingDetailArray container in the LeaveFeedback request payload. This container is used by an eBay buyer to leave one or more Detailed Seller Ratings for their order partner concerning an order line item. The ItemRatingDetails container is used by an eBay buyer to leave a Detailed Seller Rating for their order partner concerning an order line item. Detailed Seller Ratings are left concerning Communication, Item as Described, Shipping and Handling Charges, and Shipping Time. The buyer gives the seller a rating between 1 to 5 (5 being the best) in these areas. Applicable to sites that support the Detailed Seller Ratings feature. LeaveFeedback No Applicable to sites that support the Detailed Seller Ratings feature. The ItemRatingDetailsType contains detailed seller ratings for an order line item in one area. When buyers leave an overall Feedback rating (positive, neutral, or negative) for a seller, they also can leave ratings in four areas: item as described, communication, shipping time, and charges for shipping and handling. Users retrieve detailed ratings as averages of the ratings left by buyers. The area of a specific detailed seller rating for an order line item. When buyers leave an overall Feedback rating (positive, neutral, or negative) for a seller, they also can leave ratings in four areas: item as described, communication, shipping time, and charges for shipping and handling. LeaveFeedback No A detailed seller rating for an order line item applied to the area in the corresponding RatingDetail field. Valid input values are numerical integers 1 though 5. LeaveFeedback No This enumerated type contains the possible values that can be used when sorting results in the GetItemsAwaitingFeedback, GetMyeBayBuying, and GetMyeBaySelling calls. Assume that each of sort values can be used in any of the three calls above unless it is specifically called out that a certain enumeration value will not work/is not applicable to a call. ClassifiedAdPayPerLeadFee, ClassifiedAdPayPerLeadFeeDescending, WonPlatform, SoldPlatform, WonPlatformDescending, SoldPlatformDescending This enumeration value is used to sort listings and orders according to Item ID value in ascending order. This enumeration value is used to sort listings according to item price value in ascending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is used to sort listings or orders according to the starting price value in ascending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is used to sort listings or orders according to listing title in ascending (alphabetical) order. This enumeration value is used to sort auction listings according to the number of bids received in ascending order. This enumeration value is only applicable to auction listings, and is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is used to sort fixed-price listings and orders according to item quantity in ascending order. This enumeration value is only applicable to fixed-price listings, and is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is used to sort listings and orders according to start time in ascending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is used to sort listings and orders according to end time in ascending order. This enumeration value is used to sort listings and orders according to the seller's user ID in ascending (alphabetical) order. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBaySelling calls. This enumeration value is used to sort active listings and orders according to the time left before listing ends (in ascending order). This enumeration value is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is used by the GetMyeBaySelling call to sort listings according to the listing duration in ascending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used to sort listings and orders according to the listing type in ascending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is used to sort listings and orders according to the current/final price in ascending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is used to sort auction listings and orders according to the reserve price in ascending order. This enumeration value is only applicable when a seller wants to retrieve information on their own auction listings that have reserve prices set on them. This enumeration is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used by a buyer to sort auction listings and orders according to the maximum bid price that they placed on an auction listing in ascending order. This enumeration value is only applicable to auction listings, and is not applicable to the GetItemsAwaitingFeedback or GetMyeBaySelling calls. This enumeration value is used to sort auction listings according to the number of unique bidders in ascending order. This enumeration value is only applicable to auction listings, and is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used to sort auction listings according to the user ID of the highest bidder in ascending order. This enumeration value is only applicable to auction listings, and is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used by the GetMyeBaySelling call to sort listings according to the buyer's user ID in ascending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used by the GetMyeBaySelling call to sort listings according to the buyer's location in ascending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used by the GetMyeBaySelling call to sort listings according to the buyer's email address in ascending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls, and a buyer's email address will only be exposed to the seller within two weeks of order purchase. This enumeration value is used by the GetMyeBayBuying call to sort listings and orders according to the seller's email address in ascending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBaySelling calls. This enumeration value is used to sort orders according to item price value in ascending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is used by the GetMyeBaySelling call to sort listings and orders according to the number of users watching the listing in ascending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used by the GetMyeBaySelling call to sort active listings according to the number of Best Offers that the listing has received in ascending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used by the GetMyeBaySelling call to sort listings and orders according to the number of questions that the listing has received in ascending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used to sort orders according to the cost to ship one unit of the order line item in ascending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is used to sort orders according to the type of feedback that a user received in ascending order. The Feedback ratings are defined in CommentTypeCodeType. This enumeration value is used to sort orders according to the type of feedback that a user left for another user in ascending order. The Feedback ratings are defined in CommentTypeCodeType. This enumeration value is used to sort listings and orders according to the eBay user ID of the order partner/owner of listing in ascending order. This enumeration value is used by the GetMyeBaySelling call to sort order line items according to the quantity sold in ascending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used by the buyer in a GetMyeBayBuying call to sort all Best Offers made in ascending order according to the dollar amount of the Best Offer. This sort option is only applicable if the buyer has at least one pending Best Offer on an order line item. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBaySelling calls. This enumeration value is used to sort order line items according to quantity available for purchase in ascending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback call, and it is only relevant to the WatchList container of the GetMyeBayBuying call. This enumeration value is used to sort purchased line items according to the quantity purchased by the buyer in ascending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is no longer applicable as Half.com has been shut down, and eBay marketplace is the only remaining platform. This enumeration value is no longer applicable as Half.com has been shut down, and eBay marketplace is the only remaining platform. This enumeration value is used by the GetMyeBaySelling call to sort listings according to the listing duration in descending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used to sort listings and orders according to the listing type in descending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is used to sort listings and orders according to the current/final price in descending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is used by the GetMyeBaySelling call to sort auction listings and orders according to the reserve price in descending order. This enumeration value is only applicable when a seller wants to retrieve information on their own auction listings that have reserve prices set on them. This enumeration is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used by the GetMyeBayBuying call to sort auction listings and orders according to the maximum bid price that a buyer placed on an auction listing in descending order. This enumeration value is only applicable to auction listings, and is not applicable to the GetItemsAwaitingFeedback or GetMyeBaySelling calls. This enumeration value is used by the GetMyeBaySelling call to sort auction listings according to the number of unique bidders in descending order. This enumeration value is only applicable to auction listings, and is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used by the GetMyeBaySelling call to sort auction listings according to the user ID of the highest bidder in descending order. This enumeration value is only applicable to auction listings, and is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used by the GetMyeBaySelling call to sort listings according to the buyer's user ID in descending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used by the GetMyeBaySelling call to sort listings according to the buyer's location in descending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used by the GetMyeBaySelling call to sort listings according to the buyer's email address in descending order. A buyer's actual email address will only be exposed to the seller within two weeks of order purchase. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used by the GetMyeBayBuying call to sort listings and orders according to the seller's email address in descending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBaySelling calls. This enumeration value is used to sort orders according to item price value in descending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is used by the GetMyeBaySelling call to sort listings and orders according to the number of users watching the listing in descending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used by the GetMyeBaySelling call to sort listings and orders according to the number of questions that the listing has received in descending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used to sort orders according to the cost to ship one unit of the order line item in descending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is used to sort orders according to the type of feedback that a user received in descending order. The Feedback ratings are defined in CommentTypeCodeType. This enumeration value is used to sort orders according to the type of feedback that a user left for another user in descending order. The Feedback ratings are defined in CommentTypeCodeType. This enumeration value is used to sort listings and orders according to the eBay user ID of the order partner/owner of listing in descending order. This enumeration value is used by the GetMyeBaySelling call to sort order line items according to the quantity sold in descending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used by the GetMyeBaySelling call to sort active listings according to the number of Best Offers that the listing has received in descending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used to sort order line items according to quantity available for purchase in descending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback call, and it is only relevant to the WatchList container of the GetMyeBayBuying call. This enumeration value is used to sort purchased line items according to the quantity purchased by the buyer in descending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is used by the GetMyeBayBuying call to sort all Best Offers made in descending order according to the dollar amount of the Best Offer. This sort option is only applicable if the buyer has at least one pending Best Offer on an order line item. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBaySelling calls. This enumeration value is used to sort listings and orders according to Item ID value in descending order. This enumeration value is used to sort listings according to item price value in descending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is used to sort listings or orders according to the starting price value in descending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is used to sort listings or orders according to listing title in descending (alphabetical) order. This enumeration value is used to sort auction listings according to the number of bids received in descending order. This enumeration value is only applicable to auction listings, and is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is used to sort fixed-price listings and orders according to item quantity in descending order. This enumeration value is only applicable to fixed-price listings, and is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is used to sort listings and orders according to start time in descending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is used to sort listings and orders according to end time in descending order. This enumeration value is used by the GetMyeBayBuying call to sort listings and orders according to the seller's user ID in descending order. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBaySelling calls. This enumeration value is used to sort active listings and orders according to the time left before listing ends (in descending order). This enumeration value is not applicable to the GetItemsAwaitingFeedback call. This enumeration value is no longer applicable as Half.com has been shut down, and eBay marketplace is the only remaining platform. This enumeration value is no longer applicable as Half.com has been shut down, and eBay marketplace is the only remaining platform. This enumeration value is used by the seller of a classified ad listing in a GetMyeBaySelling call to sort classified ad listings according to the total number of leads (prospective buyer inquiries) in ascending order. Each lead involves an email to the buyer, and the LeadCount value includes read and unread emails. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used by the seller of a classified ad listing in a GetMyeBaySelling call to sort classified ad listings according to the number of new leads (prospective buyer inquiries) in ascending order. Each lead involves an email to the buyer, and the NewLeadCount value only includes unread emails. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used by the seller of a classified ad listing in a GetMyeBaySelling call to sort classified ad listings according to the total number of leads (prospective buyer inquiries) in descending order. Each lead involves an email to the buyer, and the LeadCount value includes read and unread emails. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. This enumeration value is used by the seller of a classified ad listing in a GetMyeBaySelling call to sort classified ad listings according to the number of new leads (prospective buyer inquiries) in descending order. Each lead involves an email to the buyer, and the NewLeadCount value only includes unread emails. This enumeration value is not applicable to the GetItemsAwaitingFeedback or GetMyeBayBuying calls. The pay-per-lead feature is no longer available, so this value is no longer applicable. The pay-per-lead feature is no longer available, so this value is no longer applicable. Reserved for internal or future use. This type is used by the ItemSpecificDetails container that is returned in the GeteBayDetails call. The ItemSpecificDetails container consists of maximum threshold values that must be adhered to when creating, revising, or relisting items with Item Specifics. Item Specifics are used to provide descriptive details of an item in a structured manner. This value is the maximum number of Item Specifics name-value pairs that can be used when creating, revising, or relisting an item on the specified site. Item Specifics are used to provide descriptive details of an item in a structured manner. Setting Item Specifics in AddItem AddItem.html#Request.Item.ItemSpecifics instructions on adding Item Specifics when creating a listing GeteBayDetails Conditionally This value is the maximum number of corresponding name values that can be used per Item Specific when creating, revising, or relisting an item on the specified site. An example of an Item Specific that might have multiple values is 'Features'. A product can have multiple features, hence multiple features can be passed in through multiple ItemSpecifics.NameValueList.Value fields. Once you know the site threshold, it can also be helpful to know specific Item Specifics in a category that can have more than one value, such as 'Features'. Multiple values can only be specified for an Item Specific if the corresponding <a href="https://developer.ebay.com/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory#response.aspects.aspectConstraint.itemToAspectCardinality" target="_blank">itemToAspectCardinality</a> field of the getItemAspectsForCategory method shows a value of <code>MULTI</code>. Setting one or more values for Item Specific in AddItem AddItem.html#Request.Item.ItemSpecifics.NameValueList.Value GeteBayDetails Conditionally This value is the maximum number of characters that can be used for an Item Specific value on the specified site. Setting Item Specific values in AddItem AddItem.html#Request.Item.ItemSpecifics.NameValueList.Value GeteBayDetails Conditionally This value is the maximum number of characters that can be used for an Item Specific name on the specified site. Setting Item Specific names in AddItem AddItem.html#Request.Item.ItemSpecifics.NameValueList.Name GeteBayDetails Conditionally This string indicates the version of the Item Specifics metadata. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always This timestamp indicates the date and time when the Item Specifics metadata was last updated. Time is in Greenwich Mean Time (GMT) time. This timestamp can be useful in determining if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always This enumerated type is used by GetItem, and indicates the source for an Item Specific. Attribute This enumeration value indicates that the corresponding Item Specific was specified by the seller in Add/Revise/Relist call or flow. In an Add/Revise/Relist API call, Item Specifics for a listing are specified through the ItemSpecifics.NameValueList or VariationSpecifics.NameValueList (for a variation in a multiple-variation listing) containers. This value is no longer applicable and should not be returned. This enumeration value indicates that the corresponding Item Specific was derived from a product in the eBay Catalog, and was automatically picked up by the listing when the seller created, revised, or relisted an item referencing and matching an eBay catalog product through the use of an ePID or GTIN value in the ProductListingDetails container. Reserved for future use. This enumerated type is used to indicate whether an eBay marketplace and/or category supports the use of Item Specifics when creating, revising, or relisting an item. This enumeration value indicates that the seller may not use Item Specifics for the specified eBay marketplace or corresponding category. This enumeration value indicates that the seller may use Item Specifics for the specified eBay marketplace or corresponding category. (out) Reserved for internal or future use. Defines the Item Specific feature. If the field is present, the corresponding feature applies to the site. The field is returned as an empty element (e.g., a boolean value is not returned). Contains the data defining one item. A seller populates an object of this type at listing time with the definition of a new item. A seller also uses an object of this type to relist or revise an item. Calls that retrieve item data (such as the GetSellerList call) return an object of this type, filled with the item's data. AttributeConversionEnabled, BasicUpgradePack, ClassifiedAdContactByEmailAvailable, ClassifiedAdMaximumBestOffersAllowed, ClassifiedAdPayPerLeadEnabled, CombinedFixedPriceTreatment, DepositSupported, DigitalDeliveryEnabled, DutchBINEnabled, EANIdentifierEnabled, ExpressConditionRequired Return custom, application-specific data associated with the item. The data you specify is stored by eBay with the item for your own reference, but it is not used by eBay in any way. Use ApplicationData to store special information for yourself, such as a part number. For a SKU in an eBay.com listing, use the SKU element instead. To remove this value when revising or relisting an item, use DeletedField. 32 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This field is included and set to if <code>true</code> in an Add/Revise/Relist call if the seller wants to require immediate payment from the buyer. If this field is set to <code>false</code> or not included, the seller is not requesting immediate payment. Note that this field may be set to <code>true</code>, but that does not necessarily mean that the buyer will be required to pay right away. For example, immediate payment is not currently applicable to auctions items won in a competitive bidding process or to items where the buyer and seller negotiated the price through the Best Offer feature. Immediate payment is also not applicable to listings where the payment happens offline between the buyer and seller. false AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Detailed information about a bid. For GetMyeBayBuying, returned as a self-closed element if no bids meet the request criteria. GetMyeBayBuying BidList LostList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling BidList

DetailLevel: none, ReturnAll

Conditionally The enumeration value returned in this field indicates whether an item is eligible for the buyer protection. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList Conditionally This field is only applicable for auction listings. By specifying a 'Buy It Now' price, a seller is allowing prospective buyers the opportunity to purchase the item in the auction listing at this price immediately. When a buyer uses the 'Buy It Now' option to purchase the item, the auction listing will end immediately. By including this field and specifying a 'Buy It Now' price, the seller is enabling the 'Buy It Now' feature on the auction listing. If the seller includes this field for any other listing type other than an auction, this field and its price will just be ignored. The price in this field must be at least 30 percent higher than the starting bid price (which is specified in an Add call through the Item.StartPrice field). Once a bid is made on an auction listing, and the bid meets or exceeds the Item.ReservePrice value (if set), the 'Buy It Now' option becomes unavailable, and this field will no longer be applicable. If there is no Reserve Price, the first bid will nullify the 'Buy It Now' option. Keep in mind that GetItem (and other 'Get' calls that retrieve the Item details) may still return the BuyItNowPrice field for an auction item even if the 'Buy It Now' option is no longer available. Instead, a user should look for the ListingDetails.BuyItNowAvailable boolean field in the GetItem response to determine if the 'Buy It Now' option is still available for the auction item. Note: For the US site, new eBay sellers are subject to <a href="https://developer.ebay.com/api-docs/user-guides/static/make-a-call/fg-replaced.html">Seller Limits</a>, which limit the quantity of items that may be listed and/or the total cumulative value of these listings. While subject to these selling limits, an eBay seller can use the GetMyeBaySelling call to retrieve both the remaining number of listings they can create and the remaining cumulative value of these listings. These values are shown in the Summary.QuantityLimitRemaining and Summary.AmountLimitRemaining fields in the GetMyeBaySelling response. If a call to add an item or revise an item would result in the exceeding of these limits, the add item or revise item call will fail. These fields will only be returned if the seller is subject to seller limits. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetBestOffers

DetailLevel: none, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Medium, Fine

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetMyeBayBuying WatchList BestOfferList BidList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerEvents

DetailLevel: ReturnAll

Conditionally Note: This field's value now defaults to <code>true</code> if this field is omitted. Previously, the default value was <code>false</code>, so a user had to include this field and set it to <code>true</code> in order for eBay to map an outdated Primary or Secondary Category ID to the updated Category ID. This boolean field controls whether or not eBay automatically maps outdated Category ID(s) specified in a PrimaryCategory and/or SecondaryCategory container(s) to the updatd Category ID(s) no longer exists in the current category structure: If you pass a value of <code>true</code> in CategoryMappingAllowed or just omit the field, eBay will look up the current Category ID(s) that have replaced the specified Category ID(s). If you pass a value of <code>false</code>, eBay will not do any mapping, and the call may fail if specified Category ID(s) are no longer valid IDs for a eBay leaf category. The new Category ID(s) will be returned in the CategoryID and Category2ID fields (if secondary category is used) of the Add/Revise/Relist call response. true AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No Maintaining Category Data https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/categories.html This container identifies the nonprofit organization that will benefit with a percentage of the proceeds from each sale of an item through an auction or fixed-price listing. Charity names and IDs can be found by going to <a href="https://charity.ebay.com/charity-auctions/my-causes" target="_blank">eBay for Charity</a> page and doing a search. The donation percentage can be set in 5 percent increments from 10 percent to 100 percent. When it comes to revising an auction or fixed-price listing, you can add a benefitting charity (as long as there is at least 12 hours left before end of listing/close of auction), but you cannot remove or change a nonprofit company once one is already established in the original listing. For Revise calls: The non-profit organization and donation percentage can now be modified in a Revise call as long as there are no active bids on an auction listing, or no pending Best Offers/Counter Offers on a listing. This container will only be returned in Get calls for charitable listings. Charitable listings are only supported in the following marketplaces: US, UK, CA, DE, and Motors. Buying and selling on eBay to benefit nonprofit organizations https://www.ebay.com/help/account/donating-ebay-charity/buying-selling-ebay-benefit-nonprofit-organizations?id=4668 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetItem

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Charitable listings https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/charitable-listings.html This two-digit enumeration value indicates the country where the item is located. CountryCodeType defines the supported values. The <a href="https://developer.ebay.com/DevZone/XML/docs/Reference/eBay/GeteBayDetails.html">GeteBayDetails</a> call can also be used (include the DetailName field and set its value to CountryDetails) to see the full list of supported country codes. In an Add/Revise/Relist/Verify call, this field is required. AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem Yes GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse

Conditionally RelistItem ReviseItem RelistFixedPriceItem ReviseFixedPriceItem VerifyRelistItem No GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally In an Add/Revise/Relist/Verify call, this required three-digit enumeration value defines the currency associated with the listing site. The item price and all costs passed in the call request will be using this currency. Similarly, the listing fees and other cost-related data will be using this currency. Since the Trading API can only be used for a select number of eBay sites, only a subset of values are supporting when adding/revising/relisting an item. These supported values are discussed in the top section of CurrencyCodeType. In 'Get' calls, it is possible that any of the values in CurrencyCodeType may appear, as some cost-related fields will show the buyer's currency type. AddFixedPriceItem AddItem AddItems AddFixedPriceItem VerifyAddFixedPriceItem VerifyAddItem Yes GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetBestOffers

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally The seller's description of the item. In listing requests, you can submit your description using CDATA if you want to use HTML or XML-reserved characters in the description. However, a seller can not use any active content in their listing description. Active content includes animation or video via JavaScript, Flash, plug-ins, or form actions. All active content will be blocked/removed from a listing. Removing/blocking active content will lead to faster load times of listings, make listings more mobile-friendly, improve SEO performance, and lead to a more secure eBay Marketplace. Note: To ensure that a listing description is optimized to be viewed on a mobile devices, see <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/mobile.html" target="_blank">Mobile device optimization</a> in the Trading User Guide. Note that the mobile-friendly description snippet feature described in this topic is currently only available in the following eBay marketplaces: US, UK, Australia, France, Germany, Italy, Spain, and eBay Motors. In the listing description, sellers are only allowed to provide links to product videos, freight shipping services, or other legally required information, and when providing these links in the listing description, the secure 'https' protocol must be used instead of 'http'. In addition, any valid links to sites outside of eBay should use the target="_blank" attribute in the a href tag so a new browser window will be loaded when the link is clicked instead of buyers being redirected off of eBay. For more information on using links in the listing description, see eBay's <a href="http://pages.ebay.com/help/policies/listing-links.html" target="_blank">Links policy</a>. For more information about the stronger security standards that eBay is using, see the <a href="https://pages.ebay.com/seller-center/seller-updates/2018-fall/marketplace-update.html#use-secure-https" target="_blank">Use secure HTTPS for enhanced browser security</a> topic in the 2018 Fall Seller Update. The <a href="https://developer.ebay.com/api-docs/sell/compliance/resources/listing_violation/methods/getListingViolations" target="_blank">getListingViolations</a> method of the Compliance API can be used to see if any of the seller's active listings are not 'HTTPS' compliant. If you embed pictures in the description (by using IMG tags) instead of using PictureURL, but you want a camera icon to appear in search and listing pages, specify the following null-image URL in the PictureURL field: https://pics.ebay.com/aw/pics/dot_clear.gif. See <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/pictures.html" target="_blank">Add pictures</a> in the Trading API User Guide. This field is conditionally required for all listings. The exception is when the seller specifies a product identifier, such as a GTIN or ePID, through the ProductListingDetails container and a product match is found in the eBay product catalog. If a matching product is found in the eBay product catalog, the item description will be created automatically (as long as the ProductListingDetails.IncludeeBayProductDetails value is <code>true</code>). 500000 (some sites may allow more, but the exact number may vary) AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally IncludeeBayProductDetails #Request.Item.ProductListingDetails.IncludeeBayProductDetails GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItem

DetailLevel: ItemReturnDescription, ReturnAll

Always IncludeeBayProductDetails #Response.Item.ProductListingDetails.IncludeeBayProductDetails Note: This field should no longer be used since it no longer supports the ability to append or prepend text using the Append or Prepend values, but only supports the Replace value. If this field is used and set to Append or Prepend, it will default to Replace, and whatever text is supplied in the Item.Description field will completely overwrite the current description for the active listing. If you wish to update the description for an active listing using a revise call, just provide the full description in the Item.Description field and do not use this field at all. This field will be completely removed from the WSDL within a few months.

This field no longer has an effect on the listing being revised through a ReviseItem or ReviseFixedPrice item call.

Replace ReviseItem ReviseFixedPriceItem No The unique identifier of the eBay listing. This identifier is generated by eBay and returned in the response of an Add call if an item is successfully listed. Once an item is successfully created, the ItemID cannot be modified. Note: Although we represent 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. Your code should be prepared to handle IDs of up to 19 digits. AddOrder GetBestOffers RelistItem ReviseItem VerifyRelistItem Yes RelistFixedPriceItem ReviseFixedPriceItem Conditionally GetBidderList Always GetOrders Transaction.Item

DetailLevel: none, ReturnAll

Always OrderReport Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetBestOffers

DetailLevel: none, ReturnAll

Conditionally GetItemsAwaitingFeedback GetMemberMessages Conditionally GetMyeBayBuying BestOfferList BidList LostList SecondChanceOffer WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Various details about a listing, some of which are calculated or derived after the item is listed. These include the start and end time, converted (localized) prices, and certain flags that indicate whether the seller specified fields whose values are not visible to the requesting user. For GetMyeBayBuying, returned as a self-closed element if no listings meet the request criteria. In an Add/Revise/Relist call, this container is used to set the Best Offer Auto-Accept and Best Offer Auto-Decline threshold values. GetBestOffers

DetailLevel: none, ReturnAll

Always GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetCategoryListings GetItemsAwaitingFeedback GetMemberMessages Conditionally GetMyeBayBuying BestOfferList BidList LostList SecondChanceOffer WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No Describes the number of days the seller wants the listing to be active (available for bidding/buying). The duration specifies the seller's initial intent at listing time. The end time for a listing is calculated by adding the duration to the item's start time. If the listing ends early, the value of the listing duration does not change. When a listing's duration is changed, any related fees (e.g., 10-day fee) may be debited or credited (as applicable). The valid choice of values depends on the listing format (see Item.ListingType). For a list of valid values, call GetCategoryFeatures with DetailLevel set to ReturnAll and look for ListingDurations information. When you revise a listing, the duration cannot be reduced if it will result in ending the listing within 24 hours of the current date-time. You are only allowed to increase the duration of the listing if fewer than 2 hours have passed since you initially listed the item and the listing has no bids. You can decrease the value of this field only if the listing has no bids (or no items have sold) and the listing does not end within 12 hours. Note: As of April 1, 2019, 'GTC' is the only supported listing duration for all eBay marketplaces with the following exceptions: <ul> <li>The following eBay Motors US categories are exempt from this change: Cars & Trucks (6001), Motorcycles (6024), Other Vehicles & Trailers (6038), Boats (26429), Powersports (66466).</li> <li>All child categories under Cars, Motorcycles & Vehicles (9800) categories on the eBay UK and eBay Italy sites are also exempt from this change. </li> </ul> If any other listing duration value besides <code>GTC</code> is specified in this field, it will be ignored, and <code>GTC</code> will be used instead. ListingDurationCodeType AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem Yes RelistItem ReviseItem RelistFixedPriceItem ReviseFixedPriceItem VerifyRelistItem No GetBidderList Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetMyeBaySelling ScheduledList UnsoldList ActiveList

DetailLevel: none, ReturnAll

Conditionally Describes listing upgrades that sellers can select for a fee, such as the BoldTitle upgrade. You can add a listing upgrade when you revise a listing, but you cannot remove a listing upgrade. When you relist an item, use DeletedField to remove a listing upgrade. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetCategoryListings Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally The selling format of the eBay listing, such as auction (indicated with <code>Chinese</code> value), fixed-price (indicated with <code>FixedPriceItem</code> value), or classified ad (indicated with <code>AdType</code> value). If this field is not included in an AddItem, AddItems, or VerifyAddItem call, the listing type defaults to auction For AddFixedPriceItem, RelistFixedPriceItem, or VerifyAddFixedPriceItem call, this field must be included and set to <code>FixedPriceItem</code>, since these calls only work with fixed-price listings. This field is not applicable to Revise calls because the selling format of active listings cannot be changed. Unknown, Auction, PersonalOffer, Shopping, Half AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Unknown, Auction, Half, PersonalOffer Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Unknown, Auction, Half Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Unknown, Auction, Half, PersonalOffer, Shopping Conditionally GetItemTransactions GetSellerTransactions Unknown, Auction, Half, Shopping

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetCategoryListings Unknown, Auction, Half, PersonalOffer Conditionally GetMyeBayBuying BidList LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Unknown, Auction, Half Conditionally GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Unknown, Auction, Half Conditionally GetSellerEvents

DetailLevel: ReturnAll

Unknown, Auction, Half, Shopping Conditionally Listing types https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/listing-types.html Indicates the geographical location of the item (along with the value in the Country field). When you revise a listing, you can add or change this value only if the listing has no bids (or no items have sold) and it does not end within 12 hours. If you do not specify Location, you must specify Item.PostalCode. If you specify a postal code, but do not specify a location, then the location is given a default value derived from the postal code. For GetOrders, GetItemTransactions, GetSellerTransactions: If the item is shipped from a fulfillment center location through the Multi-Warehouse Program, this field will return the location details (including the country and zip code) of the fulfillment center closest to the buyer. For Revise/Relist calls: When updating an Item.Location, you must also include the Item.PostalCode corresponding to the Item.Location in the revise/relist call; otherwise, the location will not be updated. Note: For the Classified Ad format for motors vehicle listings, the value provided in the Location field is used as item location only if the SellerContactDetails.Street and the SellerContactDetails.Street2 are empty. Else, the SellerContactDetails.Street and the SellerContactDetails.Street2 will be used for item location. 200 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetCategoryListings GetOrders GetItemTransactions GetSellerTransactions Conditionally A lot is a set of two or more similar items included in a single listing that must be purchased together in a single order line item. The Item.LotSize value is the number of items in the lot. This field is required if two or more items are including in one listing. Lots can be used for auction and fixed-price listings. Lot items can be listed only in lot-enabled categories. Call the <a href="../../../../../api-docs/sell/metadata/resources/marketplace/methods/getCategoryPolicies#response.categoryPolicies.lsd" target="_blank">getCategoryPolicies</a> method of the Metadata API to determine if a category supports lots. If the returned CategoryArray.Category.LSD (LotSize Disabled) value is <code>true</code>, the category does not support lots. 450,000 AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally This container is used in an Add/Revise/Relist/Verify call if the seller is selling a motor vehicle. It is used by the seller to specify the amount of the initial deposit, and the due dates for the deposit and the full payment for a motor vehicle listing. Note: If you are using business policies with your listing, the details set up in this container will instead be set up via the payment business policy. Payment business policies are associated with the listing via the SellerProfiles.SellerPaymentProfile container. This container will only be returned in 'Get' calls for motor vehicle listings where an initial deposit is required for that vehicle. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally eBay motors offline payment methods https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-motors-payments.html For Add/Revise/Relist calls: A PaymentMethods field is required for each offline payment method supported by the seller for the listing. Note: Sellers no longer have to specify any electronic payment methods for listings, so one or more PaymentMethods fields will only be needed for listings that require/support payments off of eBay's platform. If an electronic payment is supplied in a PaymentMethods field, a warning will be triggered and the payment method will be dropped. Note: If you are already referencing a payments business policy in an Add/Revise/Relist call with the SellerProfiles.SellerPaymentProfile container, no PaymentMethods fields will be needed, as these settings will already be set in the payments business policy. Payment methods are not applicable to any classified ad listings, as any agreement and payment is handled off of the eBay platform. For Get calls that return PaymentMethods fields : One or more PaymentMethods fields will only be returned if the seller set one or more offline payment methods for the listing. Note: This field will stop being returned in order management calls on January 31, 2024. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList GetItems IntegratedMerchantCreditCard Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

IntegratedMerchantCreditCard Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

IntegratedMerchantCreditCard Conditionally This field is no longer applicable, and should not be used. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This container is used in an Add/Revise/Relist call to set the primary listing category. This field is conditionally required in an Add call unless the seller successfully uses the ProductListingDetails container to find an eBay catalog product match. When the seller successfully uses an eBay catalog product to create a listing, the listing title, listing description, Item Specifics, listing category, and stock photo defined in the catalog product is used to create the listing. Once you determine the appropriate eBay category for your product, and want to know which listing features it supports, you can use the GetCategoryFeatures call. To discover required, recommended, and optional Item Specifics for a category, use the <a href="https://developer.ebay.com/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory" target="_blank">getItemAspectsForCategory</a> method of the Taxonomy API. If you do use an eBay catalog product, it is advised that you do not include this field, as any primary category ID you specify in this field may get dropped if this category is different than the primary category defined in the eBay catalog product. For ReviseItem only: When revising a listing, you can change the primary category only if an auction listing has no bids or a multiple-quantity, fixed-price listing has no sales, and the listing does not end within 12 hours. If you change the listing category, any Item Specifics that were previously specified may be dropped from the listing if they aren't valid for the new category. When you list an event ticket on the US site, you must specify one of the leaf categories under the Tickets & Experiences meta category. AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem Conditionally RelistItem ReviseItem RelistFixedPriceItem ReviseFixedPriceItem VerifyRelistItem No GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Applying Categories https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/categories.html Maintaining Category Data https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/categories.html A <code>true</code> value in this field indicates that the listing is private. Sellers may want to use this option when they believe that a listing's potential bidders/buyers would not want their obfuscated user IDs (and feedback scores) exposed to other users. For ReviseItem/ReviseFixedPriceItem: The seller will not be able change this setting if the listing has any pending bids, any pending best offers, previous sales (for multiple-quantity, fixed-price listing), or if the listing will end within 12 hours. false AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally This container is used to provide one or more product identifiers for a product, and if desired by the seller, eBay will use the identifier(s) of the product to try to match it to a defined product in the eBay catalog. If a seller's product is matched to an eBay catalog product, the product details associated with that catalog product will be prefilled for the listing. Product details defined for a catalog product include the product title, product description, product aspects, and stock image(s) of the product (if available). In some eBay categories, one or more product identifier types (e.g. UPC or ISBN) may be required, but the category may not have any eBay catalog products defined, or the category does not allow listings to be created using a catalog product. Note that the GetCategoryFeatures call can be used to retrieve supported/required product identifier types. Note: If a product identifier type is required, the corresponding field must be used, even if the seller is not interested in finding an eBay catalog product match. A large percentage of eBay US categories require one or more product identifier types when listing an item. See the <a href="http://pages.ebay.com/sell/item_specifics/product_identifiers.html" target="_blank">Structured Data - Product Identifiers</a> help page for more information on which eBay US categories require which product identifier types. If known, an ePID (specified through the ProductReferenceID field) is always the best bet to find an eBay catalog product match, although an EAN, ISBN, UPC, or Brand/MPN pair can also be used in an attempt to find a catalog product match. If a Brand/MPN pair is required for the product, these values must be input through the BrandMPN container. When you use ProductListingDetails, in an Add/Revise/Relist call, you must specify at least one GTIN, a ProductReferenceID (also known as an ePID), or a Brand/MPN pair. If you specify more than one GTIN value, eBay uses the first one that matches a product in eBay's catalog. For ReviseItem and RelistItem only: When you revise a listing, if it has bids or it ends within 12 hours, you cannot change the product identifier and you cannot remove existing product listing details data. However, you can change or add preferences such as IncludeStockPhotoURL, UseStockPhotoURLAsGallery, and IncludePrefilledItemInformation. To delete all catalog data when you revise or relist an item, specify Item.ProductListingDetails in DeletedField and don't pass ProductListingDetails in the request. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Conditionally GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally For AddItem family of calls: The Quantity value for auction listings must always be <code>1</code>. For a fixed-price listing, the Quantity value indicates the number of identical items the seller has available for sale in the listing. If this field is not included when creating a new fixed-price listing, quantity defaults to '1'. If variations are specified in AddFixedPriceItem or VerifyAddFixedPriceItem, the Item.Quantity is not required since the quantity of variations is specified in Variation.Quantity instead. See the <a href="https://pages.ebay.com/help/sell/listing-variations.html" target="_blank">Creating a listing with variations</a> eBay Help page for more information on variations. For ReviseItem and ReviseFixedPriceItem: This value can only be changed for a fixed-price listing with no variations. The quantity of variations is controlled in the Variation.Quantity field and the Item.Quantity value for an auction listing should always be <code>1</code>. For RelistItem and RelistFixedPriceItem: Like most fields, when you use RelistItem or RelistFixedPriceItem, Quantity retains its original value unless you specifically change it. This means that the item is relisted with the value that was already in Quantity, not with the remaining quantity available. For example, if the original Quantity value was <code>10</code>, and three items have been sold, eBay sets the relisted item's Quantity to <code>10</code> by default, and not <code>7</code>. So, we strongly recommend that you always set Quantity to the correct value (your actual quantity available) in your relist requests. When eBay auto-renews a GTC listing (ListingDuration = GTC) on your behalf, eBay relists with correct quantity available. For GetSellerEvents: Quantity is only returned for listings where item quantity is greater than 1. For GetItem and related calls: This is the total of the number of items available for sale plus the quantity already sold. To determine the number of items available, subtract SellingStatus.QuantitySold from this value. For order line item calls with variations: In GetItemTransactions, Item.Quantity is the same as GetItem (the total quantity across all variations). In GetSellerTransactions, Transaction.Item.Quantity is the total quantity of the applicable variation (quantity available plus quantity sold). Note: For the US site, new eBay sellers are subject to <a href="https://developer.ebay.com/api-docs/user-guides/static/make-a-call/fg-replaced.html">Seller Limits</a>, which limit the quantity of items that may be listed and/or the total cumulative value of these listings. While subject to these selling limits, an eBay seller can use the GetMyeBaySelling call to retrieve both the remaining number of listings they can create and the remaining cumulative value of these listings. These values are shown in the Summary.QuantityLimitRemaining and Summary.AmountLimitRemaining fields in the GetMyeBaySelling response. If a call to add an item or revise an item would result in the exceeding of these limits, the add item or revise item call will fail. These fields will only be returned if the seller is subject to seller limits. 1 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally ReviseItem No GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally A note that a user makes on an item from their My eBay account. GetMyeBayBuying and GetMyeBaySelling return this field, and only if you pass in the IncludeNotes field in the request, and set its value to true. This field will only be returned if set for an item, and only returned to the user who created the note. Not supported as input in ReviseItem. Use SetUserNotes instead. For GetMyeBayBuying In WatchList, notes for variations are only returned at the Item level, not the variation level. They are only set if you specified ItemID (if no purchases) or ItemID and VariationSpecifics (if there are purchases) in SetUserNotes (or selected the equivalent in the My eBay UI on the site). In WonList, notes for variations are only returned at the Item level, not the variation level. They are only set if you specified ItemID and TransactionID in SetUserNotes (or selected the equivalent in the My eBay UI on the site). AddFixedPriceItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetMyeBayBuying GetMyeBaySelling Conditionally Applicable only to relisting an item. If true, creates a link in the item's old listing for the item that points to the new relist page, which accommodates users who might still look for the item under its old item ID. RelistItem No RelistFixedPriceItem No If <code>true</code>, the item is eligible for shipping managed by eBay; <code>false</code>, the item is not eligible for shipping managed by eBay. GetItem No Always

DetailLevel: none, ItemReturnAttributes, ItemReturnCategories, ItemReturnDescription, ReturnAll

This field is used to set the lowest price at which the seller is willing to sell an auction item. The StartPrice value must be lower than the ReservePrice value. Note that setting a reserve price will incur a listing fee of $5 or 7.5% of the reserve price, whichever is greater, and this fee is charged regardless of whether or not the auction item has a qualifying, winning bidder. As long as no bidder has matched your reserve price, and the scheduled end time of the auction is 12 or more hours away, you can lower or remove the reserve price. However, even if you remove the reserve price from an active listing, you will still be charged the fee and not eligible for a credit. In 'get' calls that retrieve item data, the ReservePrice field will only be returned to the seller of that particular auction item, and only if a reserve price has been set up. The reserve price is never exposed to anyone other than the seller of the item. 16 AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally Revise a US eBay motors listing https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-motors-revise-listing.html Setting a reserve price (eBay help topic) https://www.ebay.com/help/selling/listings/selling-auctions/reserve-prices?id=4143 Fees for optional listing upgrades (eBay help topic) https://www.ebay.com/help/selling/fees-credits-invoices/selling-fees?id=4822#section5 This container is returned if a listing has been revised in any way since it first became active. One or more boolean fields will be returned under this container based on the type of revision(s) that occured, including a general revision, a price change, or a feature added or removed. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always Allows the user to specify a time in the future that the listing becomes active on eBay. To schedule the listing start time, specify a time in the future in GMT format. In GetItem and related calls, the scheduled time is returned in StartTime. For ReviseItem, you can modify this value if the currently scheduled start time is in the future (listing has yet to go live). AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No The unique identifier for a secondary category. This field is only applicable if the seller decides to list the item under two categories. You cannot list US eBay Motors vehicles in two categories. However, you can list Parts & Accessories in two categories. The final value fee is based on the primary category in which the item is listed. Furthermore, you can list the same item in an eBay Motors Parts & Accessories category and in an eligible eBay category, as long as the primary category is associated with the site on which you are listing. That is, the two categories can be a mix of Motors Parts & Accessories and eBay site categories. (Real Estate, Mature Audience (adult), and Business & Industrial categories are not eligible for listing in two categories in this manner.) For example, if you list on Motors, the primary category could be 6750 (eBay Motors > Parts & Accessories > Apparel & Merchandise > Motorcycle > Jackets & Leathers), and the secondary category could be 57988 (eBay > Clothing, Shoes > Accessories > Men's Clothing > Outerwear). If you list on the main eBay site, the primary category could be 57988 and the secondary category could be 6750. If eBay has designated a listing category as a value category (see ValueCategory in GetCategoryFeatures), and that listing category will be the seller's primary category, the seller will not be able to list their item in a secondary category. If a seller's request payload includes a primary or a secondary category that is designated as a value category, then eBay drops the SecondaryCategory ID and only lists the item in the category specified with the PrimaryCategory ID. Also, if the listing request includes Item Specifics (in ItemSpecifics) that are associated with the SecondaryCategory, eBay drops those values as well when the SecondaryCategory is dropped. The same logic is used if you revise an existing listing to add a secondary category, or to change one of the categories: If either the primary or secondary category is a value category, eBay drops the secondary category from your request.) To remove this value when relisting an item, use DeletedField. For ReviseItem only: When revising a listing within 12 hours of the listing's scheduled end time, you can only add or change the secondary category when an auction listing has no active bids or a multiple-quantity, fixed-price listing has no items sold. If you change the secondary category, any corresponding Item Specifics that were previously specified may be dropped from the listing if they aren't valid for the category. For ReviseItem only: Previously, removing the listing from a secondary category was only possible within 12 hours of the listing's scheduled end time when an auction listing had no active bids or a multiple-quantity, fixed-price listing had no items sold, but this restriction no longer exists. Now, the secondary category can be dropped for any active listing at any time, regardless of whether an auction listing has bids or a fixed-price listing has sales. To drop a secondary category, the seller passes in a value of <code>0</code> in the SecondaryCategory.CategoryID field. 10 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally The unique identifier for a secondary category that eBay has added as a free promotion. You cannot add this yourself. This container is only returned if the item was listed in a single category and eBay added a free secondary category. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Container for information about this listing's seller. Returned by GetItemsAwaitingFeedback if Buyer is making the request. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally GetItemsAwaitingFeedback

DetailLevel: none, ReturnAll

Conditionally GetCategoryListings Conditionally GetMyeBayBuying BestOfferList BidList LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling BidList

DetailLevel: none, ReturnAll

Conditionally GetBidderList Always Various details about the current status of the listing, such as the current number of bids, the current high bidder, quantity sold, current price, and listing status. GetBidderList Always GetSellerEvents

DetailLevel: none, ReturnAll

Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetCategoryListings GetMemberMessages Conditionally GetMyeBayBuying BestOfferList BidList LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally The shipping-related details for an order, including flat and calculated shipping costs. Note: For sellers who are using a shipping (aka Fulfillment) business policy to create/revise/relist an item, none of the fields under the ShippingDetails container are necessary. A fulfillment business policy can be set up and/or modified in My eBay, or via the <a href="https://developer.ebay.com/api-docs/sell/account/resources/fulfillment_policy/methods/createFulfillmentPolicy">Account API</a>. A fulfillment business policy is associated to a listing through the Item.SellerProfiles.SellerShippingProfile container. If you do not use a fulfillment business policy, many of the fields under this ShippingDetails container become required in your request. Note: For ReviseItem and ReviseFixedPriceItem calls: If you are updating any field under the ShippingDetails container, you must include all containers and fields set under this container even if their values are not changing. If you do not do this, some fields may be removed from the listing. To find out the values included in the current listing, call <a href="https://developer.ebay.com/devzone/xml/docs/Reference/eBay/GetItem.html#GetItem">GetItem</a> and look through the ShippingDetails container in the response. For additional information, see <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-revise.html" target="_blank">Revise shipping details</a>. New users who list their first items in selected categories on the US site must specify at least one domestic shipping service. This applies to a category if GetCategoryFeatures returns <code>true</code> for Category.ShippingTermsRequired. For multi-quantity, fixed-price listings, a seller can revise all shipping details of the listing (except for sales tax and for shipping type of Freight) for all unsold items. This applies to both domestic and international shipping. Checkout is not affected for those who bought items prior to the seller's shipping changes—the shipping details that were in effect at the time of purchase are used for that buyer at the time of checkout. Shipping details are not applicable to any classified ad listings, as shipping/delivery/pickup is handled by the buyer and seller off of the eBay platform. Note: To create a listing that is 'Local Pickup only' (buyer picks up, with no shipping/delivery available), the user does the following two things: <ul> <li>Either omit the entire ShippingDetails container, or pass in an empty ShippingDetails container - <ShippingDetails/> </li> <li>Pass in one ShipToLocations field, with its value set to <code>None</code> - <ShipToLocations>None</ShipToLocations></li> </ul> For GetMyeBayBuying, GetMyeBaySelling: ShippingDetails is not returned. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetMyeBayBuying BestOfferList BidList DeletedFromLostList DeletedFromWonList WatchList WonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally Shipping costs https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-costs.html Revising Items https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/revise-listing.html restrictions on changing item properties with ReviseItem An international location or region to which the seller is willing to ship, regardless of shipping service. The country of the listing site is added by eBay. Note: For sellers who are using a shipping (aka Fulfillment) business policy to create/revise/relist an item, the ShipToLocations field should not be used in the request. A fulfillment business policy can be set up and/or modified in My eBay, or via the <a href="https://developer.ebay.com/api-docs/sell/account/resources/fulfillment_policy/methods/createFulfillmentPolicy">Account API</a>. A fulfillment business policy is associated to a listing through the Item.SellerProfiles.SellerShippingProfile container. Use GeteBayDetails with a DetailName of ShippingLocationDetails to determine which international locations are valid for the site. Omit ShipToLocations if you want to ship only within the country of the listing site. To state that you do not wish to ship at all, set ShipToLocations to <code>None</code>. ReviseItem can add a ShipToLocations. On output, ShipToLocations is the collection of all input item-level ShipToLocations plus international shipping service-level ShipToLocation values. Note: The ShipToLocations and ShippingDetails.ExcludeShipToLocation containers are not applicable for motor vehicle listings on the US, CA, or UK marketplaces. If these containers are sent in the request, they are ignored and a warning is returned. If you have specified a region to which you will ship (such as Asia), you can use ExcludeShipToLocation to exclude certain countries within that region to where you will not ship (such as Afghanistan). Note: To create a listing that is 'Local Pickup only' (buyer picks up, with no shipping/delivery available), the user does the following two things: <ul> <li>Either omit the entire ShippingDetails container, or pass in an empty ShippingDetails container - <ShippingDetails/> </li> <li>Pass in one ShipToLocations field, with its value set to <code>None</code> - <ShipToLocations>None</ShipToLocations></li> </ul> ShippingRegionCodeType, CountryCodeType AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Shipping information https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-info.html GeteBayDetails The name of the eBay listing site. The listing site affects the business logic and validation rules that are applied to the request, which in turn affect the values that are returned in the response, as well as values that appear on the eBay site. For example, the listing site can affect the validation of Category in listing requests, international business seller requirements, the values of converted (localized) prices in responses, the item-related time stamps that are displayed on the eBay site, the visibility of the item in some types of searches (e.g., GetCategoryListings), and other information. In some cases, the rules are determined by a combination of the site, the user's registration address, and other information. You cannot change the site when you revise a listing. When you specify Item.Site in AddItem or AddFixedPriceItem, it must be consistent with the numeric site ID that you specify in the request URL (for the SOAP API) or the X-EBAY-API-SITEID header (for the XML API). AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetOrders Transaction.Item

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetCategoryListings Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetMyeBayBuying BestOfferList BidList LostList SecondChanceOffer WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling BidList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally The original price of the item at listing or re-listing time. If this value changes when the item is revised, the new value becomes the original price. For auction listings: Competitive bidding starts at this value. Once at least one bid has been placed, StartPrice remains the same but CurrentPrice is incremented to the amount of each succeeding bid. If ReservePrice is also specified, the value of StartPrice must be lower than the value of ReservePrice. For input on fixed-price listings (FixedPriceItem): This is the constant price at which a buyer may purchase the item. GetMyeBaySelling does not return Item.StartPrice for fixed price items—it returns Item.SellingStatus.CurrentPrice. For AddFixedPriceItem and VerifyAddFixedPriceItem: Required when no variations are specified. If variations are specified, use Variation.StartPrice for each variation instead. For Revise calls: If the StartPrice value for a fixed-price item is changed with a Revise call, the MinimumBestOfferPrice and BestOfferAutoAcceptPrice fields in the ListingDetails container will be dropped (if set), basically turning off the Best Offer Auto Accept and/or Auto Decline features. If the seller wanted to reintroduce either of these Best Offer threshold values in the listing again, an additional Revise call would have to be made, passing in the desired threshold values. Note: For the US site, new eBay sellers are subject to <a href="https://developer.ebay.com/api-docs/user-guides/static/make-a-call/fg-replaced.html">Seller Limits</a>, which limit the quantity of items that may be listed and/or the total cumulative value of these listings. While subject to these selling limits, an eBay seller can use the GetMyeBaySelling call to retrieve both the remaining number of listings they can create and the remaining cumulative value of these listings. These values are shown in the Summary.QuantityLimitRemaining and Summary.AmountLimitRemaining fields in the GetMyeBaySelling response. If a call to add an item or revise an item would result in the exceeding of these limits, the add item or revise item call will fail. These fields will only be returned if the seller is subject to seller limits. Listing Policies https://developer.ebay.com/api-docs/user-guides/static/make-a-call/fg-replaced.html AddFixedPriceItem AddItem AddItems RelistFixedPriceItem ReviseFixedPriceItem VerifyAddFixedPriceItem VerifyAddItem Yes ReviseItem RelistItem VerifyRelistItem No GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetMyeBayBuying BidList LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally This container provides details about the seller's eBay store. In an Add/Revise/Relist call, the seller can include this container to set/change which customized eBay store category that the item will be placed in. For 'Get' calls, this container is returned if the seller of the item has an eBay store. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Subtitle to use in addition to the title. Provides more keywords when buyers search in titles and descriptions. You cannot use HTML in the Subtitle. (HTML characters will be interpreted literally as plain text.) If you pass any value, this feature is applied (with applicable fees). When you revise a item, you can add, change, or remove the subtitle. 55 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList GetCategoryListings Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetMyeBayBuying BestOfferList BidList LostList SecondChanceOffer WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally Remove a field https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/relist-remove-field.html (RelistItem) DeletedField RelistItem.html#Request.DeletedField Create an eBay Motors listing https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-motors-create-listing.html#subtitle Time left before the listing ends. The duration is represented in the ISO 8601 duration format (PnYnMnDTnHnMnS). See Data Types in the Trading API Guide for information about this format. For ended listings, the time left is PT0S (zero seconds). GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetMyeBayBuying BestOfferList BidList SecondChanceOffer WatchList Conditionally

DetailLevel: none, ReturnAll

GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally This field is used to specify the title of the listing. This field is conditionally required in an Add call unless the seller successfully uses the ProductListingDetails container to find an eBay catalog product match. When the seller successfully uses an eBay catalog product to create a listing, the listing title, listing description, Item Specifics, and stock photo defined in the catalog product are used to create the listing. You cannot use HTML or JavaScript in the Title. (HTML characters will be interpreted literally as plain text.) The listing title can only be changed if the active listing has yet to have any bids or sales, and the listing does not end within 12 hours. Note: When making a GetSellerEvents call, this field will be returned masked as <code>*****************</code> for on-hold listings. Note: When making a GetSellerTransactions or GetMyeBaySelling call, the item ID value of the listing will be returned in this field to indicate that the listing is on hold. Note: When a line item comes from a multiple-variation listing, the variation aspect name-value pair will be appended to this title. 80 for Add/Revise/Relist/Verify Item family of calls; 120 for GetOrders/GetItemTransactions/GetSellerTransactions calls AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem Conditionally RelistItem ReviseItem RelistFixedPriceItem ReviseFixedPriceItem VerifyRelistItem No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetCategoryListings GetItemsAwaitingFeedback GetMemberMessages Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetMyeBayBuying BestOfferList BidList LostList SecondChanceOffer WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList BidList

DetailLevel: none, ReturnAll

Conditionally GetBidderList Always GetOrders Transaction.Item LinkedLineItem.Item

DetailLevel: none, ReturnAll

Always OrderReport Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally Use an UUID value to ensure that you only list (or relist) a particular item once. This field can be particularly useful if you are listing many items on a daily basis and/or many items at once with an AddItems call. If your call request does not generate a response, or if you get one or more (blocking) errors, be sure to use the same UUID value when you attempt to list or relist the same item with another call request. If you pass in a UUID value that has already been used to successfully create or relist an item, you will receive an error message that includes the Item ID for that listing and a boolean value indicating whether the duplicate UUID was sent by the same application. We recommend that you use the Item.UUID field for add and relist calls (for example, AddItem and RelistItem), but use the Item.InvocationID field instead when using a revise call. The UUID can only contain digits from 0-9 and letters from A-F and must be 32 characters long. The UUID value must be unique across all of the seller's eBay across all eBay marketplaces. 32 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This container is used in an Add/Revise/Relist call to set the VAT (Value-added Tax) percentage rate that will be charged to buyers when an item is purchased from the listing, and to enable Business Seller-related features. This container is returned in 'Get' calls only if VAT is applicable to the listing, and unless the person making the 'Get' call owns the listing, only the VATPercent field is returned (if applicable). However, Business Seller-related information will be returned to all users in 'Get' calls under the SellerInfo and BusinessSellerDetails containers. Note: VAT is not applicable to all countries, including the US. Allowed VAT percentage rates can vary by region/country, so sellers should be aware of the rates they are legally required/allowed to charge. Sellers must be registered as Business Sellers on the site they are selling on in order to use the Business Seller-related fields. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Value-added tax (VAT) https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/taxes-vat.html German business features https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/taxes-vat-germany.html This field is returned if the seller of the item is currently on vacation and has configured a custom message to display to potentioal buyers through <a href="https://www.ebay.com/help/selling/selling-tools/time-away?id=5137" target="_blank">Time Away</a> settings. Note: There are two Time Away modes - Pause Sales and Allow Sales. If seller is in the Pause Sales mode, all fixed-price listings for that seller will be hidden from search results during the span of the seller's vacation. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents

DetailLevel: ReturnAll

Conditionally The number of watches placed on this item from buyers' My eBay accounts. Specify IncludeWatchCount as <code>true</code> in the request. Returned by GetMyeBaySelling only if greater than 0. GetSellerEvents

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetMyeBaySelling Conditionally This value indicates the number of page views that a listing has received in the last 30 days. We recommend that you use the <a href="https://developer.ebay.com/api-docs/sell/analytics/resources/traffic_report/methods/getTrafficReport" target="_blank">getTrafficReport</a> method of the Analytics API to return user traffic details received by a seller's listings. This RESTful method returns metrics such as click-through rate, listing impressions, listing views, sales conversion rate, and the number of completed transactions. Note: This field is only returned to authorized applications. GetSellerList

DetailLevel: ReturnAll

GranularityLevel: Fine

Conditionally GetSellerEvents

DetailLevel: ReturnAll

Conditionally This field can be included and set to <code>true</code> in an Add or Revise call if the seller wishes to disable all buyer requirements (that are set in the seller's account) for the listing. (from Item.BuyerRequirementDetails or Buyer requirements preferences in My eBay) are ignored. This field will only be returned in 'Get' calls if <code>true</code>. false AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally For Add/Revise/Relist/Verify calls: This container is used to enable the Best Offer feature on a listing. Note that the Best Offer feature can be set for auction listings on the US, Canada, UK, Germany, Australia, France, Italy, and Spain marketplaces, but a seller can only use Best Offer or Buy It Now, but not both. Once an auction listing receives a qualifying bid, the Best Offer feature will be turned off and any pending Best Offers or Counteroffers will no longer be valid. For GetItem and other calls that retrieve item data, this container will include the status (GetMyeBayBuying only) and dollar amount of the latest Best Offer on a fixed-price listing, and the number of Best Offers received for the fixed-price listing. Note: Best Offer is not available for multi-variation listings. AddFixedPriceItem AddItem AddItems RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetMyeBayBuying BestOfferList Conditionally

DetailLevel: none, ReturnAll

GetMyeBaySelling ActiveList Conditionally

DetailLevel: none, ReturnAll

If <code>true</code>, eBay provided a central location as a result of the user not specifying a location. This typically occurs when the seller specifies PostalCode without Location. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Indicates whether the seller's tax table is to be used when applying and calculating sales tax for an order line item. A sales tax table can be created programmatically using the SetTaxTable call of Trading API or the <a href="https://developer.ebay.com/api-docs/sell/account/resources/sales_tax/methods/createOrReplaceSalesTax">createOrReplaceSalesTax</a> method of Account API. If UseTaxTable is set to <code>true</code>, the values contained in the seller's sales tax table will supersede the values contained in the Item.ShippingDetails.SalesTax container (if included in the request). Note: As of November 2021, buyers in all US states except for Missouri (and several US territories), will automatically be charged sales tax for purchases, and the seller does not set this rate. eBay will collect and remit this sales tax to the proper taxing authority on the buyer's behalf. For more US state-level information on sales tax, see the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/taxes-import-charges?id=4121#section4" target="_blank">eBay sales tax collection</a> help topic. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No Multi-jurisdiction sales tax https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/taxes.html This field is deprecated. Applicable for listings in vehicle categories on the US eBay Motors site and eBay Canada site. (No business effect if specified for other categories or sites, as the Web site will not display the information to buyers.) <ul> <li>If <code>true</code>, the buyer is responsible for vehicle pickup or shipping. </li> <li>If <code>false</code>, specify vehicle shipping arrangements in the item description. (The description can also include vehicle shipping arrangements when this value is <code>true</code>.) </li> </ul> If the item has bids or ends within 12 hours, you cannot modify this flag. Do not specify ShippingDetails.ShippingServiceOptions for vehicle listings. If <code>true</code> and the listing is on the US eBay Motors site, and you want the listing to be visible on the eBay Canada site, set Item.ShipToLocations to CA. If <code>true</code> and the listing is on the eBay Canada site, and you want your listing to be visible on the US eBay Motors site, set Item.ShipToLocations to US. true AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Returns a note from eBay displayed below items in the user's My eBay account. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList ScheduledList UnsoldList Conditionally

DetailLevel: none, ReturnAll

Specifies the number of questions buyers have posted about the item. Returned only if greater than 0. GetMyeBaySelling Conditionally This boolean field is returned as <code>true</code> if the item in this listing was relisted. When an item is relisted, a brand new Item ID value is automatically created by eBay. This field is only returned for an original listing whose item has been relisted, so a <code>false</code> value should never get returned. Note: A new listing will not return this field. GetMyeBaySelling Conditionally UnsoldList This integer value indicates the quantity of an item that is still available for purchase in a multiple-quantity, fixed-price listing. This field is not applicable to auction listings. GetMyeBayBuying WatchList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally A SKU (Stock Keeping Unit) value is a seller-defined identifier for a product. Each product within a seller's inventory should be unique. Most large-volume sellers use SKUs, but eBay only requires a SKU value if the InventoryTrackingMethod field is included in an AddFixedPriceItem call and its value is set to <code>SKU</code>. Setting the InventoryTrackingMethod field to <code>SKU</code> allows the seller to use a SKU value instead of an ItemID value as a unique identifier in calls such as GetItem and ReviseInventoryStatus A seller can specify a SKU when listing an item with AddItem and related calls. 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.) If both ItemID and SKU are specified in calls that support the use of SKU as a unique identifier, the ItemID value takes precedence. If a seller wants to use SKUs for multiple-variation listings, the SKU value for each product variation is actually specified at the variation level (Item.Variations.Variation.SKU) field, and the Item.SKU) field should not be included in the call request. Note: The eBay site cannot identify listings by SKU. For example, My eBay pages and Search pages all identify listings by item ID. When a buyer contacts you via eBay's messaging functionality, eBay uses the item ID as the identifier. Buyer-focused APIs (like the Shopping API) also do not support SKU as an identifier. For revising and relisting only: To remove a SKU when you revise or relist an item, use DeletedField. (You cannot remove a SKU when Item.InventoryTrackingMethod is set to SKU.) For GetItem, GetMyeBaySelling, and other 'Get' call, the SKU value will only be returned if defined for the listing. 50 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList Conditionally GetOrders Transaction.Item

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetMyeBaySelling Conditionally eBay Merchant Data API AddFixedPriceItem and ReviseFixedPriceItem https://developer.ebay.com/DevZone/merchant-data/CallRef/index.html Postal code of the place where the item is located. This value is used for proximity searches. To remove this value when revising or relisting an item, use DeletedField. If you do not specify PostalCode, you must specify Item.Location. If you specify PostalCode, but do not specify Item.Location, then Item.Location is given a default value derived from the postal code. Note: As of late January 2020, the displayed postal code returned in GetItem is now masked to all users except for the seller of the item. Different countries will mask postal/zip codes in slightly different ways, but an example would be <code>951**</code>. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always This container consists of the data associated with photos within the listing. Sellers can have up to 24 pictures in almost any category at no cost. Motor vehicle listings are an exception. The number of included pictures in motor vehicle listings depend on the selected vehicle package (see <a href="https://www.ebay.com/help/selling/fees-credits-invoices/motors-fees?id=4127">Fees for selling vehicles on eBay Motors</a>). These photos can be hosted by eBay Picture Services (EPS), or the seller can host pictures on a non-eBay server. If pictures are externally-hosted, they must be hosted on a site that is using the 'https' protocol. It is required that all listings have at least one picture. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList GetCategoryListings Conditionally GetMyeBayBuying BestOfferList BidList SecondChanceOffer WatchList LostList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none,ReturnAll

Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList BidList

DetailLevel: none, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Add pictures https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/pictures.html Adding photos to your listing https://pages.ebay.com/help/sell/pictures.html This container is used if the seller wants to add a video to their listing. At this time, only one video can be added per listing. The video can be uploaded to eBay using the <a href="https://developer.ebay.com/api-docs/commerce/media/overview.html" target="_blank">Media API</a>. See the <a href="https://developer.ebay.com/api-docs/commerce/media/overview.html" target="_blank">Media API</a> reference documentation for all of the necessary details to upload videos to eBay. This container will only be returned in GetItem if the listing contains a video, and the seller of the item is the one making the GetItem call. Note: Videos can only be attached to listings on supported eBay marketplaces and can only be viewed through supported platforms. See <a href="https://developer.ebay.com/api-docs/sell/static/inventory/managing-video-media.html#AddingVideos" target="_blank">Managing videos</a> in the Selling Integration Guide for a full list of supported marketplaces and platforms. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem Conditionally This container is used to provide the eco-participation fee for a product. Use the <a href="https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getExtendedProducerResponsibilityPolicies" target="_blank">getExtendedProducerResponsibilityPolicies</a> method of the Sell Metadata API to retrieve categories that support eco-participation fee for a specified marketplace." For GetItem calls, this container is only returned to the listing owner, if the container is available. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This container is used to apply one or more custom policies to the listing by specifying custom policy IDs. Custom policies include Product Compliance and Take-Back Policies. For more information, see the Custom Policies page for your site (for example, <a href="https://www.ebay.fr/help/selling/custom-policies/custom-policies?id=5311" target="_blank">https://www.ebay.fr/help/selling/custom-policies/custom-policies?id=5311</a>). This container is supported by a limited number of sites and specific categories. Use the <a href="https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getExtendedProducerResponsibilityPolicies" target="_blank">getExtendedProducerResponsibilityPolicies</a> method of the Sell Metadata API to retrieve valid categories for a site. To create and manage custom policies, use the <a href="https://developer.ebay.com/api-docs/sell/account/resources/methods#h2-custom_policy" target="_blank">custom_policy</a> resource of the Account API. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No Specifies the maximum number of business days the seller commits to for preparing an item to be shipped after receiving a cleared payment. This time does not include the shipping time (the carrier's transit time). Note: If the seller opts into the eBay Guaranteed Delivery feature and wants to make a listing eligible for eBay Guaranteed Delivery, the DispatchTimeMax value must be set to <code>0</code> or <code>1</code> (days) and the cumulative value of DispatchTimeMax plus the transit time of the shipping service (returned in ShippingServiceDetails.ShippingTimeMax field of GeteBayDetails) must be 4 business days or less to be eligible for this feature. See the <a href="https://pages.ebay.com/seller-center/shipping/ebay-guaranteed-delivery.html" target="_blank">eBay Guaranteed Delivery</a> page in Seller Center for more information on this program. The eBay Guaranteed Delivery feature is only available on the US and Australia marketplaces. For Add/Revise/Relist calls: Required for listings in certain categories when certain shipping services (with delivery) are offered. See HandlingTimeEnabled in GetCategoryFeatures. The seller sets this to a positive integer value corresponding to the number of 'handling' days. For a list of allowed values on each eBay site, use DispatchTimeMaxDetails in GeteBayDetails. Supported handling times for most sites in most categories range from 0 (same-day handling) to 3 business days, but this can vary by site. Some categories on some sites support longer handling times, and this generally comes into play with extremely large items where freight shipping may be required. This field is required whenever flat-rate or calculated shipping is used, but does not apply when there is no shipping involved, which is the case for digital gift card listings, or any orders where local pickup is available and this option is selected by the buyer. For ReviseItem only: If the listing has bids or sales and it ends within 12 hours, you can't change this value. If the listing is a GTC listing that has sales or ends within 12 hours (one or the other, but not both), you can add or change this value. If the listing has no bids or sales and more than 12 hours remain before the listing ends, you can add or change the dispatch (handling) time. For GetItem: GetItem returns DispatchTimeMax only when shipping service options are specified for the item and the seller specified a dispatch time. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Handling time https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-handling.html (GetCategoryFeatures) Category.HandlingTimeEnabled categories that support handling times GetCategoryFeatures.html#Response.Category.HandlingTimeEnabled This container is used by sellers of Classified Ad listings to provide contact information. Classified ad listings https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/classified-ads.html AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally The number of questions asked about this item. Applies to eBay Motors Pro applications only. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Some listings on the eBay platform originate from eBay affiliates. Depending on the relationship the affiliate has with eBay, there are times when the affiliate retains ownership of the listing. When this occurs the representation of the listing on eBay is considered a proxy item. Proxy items can only be edited using API requests from the applications that originally listed them. GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Extended contact information for sellers using the Classified Ad format. Specifies the days and hours when the seller can be contacted. To remove seller contact information when revising or relisting an item, use DeletedField. AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Specifies the number of leads (emails) buyers have posted about the item. You must be the seller of the item to retrieve the lead count. GetMyeBaySelling ActiveList UnsoldList

DetailLevel: none, ReturnAll

Conditionally Specifies the number of new leads (unanswered emails) buyers have posted about the item. GetMyeBaySelling ActiveList

DetailLevel: none, ReturnAll

Conditionally This container is a list of Item Specific Name/Value pairs used by the seller to provide descriptive details of an item in a structured manner. If creating, revising, or relisting an item with an Add, Revise, or Relist call, it is recommended that you use the <a href="https://developer.ebay.com/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory" target="_blank">getItemAspectsForCategory</a> method of the Taxonomy API to retrieve mandatory and recommended Item Specifics for a category. Important: Effective from December 28th, 2024, sellers offering certain rechargeable devices in EU and Northern Ireland markets must comply with the Common Charger Directive (CCD) and list appropriate charger-related item specifics on their listings. See <a href="https://developer.ebay.com/api-docs/sell/static/inventory/common-charger-directive.html" target="_blank">Common Charger Directive</a> for more information. For ReviseItem only: When you revise a listing, if an auction listing has one or more bids and ends within 12 hours, you cannot change or add Item Specifics. If the auction listing has bids but ends in more than 12 hours, you cannot change existing Item Specifics, but you can add Item Specifics that were not previously included. If your listing is in a eBay product catalog-enabled category, certain Name/Value pairs will be accepted as product identifying information. The Name can be <code>Brand</code>, <code>MPN</code>, or a Global Trade Item Number (GTIN). GTINs are a set of globally recognized identifiers, including <code>EAN</code>, <code>ISBN</code>, and <code>UPC</code>. However, the Values provided for these Names must comply with eBay's constraints or they will not be recognized as product identifiers. The Value for Brand must be an actual brand name (except that if the item is not branded, Value can be <code>Unbranded</code>.) The Value for Brand or MPN cannot contain only special characters (e.g. <code>%$*#@</code>). All GTINs must comply with international formatting standards. For more details, see <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/item-specifics.html" target="_blank">Item Specifics</a>. If the ProductListingDetails container in an Add/Revise/Relist call is successfully used to find and use an eBay catalog product to create/revise listing, the seller should not remove or change the value of any Item Specific name or value that is defined as part of the eBay catalog product definition. Note: If a listing is associated with an eBay catalog product, the seller does not need to pass in any Item Specifics that are already defined in the eBay catalog product. Sellers can make a call to the <a href="https://developer.ebay.com/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory" target="_blank">getItemAspectsForCategory</a> method of the Taxonomy API to see if the category supports any 'instance aspects', which can be thought of as Item Specifics that are unique to the specific item that is being listed. Instance aspects are indicated if the corresponding <a href="https://developer.ebay.com/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory#response.aspects.aspectConstraint.aspectApplicableTo" target="_blank">aspectApplicableTo</a> field of the getItemAspectsForCategory response shows a value of <code>ITEM</code> (and not <code>PRODUCT</code>). Many categories support the following instance aspects: Custom Bundle, Bundle Description, Modified Item, Modification Description, and California Prop 65 Warning. These instance aspects allow the seller to provide more information about product bundles or modified products in a structured way. Depending on the category, there are other instance aspects as well. Note: To specify an item's condition, use the ConditionID field instead of a condition Item Specific. Use GetCategoryFeatures to see which categories support ConditionID and to get a list of valid condition IDs. (If you specify ConditionID and you also specify Condition as a Item Specific, eBay drops the condition Item Specific.) For GetItem: This list is returned only when you specify IncludeItemSpecifics in the request (and the seller included Item Specifics in their listing). If this container is included when revising or relisting an item, it will do a complete replace of the item's Item Specific values. This means that all newly input Item Specifics will replace all existing Item Specific values, regardless of if the values changed. It is advised that the seller run a <a href="https://developer.ebay.com/Devzone/xml/docs/reference/ebay/getitem.html" target="_blank">GetItem</a> call to see its current item specifics before attempting to update them. To delete all Item Specifics when you revise or relist, specify Item.ItemSpecifics in DeletedField, and don't pass ItemSpecifics in the request. Item Specifics https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/item-specifics.html AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetOrders Conditionally LinkedLineItem.Item The email and phone lead fee for a pay-per-lead item. GetMyeBaySelling Conditionally

DetailLevel: ReturnAll

Different Buyer protection schemes and the various status associated with each one of them. GetItem Conditionally Indicates a specific type of lead generation format listing, such as classified ad or local market best offer listing. Only applicable when ListingType = LeadGeneration. Note: ListingSubtype2 replaces the deprecated ListingSubtype field. If both are specified in a request, ListingSubtype2 takes precedence. About Local Market Listings https://pages.ebay.com/help/sell/motors-selling-locally.html Advertising with Classified Ads https://pages.ebay.com/help/sell/f-ad.html AddItem AddItems RelistItem ReviseItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Indicates whether the seller allows the bidder to request mechanical inspection services from RAC. For the Car category listings on the UK site. false GetItem Conditionally Specifies the details of policy violations if the item was administratively canceled. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItem Conditionally This field is used by sellers who want their listing to be returned in the search results for other eBay sites. This feature is currently only supported by the US, UK, eBay Canada, and eBay Ireland sites. See <a href=" https://pages.ebay.com/help/sell/globalexposure.html">Getting exposure on international sites</a> for full requirements on using this feature. There is a small listing fee for each country specified as a Cross Border Trade country. US listings that offer shipping to Canada, North America, or worldwide are automatically returned on eBay.ca at no extra charge, so US listings that offer shipping to these locations do not need to specify Canada as a Cross Border Trade country. Cross-border trading https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/cross-border-trading.html AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always Returns the seller's information (in a business card format) if the seller's SellerBusinessCodeType is set to <code>Commercial</code>. This is only applicable for sites where Business Seller options are supported. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

The eBay Best Price Guarantee price. The <a href=" https://pages.ebay.com.au/buy/Best_Price_Guarantee/">Best Price Guarantee</a> program is only available on the eBay Australia marketplace. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This container is returned if the seller has applied one or more buyer requirement criteria to the listing. Buyer requirement settings are managed in the Selling Preferences section of the seller's account in My eBay. GetBidderList GetSellerList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Describes the seller's return policy. Most categories on most eBay sites require the seller to clearly specify whether or not returns are accepted (see ReturnsAcceptedOption). Note: As a part of Digital Services Act (DSA) requirements, as of April 3, 2023, buyers in the EU must be allowed to return an item within 14 days or more, unless the item is exempt. Where applicable, sellers should update their return policies to reflect this requirement of accepting returns from EU buyers. This update can be made through the ReturnPolicy container or through a return business policy that is referenced through the SellerProfiles.SellerReturnProfile container. Note: If you are using a return business policy set up through My eBay or via the <a href="https://developer.ebay.com/api-docs/sell/account/resources/return_policy/methods/createReturnPolicy">Account API</a>, then you should not populate the fields in this ReturnPolicy container. Instead, indicate your return policy using the SellerProfiles.SellerReturnProfile container. However, if you do not configure a return policy, all the fields in this ReturnPolicy container that are marked conditional must be populated in your request. For the AddItem family of calls: Required for most categories on most sites. Use ReturnPolicyEnabled in GetCategoryFeatures to determine which categories require this field. Also use ReturnPolicyDetails in GeteBayDetails to determine which ReturnPolicy fields can be used on each site. Australia (AU) and US eBay Motors Parts and Accessories categories typically support but do not require a return policy. (However, we strongly recommend that you specify a clear return policy whenever possible.) For ReviseItem only: If the listing has bids or sales and it ends within 12 hours, you can't change the return policy details. If the listing is a GTC listing that has sales or ends within 12 hours (one or the other, but not both), you can add a return policy to the GTC listing (but you can't change return policy details if already present). If the listing has no bids or sales and more than 12 hours remain before the listing ends, you can add or change the return policy. When you revise your return policy, you only need to specify the fields you want to add or change. You don't need to specify all the other ReturnPolicy fields again. The other fields will retain their existing settings. For the GetItem family of calls: Only returned if the site you sent the request to supports the seller's return policy. Typically, the return policy details are only returned when the request is sent to the listing site. Note: The GeteBayDetails call can be used to retrieve site-wide return policy metadata, but it is recommended that sellers use the GetCategoryFeatures call instead, as this call was recently updated to retrieve category-level metadata for both domestic and international return policies. Note: In May 2018, eBay added the ability to create a separate international return policy for items that are shipped to international customers. If a seller does not add a separate international return policy, the settings in the domestic return policy will be used instead for international returns. For more information on setting separate domestic and international return policies, see the <a href="https://pages.ebay.com/seller-center/seller-updates/2018-summer/simplified-returns.html#international-returns-policy" target="_blank">International returns policy</a> help topic. For the international equivalent of this field, see the InternationalRefundMethodValues field. AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem Conditionally ReviseFixedPriceItem ReviseItem RelistFixedPriceItem RelistItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Specify a return policy https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/specify-return-policy.html Enables you to view the sites on which an item can be purchased, based on the payment methods offered for the item. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always Indicates whether you prefer to track your eBay listings by eBay Item ID or by your own SKU. If a seller will be converting an existing eBay listing into the new Inventory model using the bulkMigrateListings call of the Inventory API, the InventoryTrackingMethod value must be set to <code>ItemID</code> (default value), but the item must also have a SKU value (Item.SKU or Variation.SKU) associated with it. For GetItem and related calls: Only returned when the value is <code>SKU</code>; not returned when the value is <code>ItemID</code>. AddFixedPriceItem VerifyAddFixedPriceItem RelistFixedPriceItem No ItemID GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally eBay Merchant Data API AddFixedPriceItem and ReviseFixedPriceItem https://developer.ebay.com/DevZone/merchant-data/CallRef/index.html This field is no longer applicable as eBay sellers can no longer use iMCC gateway accounts to handle buyer payments. Note: This field will stop being returned in order management calls on January 31, 2024. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItems Conditionally Variations are similar (but not identical) items in a multiple-variation, fixed-price listing. For example, a T-shirt listing could contain multiple items of the same brand that vary by color and size (like "Blue, Large" and "Black, Medium"). Each variation specifies a combination of one of these colors and sizes. Each variation can have a different quantity and price. You can buy multiple items from one variation at the same time. (That is, one order line item can contain multiple items from a single variation.) If you list in two categories, both categories must support listing with variations. See VariationsEnabled in GetCategoryFeatures to determine applicable categories. For ReviseFixedPriceItem and RelistFixedPriceItem: Once a listing has been submitted with variations, you can't delete all the variations when you revise or relist the listing (because it would be considered a different listing). You also can't add or change variation specifics (because they are unique identifiers). However, you can delete or replace individual variations as needed to match your current inventory. If a variation has no purchases, use the Variation.Delete field to delete the variation. If it has inventory, set the Quantity to 0. As a best practice, if you want to revise multiple variations in the same listing at the same time (i.e., within a very short period), use a single ReviseFixedPriceItem request and include all the variation revisions in the same request. If your application design requires you to revise each variation individually, then avoid using multiple parallel threads. Instead, use a serial, synchronous process. That is, wait until each revision has been processed by eBay before submitting the next revision request for another variation in the same listing. For GetItem and related calls Only returned when a listing has variations. For GetSellerList: Only returned when a listing has variations, IncludeVariations was set to <code>true</code> in the request, the DetailLevel was set to ReturnAll, and an applicable pagination value and time range were specified. For GetItemTransactions Only returned in Item when a listing has variations and IncludeVariations was set to <code>true</code> in the request. (Also see Variation returned in Transaction for information about which variation was actually purchased.) For GetSellerEvents, GetMyeBayBuying, and GetMyeBaySelling: Only returned when a listing has variations and HideVariations was set to <code>false</code> or not specified in the request. Note: This container will stop being returned in GetItemTransactions on January 31, 2024. Multiple-variation listings https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/variations.html AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem No Qualifications for listing with variations https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/variations.html#qualifications GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally A list of parts compatibility information specified as name and value pairs. Describes an assembly with which a part is compatible (i.e., compatibility by application). For example, to specify a part's compatibility with a vehicle, the name (search name) would map to standard vehicle characteristics (e.g., Year, Make, Model, Trim, and Engine). The values would describe the specific vehicle, such as a 2006 Honda Accord. Use the Product Metadata API to retrieve valid search names and corresponding values. For the AddItem family of calls: Use this for specifying parts compatibility by application manually. This can only be used in categories that support parts compatibility by application. Use GetCategoryFeatures with the CompatibilityEnabled feature ID to determine which categories support parts compatibility by application. For ReviseFixedPriceItem and ReviseItem: When you revise a listing, if the listing has bids and/or ends within 12 hours, item compatibilities cannot be deleted. You may add item compatibilities at any time. For GetItem: ItemCompatibilityList is only returned if the seller included item compatibility in the listing and IncludeItemCompatibilityList is set to <code>true</code> in the GetItem request. Note: Compatibility includes only parts compatibility details that were specified manually; that is, they do not correspond to an eBay catalog product (listings not associated with a <a href="https://developer.ebay.com/devzone/XML/docs/Reference/eBay/GetItem.html#Response.Item.ProductListingDetails.ProductReferenceID" target="_blank">ProductReferenceID</a>). To retrieve parts compatibility details that do correspond to eBay catalog products, use the eBay Product API's getProductCompatibilities call. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No Product Metadata API Call Reference https://developer.ebay.com/DevZone/product-metadata/CallRef/index.html information on retrieving compatibility search names and corresponding values needed to specify compatibility by application manually Parts and accessories https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-motors-parts-accessories.html#search GetItem Conditionally Indicates the number of compatible applications specified for the given item. Applies to items listed with fitment by application only (either manually or with a catalog product that supports compatibility). Not returned if the item has no specified compatible applications. Not returned if IncludeItemCompatibilityList is specified in the request. To retrieve the list of compatibility information, set IncludeItemCompatibilityList to <code>true</code> in the request. Parts Compatibility is supported in limited Parts & Accessories categories for the eBay Motors (US) site (site ID 100) only. GetItem Conditionally This is a numeric identifier for an item's condition. All numeric Condition ID values map to an item condition string value. For example, numeric identifier <code>1000</code> maps to <code>New</code> condition. Important: For trading card listings in Non-Sport Trading Card Singles (<code>183050</code>), CCG Individual Cards (<code>183454</code>), and Sports Trading Card Singles (<code>261328</code>) categories, Condition ID 2750 can be used to specify the card as a Graded card and Condition ID 4000 can be used to specify the card as an Ungraded card. If either of these condition IDs are used, the seller is required to use the ConditionDescriptors container to provide one or more applicable Condition Descriptor name-value pairs. See the <a href="https://developer.ebay.com/devzone/XML/docs/Reference/eBay/AddItem.html#Request.Item.ConditionDescriptors">ConditionDescriptors</a> field description for more information. Most eBay listing categories require an item condition, but a few eBay categories do not (such as Digital Gift Cards or Antiques categories). To verify if the listing category requires an item condition, and if so, what are the supported item condition and ConditionID values, you can call GetCategoryFeatures. In this GetCategoryFeatures call, you'd pass in the listing CategoryID value and two FeatureID fields - one of these fields set to <code>ConditionEnabled</code>, and the other field set to <code>ConditionValues</code>. In the GetCategoryFeatures response, look at the Category.ConditionEnabled to see if item condition is required for the category. Then look at the Category.ConditionValues container in the response for the full list of Condition IDs that you can pass in through the ConditionID field of an Add/Revise/Relist/Verify call. Note that the Condition.DisplayName value in the response is the actual condition value that will appear in the actual eBay listing. If you pass in a ConditionID value that is not valid for the category, or if you don't pass in a ConditionID value at all for a category that requires it, the listing request fails. If you are listing in two categories (using a secondary category), it is the primary listing category that determines which ConditionID values are supported. For Revise/Relist calls: In most cases, you can change the ConditionID value (if applicable/warranted), with the exception being an auction listing that has one or more bids, or any listing that is scheduled to end in 12 hours or less. For GetItem: The ConditionID value is always returned if set for the listing. GetItem also returns the item condition string value in the ConditionDisplayName field. Note: On the US, Canada, UK, Germany, France, Italy, and Australia marketplaces, condition ID 2500 ('Seller Refurbished') can no longer be used in numerous categories. See <a href="https://developer.ebay.com/api-docs/sell/static/metadata/condition-id-values.html#Category" target="_blank">Category and marketplace support for the eBay Refurbished Program</a> for the full list. In these categories, the 'Seller Refurbished' item condition has been replaced by one of three new refurbished values, which include condition ID 2010 ('Excellent - Refurbished'), condition ID 2020 ('Very Good - Refurbished'), and condition ID 2030 ('Good - Refurbished'). To use any of these new refurbished item conditions, sellers must go through an application and qualification process. Any seller who is not eligible to use these new refurbished item conditions in these three categories will be blocked if they try to create a new listing or revise an existing listing with any of these three new item conditions. Sellers who are not eligible to list with the new refurbished item conditions, will need to use another item condition supported in these categories, such as condition ID 3000 ('Used'). Any seller that is interested in eligibility requirements to list with any refurbished item condition, including condition ID 2000 ('Certified - Refurbished'), should see the <a href="https://pages.ebay.com/seller-center/listing-and-marketing/ebay-refurbished-program.html" target="_blank">eBay Refurbished Program</a> page in Seller Center. Note: This field will stop being returned in order management calls on January 31, 2024. Item conditions https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/item-conditions.html ConditionValues in GetCategoryFeatures GetCategoryFeatures.html#Response.Category.ConditionValues Item Condition Look-up Table (and Automatic Mapping) https://pages.ebay.com/sellerinformation/news/itemconditionlookup.html AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This container is used in Add/Revise/Relist/Verify listing calls to designate the condition descriptors for the listing. It is also returned in GetItem to indicate the condition descriptors applied to the listing. For trading card listings in Non-Sport Trading Card Singles (<code>183050</code>), CCG Individual Cards (<code>183454</code>), and Sports Trading Card Singles (<code>261328</code>) categories, Condition ID <code>2750</code> can be used to specify the card as a Graded card and Condition ID <code>4000</code> can be used to specify the card as an Ungraded card. If either of these condition IDs are used, the seller is required to use this container to provide one or more applicable Condition Descriptor name-value pairs. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally This string field is used by the seller to more clearly describe the condition of items that are not brand new. The ConditionDescription field is available for all categories, including categories where the condition type is not applicable (e.g., Antiques). This field is applicable for all item conditions except 'New', 'Brand New', 'New with tags', and 'New in box'. If ConditionDescription is used with these conditions (Condition IDs 1000-1499), eBay will simply ignore this field if included, and eBay will return a warning message to the user. The ConditionDescription field is returned by GetItem (and other related calls that return the Item object) if a condition description is specified in the listing. Note: This field should not be included if ConditionDescriptors are being used. If it is used, a warning will be triggered and the field will be dropped from the listing. 1000 AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyRelistItem Conditionally GetSellerList Conditionally

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Fine, Medium

The human-readable label for the item condition. Display names are localized for the site on which they're listed (not necessarily the site on which they're viewed). Most categories use the same display name for the same condition ID. Some categories may override the display name based on buyer expectations for items in the category. For example, condition ID 1000 could be called "New" in one category and "New with tags" in another. Behind the scenes, eBay's search engine uses the ID (not the display name) to determine whether items are new, used, or refurbished. Only returned when the seller specified ConditionID in their listing. Note: This field will stop being returned in order management calls on January 31, 2024. 50 GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This container is used by the seller to provide Energy Efficiency Label information, hazardous material related information, product safety related information, manufacturer information, and the repair score for the listing. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem GetItems Conditionally Tax exception category code. This is to be used only by sellers who have opted into sales tax being calculated by a sales tax calculation vendor. If you are interested in becoming a tax calculation vendor partner with eBay, contact developer-relations@ebay.com. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem Conditionally GetItem

DetailLevel: ReturnAll

Conditionally Indicates the type of message that will be returned describing the quantity available for the item. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally The quantity threshold above which the seller prefers not to show the actual quantity available. Returned when the quantity available is greater than the value of quantity threshold. Currently, 10 is the only available value for this threshold. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally This container provides information for an item that has a Strikethrough Price (STP) or a Minimum Advertised Price (MAP) discount pricing treatment. STP and MAP apply only to fixed-price listings. STP is available on the US, eBay Motors, UK, Germany, Canada (English and French), France, Italy, Spain, and Ireland sites, while MAP is available only on the US site. Discount pricing is available to qualified sellers (and their associated developers) who participate in the Discount Pricing Program. Once qualified, sellers receive a 'special account flag' (SAF) that allows them to apply Discount Pricing to both single-variation and multi-variation items. STP is intended for eBay partners and their sellers only. As a seller listing Discount Price items, you are required to maintain records of your discount pricing in the event you are called upon to substantiate your item pricing. For AddFixedPriceItem, RelistFixedPriceItem, ReviseFixedPriceItem, and VerifyAddFixedPriceItem: If you are listing variations (MSKU items), use Variation.DiscountPriceInfo for each variation. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem No AddItem ReviseItem RelistItem VerifyAddItem VerifyRelistItem No GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally A descriptive free-text title for a US or CA eBay Motors vehicle listing. This title appears below eBay's pre-filled listing title on the View Item page (not at the top of the View Item page). It's also appended to the listing title in search results (like a subtitle) on the US eBay Motors site. Keywords in this title help buyers find or distinguish your listing. Applicable to listings in US eBay Motors Cars and Trucks, Motorcycle, and some of the Powersport, Boats and RV campers categories; or to Cars and Trucks listings on CA eBay Motors. This replaces the older US and Canada eBay Motors Subtitle attribute (attribute ID 4148). 80 AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem Conditionally RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem No This field displays the Vehicle Identification Number, which is a unique serial number for a motor vehicle. This field is applicable to listings in US eBay Motors Cars and Trucks (6001), Motorcycles (6024), Commercial Trucks (63732), RVs and Campers (50054), ATVs (6723), Snowmobiles (42595), and UTVs (173665); and to Cars and Trucks listings in CA, CAFR and AU eBay Motors. For vehicle categories that do not use VIN, make a call to the <a href="https://developer.ebay.com/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory" target="_blank">getItemAspectsForCategory</a> method of the Taxonomy API to determine applicable Item Specifics (such as 'Hull ID Number' for Boats). For the US, CA, and CA-FR eBay Motors categories, required for cars and trucks from model year 1981 and later. (The US developed national standards for VIN values in 1981.) For the eBay Australia site, required for vehicles from model year 1989 or later. For the eBay Australia site, only appears on the View Item page if you also specify the date of first registration in the listing's Item Specifics. Appears in the VIN field in the Item Specifics section of eBay's View Item page. GetItem will return this field for motor vehicle listings where the VIN is defined. 17 AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem Conditionally RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem No GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItem will return this field for motor vehicle listings where the VIN is defined. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Vehicle Registration Mark, which is a unique identifier for a motor vehicle in the UK. Applicable to listings in UK eBay Motors Cars and Trucks, Motorcycle, and some Powersport categories. Appears as a VRM field in the Item Specifics section of eBay's View Item page. On the View Item page, the VRM value is masked (i.e., only a portion of the value is shown to users). In the GetItem response, the VRM is only returned if the call is made by the seller (i.e., the AuthToken is associated with the vehicle's seller). GetItem will return this field for motor vehicle listings where the VRM is defined. AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem Conditionally RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem No GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItem will return this field for motor vehicle listings where the VRM is defined. GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This container is used if the seller would like to use/reference business policies to create, revise, relist, or verify their listing. The seller's account must be opted in to business policies to use this container. If this container is used, exactly one Payment Business Policy, one Shipping Business Policy, and one Return Business Policy must be specified and applied to the listing. If the seller's account is not opted in to business policies, that seller may not use this container. Sellers must opt-in to business policies through My eBay or by using the optInToProgram call of the eBay Account API. If business policies are applied to a listing, all payment, shipping, and return policy settings in these policies will override any other payment, shipping, or return policy legacy fields that are included in the call request. Note: To make sure that the shipping cost override and policies are set correctly on an item (that is using business policies and has one or more shipping service cost overrides set up), the Item.SellerProfiles.SellerShippingProfile container and the Item.ShippingServiceCostOverrideList.ShippingServiceCostOverride container(s) must be included, even if no changes are being made. This container is only returned in 'Get' calls if business policies are set for the listing, and the person making the API call is the seller of the listing. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem AddItems ReviseItem RelistItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents GetMyeBaySelling Conditionally This container is used when the seller wants to override the flat shipping costs for all domestic and/or all international shipping services defined in the shipping business policy referenced in the SellerProfiles.SellerShippingProfile.ShippingProfileID field. Shipping costs include the cost to ship one item, the cost to ship each additional identical item, and any shipping surcharges applicable to domestic shipping services. A ShippingServiceCostOverrideList.ShippingServiceCostOverride container is required for each domestic and/or international shipping service that is defined in the domesticShippingPolicyInfoService and intlShippingPolicyInfoService containers of the shipping business policy. Note: To make sure that the shipping cost override and policies are set correctly on an item (that is using business policies and has one or more shipping service cost overrides set up), the Item.SellerProfiles.SellerShippingProfile container and the Item.ShippingServiceCostOverrideList.ShippingServiceCostOverride container(s) must be included, even if no changes are being made. Shipping service cost overrides are a listing-level concept, and the shipping costs specified through each ShippingServiceCostOverrideList.ShippingServiceCostOverride container will not change the shipping costs defined for the same shipping services in the shipping business policy. For Revise and Relist calls: To delete all shipping service cost overrides when you revise or relist, specify Item.ShippingServiceCostOverrideList in DeletedField, and don't pass ShippingServiceCostOverrideList in the request. No AddFixedPriceItem AddItem AddItems VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem GetItem GetItems GetSellerList Conditionally Container consisting of dimension and size details related to a shipping package in which an item will be sent. The information in this container is applicable if the seller is using calculated shipping or flat rate shipping using shipping rate tables with weight surcharges. This container is only returned in the Get calls if specified for the item. Note: For ReviseItem and ReviseFixedPriceItem calls: For <a href ="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-flat-rate.html">flat-rate</a> shipping, if any of the ShippingPackageDetails fields are defined for the current listing, those fields must be included again in the revise call even if their values are not changing. If you do not do this, some/all of the fields under this container may be removed from the listing. To find out the values included in the current listing, call <a href="https://developer.ebay.com/devzone/xml/docs/Reference/eBay/GetItem.html#GetItem">GetItem</a> and look through the ShippingPackageDetails container in the response. Note: Package weight and dimensions are only supported for the following marketplaces: AU, CA, DE, IT, UK, US, and Motors. If this information is provided on other marketplaces, it will be ignored. AddFixedPriceItem AddItem AddItems VerifyAddItem VerifyAddFixedPriceItem Conditionally RelistFixedPriceItem RelistItem VerifyRelistItem ReviseFixedPriceItem ReviseItem No GetItem Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-package-size.html Package dimensions and weight This boolean field is returned as <code>true</code> if the listing was created by a Top-Rated Seller and the listing has all of the requirements that qualifies it as a Top-Rated Plus listing. The Top-Rated Seller program is only available on the US, UK, and Germany sites. See the <a href="https://pages.ebay.com/help/sell/top-rated.html#what">Top-Rated Seller requirements</a> help topic for more information on qualifying as a Top-Rated Seller and the <a href="https://pages.ebay.com/help/sell/top-rated.html#plus">Top-Rated Plus listing requirements</a> help topic for more information on what a listing must offer to qualify as a Top-Rated Plus listing and get the Top-Rated Plus badge. Information on the overall program can be found on the <a href="https://pages.ebay.com/sellerinformation/build-your-business-online/status-standards/top-rated-seller.html">Top-Rated Seller home page</a> in the Seller Center. GetItem Conditionally This container is used by the seller to restrict the quantity of items that may be purchased by one buyer during the duration of a fixed-price listing (single or multi-variation). This is an optional container that can be used with an Add, Revise, or Relist call. This container is not applicable to auction listings. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No This value sets the minimum price threshold for a seller's product price in a fixed-price listing. Regardless of the product price on eBay Value Box or Amazon listings, the seller's product price will not be reduced lower than this dollar value. This value is only applicable to sellers enabled to use the Dynamic Pricing API, and if a dynamic pricing rule is assigned to the listing's product. ReviseItem ReviseFixedPriceItem No This value sets the maximum price threshold for a seller's product price in a fixed-price listing. Regardless of the product price on Amazon or eBay Value Box, the seller's product price will not be raised higher than this dollar value. This value is only applicable to sellers enabled to use the Dynamic Pricing API, and if a dynamic pricing rule is assigned to the listing's product. If this field is not specified through the Dynamic Pricing API, an eBay system-level threshold is used to avoid any undesirable results. ReviseItem ReviseFixedPriceItem No This boolean field is returned as <code>true</code> if the item is eligible is to be shipped internationally via eBay's Global Shipping Program. With the Global Shipping Program, the buyer pays a single shipping fee for the order, which includes the domestic shipping leg, the international shipping leg, and handling charges, and import charges. eBay uses a shipping partner that allows the seller to ship the package to a domestic location and then the shipping partner takes care of the rest, including the international shipping leg. GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally This container provides information about the weight, volume or other quantity measurement of a listed item. The European Union requires listings for certain types of products to include the price per unit so buyers can accurately compare prices. eBay uses the UnitType and UnitQuantity values and the item's listed price to calculate and display the per-unit price on eBay EU sites. This container will only be returned if price per unit information exists for the listing, and the IncludeItemSpecifics field was included in the call request and set to <code>true</code>. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally The identifier of the original listing that contained the item before the item was relisted. This field is only returned for an item that was relisted. GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally This string value provides more details about the item's condition. GetItem GetItems

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally This boolean field is returned as <code>true</code> if the listing has been hidden from all searches occurring on eBay. If a listing is hidden from eBay searches, the reason can be found in the ReasonHideFromSearch field. GetItem GetSellerList GetMyeBaySelling Conditionally This field is returned only when the listing is currently being hidden from any searches occurring on eBay. Listings may be hidden from search if an active listing is currently out of stock or if the listing has been determined by eBay to be a duplicate listing. GetItem GetSellerList GetMyeBaySelling Conditionally This container is used in Add/Revise/Relist/Verify listing calls by the seller to enable a listing with the 'In-Store Pickup' feature. The 'In-Store Pickup' feature is only available to a limited number of large retail merchants in the US, Canada, UK, Germany, and Australia marketplaces. This container is returned in the 'Get' calls if the listing is enabled with the In-Store Pickup feature. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem GetSellerList No GetItem GetSellerList GetItemShipping Conditionally This boolean field is returned as <code>true</code> if the actual quantity of a multiple-quantity, fixed-price listing (indicated in the Item.Quantity field) can not be accurately determined by eBay. GetItem Conditionally This field is only returned if <code>true</code>, and indicates that the 'Click and Collect' feature is available for this item. With Click and Collect, buyers are able to purchase from thousands of sellers on the eBay UK, Australia, and Germany sites, and then pick up their order from the nearest 'eBay Collection Point'. Note that an item may be eligible for Click and Collect, but this logistics option will only surface if the prospective buyer is within the vicinity of an 'eBay Collection Point'. The Click and Collect feature is only available on the eBay UK, Australia, and Germany sites. For more information about Click and Collect, see the <a href="https://ebay.co.uk/clickandcollect/">Click and Collect</a> home page on the eBay UK site, the <a href="https://sellercentre.ebay.com.au/click-and-collect">Click and Collect</a> home page on the eBay Australia site, or the <a href="https://pages.ebay.de/einkaufen/click-and-collect.html">Click and Collect</a> home page on the eBay Germany site. Not all categories on the UK, Australia, and Germany sites support Click and Collect listings. To verify if a specific category on these eBay sites support Click and Collect listings, use the <a href="https://developer.ebay.com/DevZone/XML/docs/Reference/eBay/GetCategoryFeatures.html">GetCategoryFeatures</a> call, passing in one or more CategoryID values and a PickupDropOffEnabled value in the FeatureID field. Look for a <code>true</code> value in the PickupDropOffEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Note: For Click and Collect eligible sellers, the Click and Collect feature can only be enabled at the account level, and then each of the seller's listings will be automatically evaluated for Click and Collect eligibility. GetItem Conditionally For 'Click and Collect' eligible sellers, this field was once used to set 'Click and Collect' eligibility at the listing level. However, now the seller can only opt in to 'Click and Collect' at the account level, and then each of their listings will be automatically evaluated for 'Click and Collect' eligibility. Note: Until this field is fully deprecated in the Trading WSDL (and in Add/Revise/Relist/Verify calls), it can still be used, but it will have no functional affect. However, if set in an Add/Revise/Relist/Verify call, it will get returned in GetItem, but it won't be a true indicator if the item is available for the 'Click and Collect' logistics type. Instead, the Item.AvailableForPickupDropOff field should be referenced to see if the item is available for 'Click and Collect'. GetItem Conditionally This container is used in Add/Revise/Relist/Verify listing calls to designate the listing as a digital gift card listing. It is also returned in GetItem to indicate that the listing contains a digital gift card. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem Conditionally AddSellingManagerTemplate ReviseSellingManagerTemplate GetSellingManagerTemplates GetItems GetSellingManagerTemplates The boolean value that is returned in this field will indicate whether or not a digital gift card can be delivered by email to the buyer or recipient of the gift card. This field is only applicable to digital gift card listings. GetItem Conditionally This boolean field indicates whether or not the listing description is HTTPS secure/compliant. To be HTTPS secure/compliant, the Item.Description field may not contain any links to site pages that use the HTTP (and not HTTPS) protocol. This field will be returned with each listing that is found unless one or more OutputSelector fields are used and <code>Item.IsSecureDescription</code> is not one of the values passed in to one of these fields. If this field is returned as <code>true</code>, the listing is HTTPs secure/compliant, and the whole listing description will appear on the View Item page for the listing. If this field is returned as <code>false</code>, the listing is not HTTPs secure/compliant, and only a partial/brief listing description will appear on the View Item page for the listing, with a link to the full listing description that will load in another tab. If the listing description is not HTTPS compliant, the fix is to call ReviseItem or ReviseFixedPriceItem and update the Item.Description field, removing all links to HTTP pages. For more information about why eBay made this change, please see the <a href="http://pages.ebay.com/seller-center/seller-updates/2017-fall/policy-updates.html" target="_blank">Policy Updates</a> page of the Fall 2017 Seller Updates page. GetItem GetSellerList GetSellerEvents Conditionally A reference identifier used to attribute the source of data across API families. This ID is returned in the response of a call to the Inventory Mapping API. To ensure continuity and traceability of the data flow, you must include this reference ID in any Add, Revise, or Relist item request. Using this ID associates requests with the original source used to create the listing. 25 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem No FixedPriceExcludeStoreInventory, ExcludeStoreInventory, AllItemTypes, AllFixedPriceItemTypes, AdFormat Enumerated type containing values that provide more information on the type of filtering the buyer used when setting up a Saved Search in My eBay. When setting up filtering for the Saved Search, the buyer was only looking for auction items (with or without the Buy It Now option), so only selected the Auction checkbox in the Format dialog box. When this filter is used in a Saved Search, fixed-price items and classified ad listings are not retrieved for the buyer. When setting up filtering for the Saved Search, the buyer was looking for all fixed-price items and auction items with Buy It Now available, so only selected the Buy It Now checkbox in the Format dialog box. When this filter is used in a Saved Search, auction items (without the Buy It Now option) and classified ad listings are not retrieved for the buyer. When setting up filtering for the Saved Search, the buyer was looking for all items closely associated with the search term, so selected all buying formats (Auction, Buy It Now, and Classified Ads). All items are retrieved for the buyer, including auction items (with or without the Buy It Now option), fixed-price items, and classified ad listings. When setting up filtering for the Saved Search, the buyer was only looking for items sold by sellers with eBay stores, so selected the Sellers with eBay stores checkbox in the Seller dialog box. When this filter is used in a Saved Search, only items for sale in an eBay store are retrieved for the buyer. Excludes listings that have listing type set to StoresFixedPrice. Excludes listings that have listing type set to AdType. Excludes auction listings in which BuyItNowEnabled is false. Excludes listings that have listing type set to StoresFixedPrice. Retrieves listings whether or not listing type is set to StoresFixedPrice; include auction items. Retrieves fixed-price items. Whether StoresFixedPrice items are retrieved does not depend on the site default. The StoresFixedPrice items are retrieved after the basic fixed price items. Items are retrieved whether or not listing type is set to StoresFixedPrice. Does not retrieve items for which listing type is AdType. Does not retrieve auction items for which BuyItNowEnabled is false. Reserved for internal or future use. When setting up filtering for the Saved Search, the buyer was only looking for classified ad listings, so only selected the Classified ads checkbox in the Format dialog box. When this filter is used in a Saved Search, auction (with or without the Buy It Now option) and fixed-price items are not retrieved for the buyer. Restricts listings to return only items that have the Ad Format feature. Type defining the KTypeSupported field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as KTypeSupported is included as a FeatureID value in the call request, or no FeatureID values are passed into the call request). The KTypeSupported field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support specifying parts compatibility through a K Type vehicle number. At this time, this feature is only supported for car and truck listings on the Germany site. To verify if a specific category supports specifying parts compatibility through a K Type vehicle number, pass in a KTypeSupported value in the request, and then look for a <code>true</code> value in the KTypeSupported field of the corresponding Category node (match up the CategoryID values if more than one category ID was passed in the request). This type provides information about one order line item in a package. The package can contain multiple units of a given order line item. The number of units of the order line item in this package; this is required for customs. The seller must ensure that this matches the quantity of the order line item enclosed in the package. This value must be a positive integer, and it can't be greater than the quantity of this item specified in the original transaction. This field is a required field in CompleteSale if the order type is a Global Shipping Program (GSP) order. SetShipmentTrackingInfo No CompleteSale Conditionally Conditionally The Country of Manufacture for the order line item; this is required for customs. This should identify the country in which more than 50% of the value of the item was created. This value must conform to the ISO 3166 two-letter country code standard. To see the list of currently supported codes, and the English names associated with each code (e.g., KY="Cayman Islands"), call GeteBayDetails with DetailName set to CountryDetails. CompleteSale SetShipmentTrackingInfo No The item description of the order line item, based on its ItemID. CompleteSale SetShipmentTrackingInfo No Unique identifier for the eBay listing associated with the order line item. A multiple-quantity listing can have multiple order line items, but only one ItemID value. Unless an OrderLineItemID or SKU value is specified in the same node, this field is required for each ItemTransactionID node included in the request. CompleteSale SetShipmentTrackingInfo No Unique identifier for an eBay order line item (transaction). The TransactionID should match the ItemID specified in each ItemTransactionID node included in the request. Optionally, an OrderLineItemID value can substitute for the ItemID/TransactionID pair. The TransactionID value for auction listings is always <code>0</code> since there can be only one winning bidder/one sale for an auction listing. Note: Historically, TransactionID values have been '0' for auction listings, and some developers may have built logic around this. However, non-zero TransactionID values for auction listings started being used for some eBay marketplaces beginning in July 2024, and all eBay marketplaces are expected to start using non-zero TransactionID values for auction listings in the near future. If necessary, developers should update code to handle non-zero transaction IDs for auction transactions. CompleteSale SetShipmentTrackingInfo No Contains data that links line item objects from separate orders. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This container shows a line item that is related to the corresponding order, but not a part of that order. Details can identify the linked seller and also include delivery times, item information, and order information. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Contains details of linked line item objects. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The unique identifier of the order to which the linked line item belongs. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The unique identifier of the linked order line item. For example, the order line item ID of the tire. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The eBay user ID of the seller who sold the linked line item. For example, the user ID of the tire seller. Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The EstimatedDeliveryTimeMin and EstimatedDeliveryTimeMax timestamps indicate the original estimated window during which delivery can be expected. The EstimatedDeliveryTimeMax value indicates the latest date and time to receive the order. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The EstimatedDeliveryTimeMin and EstimatedDeliveryTimeMax timestamps indicate the original estimated window during which delivery can be expected. The EstimatedDeliveryTimeMin value indicates the earliest date and time to receive the order. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Container consisting of details about the linked item. Note: All item specifics for the listing are returned. The name/value pairs returned are in the language of the linked line item's listing site, which may vary from the seller's language. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Various details about a listing. Some of the details are calculated or derived after an item is listed. The details in this type include the start and end time and the converted (localized) prices. The details in this type also include input values applicable to the Best Offer feature. Additional details in this type include flags indicating if a seller specified fields whose values are not visible to the requesting user. If <code>true</code>, the item is listed in a Mature category. Users must accept the Mature Category agreement on the eBay site to retrieve items listed in Mature categories. (Users do not need to sign this agreement to be able to list items in Mature Categories.) Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Medium, Fine

Conditionally Applicable for Real Estate auctions only. If <code>true</code>, buyers and sellers are expected to follow through on the sale. If false, bids for the Real Estate auction are only expressions of interest. Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Medium, Fine

Conditionally Indicates whether or not the seller's Checkout Enabled preference is turned on. Note: A 'Checkout Enabled' setting is no longer available to sellers, and this field is always returned as <code>true</code>. Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Medium, Fine

Conditionally Converted value of the BuyItNowPrice in the currency of the site that returned this response. For active items, refresh this value every 24 hours to pick up the current conversion rates. Note: The ListingDetails.ConvertedBuyItNowPrice field will stop being returned in GetItemTransactions, GetSellerTransactions, and GetMyeBaySelling (SoldList and DeletedFromSoldList) on January 31, 2024. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Medium, Fine

Conditionally GetMyeBayBuying SecondChanceOffer BestOfferList BidList WatchList

DetailLevel: none, ReturnAll

Conditionally GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always Converted value of the StartPrice in the currency of the site that returned this response. For active items, refresh this value every 24 hours to pick up the current conversion rates. In multi-variation listings, this value matches the lowest-priced variation that is still available for sale. Note: The ListingDetails.ConvertedStartPrice field will stop being returned in GetItemTransactions, GetSellerTransactions, and GetMyeBaySelling (SoldList and DeletedFromSoldList) on January 31, 2024. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetMyeBayBuying BidList LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always Converted value of the ReservePrice in the currency of the site that returned this response. Only returned for listings with a reserve price when the requesting user is the listing's seller. For active items, refresh this value every 24 hours to pick up the current conversion rates. Not applicable to fixed-price listings. Note: The ListingDetails.ConvertedReservePrice field will stop being returned in GetItemTransactions, GetSellerTransactions, and GetMyeBaySelling (SoldList and DeletedFromSoldList) on January 31, 2024. GetBidderList Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally If <code>true</code>, the seller specified a value in ReservePrice. Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Medium, Fine

Conditionally Indicates the new item ID for a re-listed item. When an item is re-listed, the item ID for the new item is added to the old listing, so buyers can navigate to the new listing. This value only appears when the old listing is retrieved. The RelistedItemID of the original item will reflect the last relist. Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally The item ID for the original listing from which a second chance offer is made. This value is only returned when the data for the second chance offer listing is retrieved. Output only. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally The StartTime value returned by non-search calls such as GetItem is the time stamp (in GMT) for when the item was listed. GetBidderList Always GetItem Always GetMemberMessages Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying BestOfferList BidList LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally Time stamp (in GMT) when the listing is scheduled to end (calculated based on the values of StartTime and ListingDuration ) or the actual end time if the item has ended. GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetBestOffers

DetailLevel: none, ReturnAll

Conditionally GetItemsAwaitingFeedback GetMemberMessages Conditionally GetMyeBayBuying BidList LostList SecondChanceOffer WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling BidList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally The URL of the Web page where a user can view the listing. On the US site, this is called the View Item page. If you enabled affiliate tracking in a search-related call (for example, if you used the AffiliateTrackingDetails container in an applicable call), ViewItemURL contains a string that includes affiliate tracking information (see the <a href= "https://www.ebaypartnernetwork.com" target="_blank">eBay Partner Network</a>). Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetMyeBayBuying WatchList

DetailLevel: none, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Indicates whether the item has any unanswered questions. Use GetMemberMessages to retrieve unanswered questions for the item if this flag indicates that there are any. GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItemTransactions

DetailLevel: ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Indicates whether the item has any publicly displayed messages. Use GetMemberMessages to retrieve public messages for the item if this flag indicates that there are any. Note: The HasPublicMessages field will stop being returned in GetItemTransactions and GetSellerTransactions, on January 31, 2024. GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Indicates whether the Buy It Now feature is available for an auction listing. As a general rule, once an auction listing has bids (and the high bid exceeds the reserve price, if any), the Buy It Now feature becomes disabled for the listing. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Specifies the minimum acceptable Best Offer price. If a buyer submits a Best Offer that is below this value, the offer is automatically declined. This applies only to items listed in categories that support the Best Offer auto-decline feature. In order for this setting to have an effect, Best Offer must be enabled for the listing, and this value will only be exposed to the seller who listed the item. For Revise and Relist calls: If a seller wanted to disable the Best Offer auto-accept and/or Best Offer auto-reject feature when revising or relisting an item, the full path to one or both of these two corresponding fields would be provided in a DeletedField tag, like the following: <pre><code> <DeletedField>Item.ListingDetails.MinimumBestOfferPrice</DeletedField> </code></pre> Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. AddFixedPriceItem AddItem AddItems ReviseFixedPriceItem ReviseItem RelistItem RelistFixedPriceItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally This field is needed if the seller is selling a motor vehicle through a Motors Local Listing. The string value supplied in this field actually sets the radius of the area (in miles) in which the vehicle will be available and exposed to interested local buyers. The seller's supplied PostalCode or Location field value will be used as the center point for this radius. There is a closed set of radius values that can be set in this field, and it depends on the seller's subscription level. The user can call GetCategoryFeatures, including <code>LocalListingDistances</code> as a FeatureID value to retrieve the local listing distances supported by a given site, category, and Local Market subscription level. AddItem AddItems AddFixedPriceItem Conditionally This URL takes you to the same View Item page as ViewItemURL, but this URL is optimized to support natural search. That is, this URL is designed to make items on eBay easier to find via popular Internet search engines. The URL includes the item title along with other optimizations. To note, "?" (question mark) optimizes to "_W0QQ", "&" (ampersand) optimizes to "QQ", and "=" (equals sign) optimizes to "Z". If you are an eBay affiliate, use this URL to promote your affiliate information. Note: This URL may include additional query parameters that don't appear in ViewItemURL and vice versa. You should not modify the query syntax. For example, eBay won't recognize the URL if you change QQ to ?. Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally The price at which Best Offers are automatically accepted. Similar in use to MinimumBestOfferPrice. If a buyer submits a Best Offer that is at or above this value, the offer is automatically accepted by the seller. This applies only to items listed in categories that support the BestOfferAutoAcceptPrice feature. For this setting to have an effect, the Best Offer feature must be enabled for the listing, and only the seller who listed the item will see BestOfferAutoAcceptPrice in a call response. For Revise and Relist calls: If a seller wanted to disable the Best Offer Auto-Accept and/or Best Offer Auto-Reject feature when revising or relisting an item, the full path to one or both of these two corresponding fields would be provided in a DeletedField tag, like the following: <pre><code> <DeletedField>Item.ListingDetails.BestOfferAutoAcceptPrice</DeletedField> </code></pre> AddFixedPriceItem AddItem AddItems ReviseFixedPriceItem ReviseItem RelistItem RelistFixedPriceItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally This field is only returned if the item was ended early (before listing duration expired) by the seller (through an API call or on the Web site) or ended administratively by eBay. The value in this field indicates the seller's reason for ending the listing early. GetItem Conditionally This enumerated type contains the list of values that can be used by the seller to set the duration (number of days or Good 'Til Cancelled) of a listing. Listing durations available to the seller vary based on the site, category, listing type, and the seller's selling profile, so it is a best practice for the seller to call GetCategoryFeatures with ListingDurations included as a FeatureID value in the call request. The GetCategoryFeatures response will include the complete list of listing duration values that can be used for the various listing types. This value is used to set the duration of the listing to one day. A one-day listing duration is typically only available to sellers with a Feedback score of 10 or higher, so sellers with a Feedback score of less than 10 may be restricted from using a one-day listing duration. The seller can call GetCategoryFeatures with ListingDurations included as a FeatureID value in the call request to see if the one-day listing duration is available. A one-day listing duration is generally applicable to an auction listing or to a Real Estate Classified Ad. This value is used to set the duration of the listing to three days. This value is used to set the duration of the listing to five days. This value is used to set the duration of the listing to seven days. This value is used to set the duration of the listing to 10 days. This value is used to set the duration of the listing to 14 days. This value is used to set the duration of the listing to 21 days. Note: A 21-day listing duration was typically only applicable to eBay Motors Local Market vehicle listings, but this listing duration is no longer valid/supported. This value is used to set the duration of the listing to 30 days. Note: In October 2018, this listing duration was enabled for eBay Motors Local Listings, and replaced the formerly supported <code>Days_21</code> enumeration value. This value is used to set the duration of the listing to 60 days. A 60-day listing duration is typically only applicable to Classified Ad listings in specific categories. This value is used to set the duration of the listing to 90 days. A 90-day listing duration is generally only applicable to a Real Estate Classified Ad. This value is used to set the duration of the listing to 120 days. An 120-day listing duration is typically only applicable to Classified Ad listings in specific categories. This value is used to set the duration of the listing to 'Good 'Til Cancelled. This option is available for fixed-price and Classified Ad listings. "Good 'Til Cancelled" fixed-price listings will be relisted automatically each month until all inventory is sold out (e.g., Item.Quantity=0 in a single-variation fixed-price listing, or all occurences of Item.Variations.Variation.Quantity=0 in a multi-variation fixed-price listing), or the seller ends the fixed-price listing. Note: The <code>GTC</code> (Good 'Til Cancelled) value is the only supported listing duration for fixed-price listings on all eBay marketplaces and categories except for motor vehicle listings on eBay Motors US, and on the eBay UK and eBay Italy sites. Note: As long as a fixed-price listing has inventory available, or if the out-of-stock control feature is being used, GTC listings are automatically renewed each month according to the calendar day. This value is reserved for internal or future use. Type used by the ListingDurations container that is returned for each listing type supported for the eBay site. ListingDurations container shows the supported listing duration times for each listing type. All values returned in the Duration fields indicate the listing durations that are supported for that listing type. The allowed durations vary according to the type of listing. The value <code>GTC</code> means Good 'Til Canceled. The complete list of enumeration values that may be returned in this field is shown in ListingDurationCodeType. ListingDurationCodeType GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally The integer value in this attribute identifies the type of listing to which the set of durations applies. To match a durationSetID value to a specific listing type, see the Category.ListingDuration field in the call response. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally A type used by the ListingDurations container node that is returned in the response of GetCategoryFeatures call. A ListingDurations container is returned for each listing type supported for the eBay site, and the supported listing duration times for those listing types. A ListingDurations container is returned for each listing type supported for the eBay site, and the supported listing duration times for those listing types. The durationSetID attribute value indicates the listing type. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This attribute indicates the current version of the Listing Durations data. This can be helpful to let users know when modifications have been made to Listing Durations. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Identifies the type of listing as an attribute on the ListingDuration node. The type of listing a set of durations describes. GetCategoryFeatures

DetailLevel: ReturnAll

Unknown, Auction, Half Conditionally Note: This enumerated type is no longer applicable, as the Featured First listing feature is deprecated for all sites. If a seller attempts to add Featured First as a listing enhancement (including ListingEnhancement field in an AddItem call and setting its value to <code>Featured</code>), it is allowed, but a warning will be returned announcing the deprecation of the feature. This feature was officially wired off in September 2019. This enumerated type contains the list of values that can be used by the seller to set the duration of a Featured Gallery in a fixed-price listing. Once set for a listing, the Featured Gallery duration can be increased from 'Days_7' to 'Lifetime' (throughout life of listing), but the duration cannot be decreased from 'Lifetime' to 'Days_7'. This value sets the Featured Gallery duration to one day. This value is deprecated. This value sets the Featured Gallery duration to two days. This value is deprecated. This value sets the Featured Gallery duration to three days. This value is deprecated. This value sets the Featured Gallery duration to four days. This value is deprecated. This value sets the Featured Gallery duration to five days. This value is deprecated. This value sets the Featured Gallery duration to six days. This value is deprecated. This value sets the Featured Gallery duration to seven days. If a listing has a Featured Gallery duration of seven days, it is possible to revise that item and set the Featured Gallery duration to 'Lifetime' (throughout life of listing) ( This value sets the Featured Gallery duration to eight days. This value is deprecated. This value sets the Featured Gallery duration to nine days. This value is deprecated. This value sets the Featured Gallery duration to 10 days. This value is deprecated. This value sets the Featured Gallery duration to 11 days. This value is deprecated. This value sets the Featured Gallery duration to 12 days. This value is deprecated. This value sets the Featured Gallery duration to 13 days. This value is deprecated. This value sets the Featured Gallery duration to 14 days. This value is deprecated. This value sets the Featured Gallery duration to 15 days. This value is deprecated. This value sets the Featured Gallery duration to 16 days. This value is deprecated. This value sets the Featured Gallery duration to 17 days. This value is deprecated. This value sets the Featured Gallery duration to 18 days. This value is deprecated. This value sets the Featured Gallery duration to 19 days. This value is deprecated. This value sets the Featured Gallery duration to 20 days. This value is deprecated. This value sets the Featured Gallery duration to 21 days. This value is deprecated. This value sets the Featured Gallery duration to 22 days. This value is deprecated. This value sets the Featured Gallery duration to 23 days. This value is deprecated. This value sets the Featured Gallery duration to 24 days. This value is deprecated. This value sets the Featured Gallery duration to 25 days. This value is deprecated. This value sets the Featured Gallery duration to 26 days. This value is deprecated. This value sets the Featured Gallery duration to 27 days. This value is deprecated. This value sets the Featured Gallery duration to 28 days. This value is deprecated. This value sets the Featured Gallery duration to 29 days. This value is deprecated. This value sets the Featured Gallery duration to 30 days. This value is deprecated. This value sets the Featured Gallery duration to 31 days. This value is deprecated. This value sets the Featured Gallery duration to 32 days. This value is deprecated. This value sets the Featured Gallery duration to 33 days. This value is deprecated. This value sets the Featured Gallery duration to 34 days. This value is deprecated. This value sets the Featured Gallery duration to 35 days. This value is deprecated. This value sets the Featured Gallery duration to 36 days. This value is deprecated. This value sets the Featured Gallery duration to 37 days. This value is deprecated. This value sets the Featured Gallery duration to 38 days. This value is deprecated. This value sets the Featured Gallery duration to 39 days. This value is deprecated. This value sets the Featured Gallery duration to 40 days. This value is deprecated. This value sets the Featured Gallery duration to 41 days. This value is deprecated. This value sets the Featured Gallery duration to 42 days. This value is deprecated. This value sets the Featured Gallery duration to 43 days. This value is deprecated. This value sets the Featured Gallery duration to 44 days. This value is deprecated. This value sets the Featured Gallery duration to 45 days. This value is deprecated. This value sets the Featured Gallery duration to 46 days. This value is deprecated. This value sets the Featured Gallery duration to 47 days. This value is deprecated. This value sets the Featured Gallery duration to 48 days. This value is deprecated. This value sets the Featured Gallery duration to 49 days. This value is deprecated. This value sets the Featured Gallery duration to 50 days. This value is deprecated. This duration enables the Featured Gallery feature for the life of the listing. Once the Featured Gallery duration is set to 'Lifetime' for a listing, it cannot be changed. This value is reserved for internal or future use. Defines the Listing Enhancement Duration feature. If the field is present, the corresponding feature applies to the category. The field is returned as an empty element (i.e., a boolean value is not returned). Note: This type is no longer applicable, as the Featured Gallery listing feature is being deprecated for all sites. If a seller attempts to add Featured Gallery as a listing enhancement, it is allowed, but a warning will be returned announcing the deprecation of the feature. This feature was wired off in September 2019. Type used by the GalleryFeaturedDurations container that is returned at the SiteDefaults and Category level in a GetCategoryFeatures response. GalleryFeaturedDurations container consists of the supported time durations that a picture gallery can be featured Note: Duration fields are currently still being returned in GetCategoryFeatures response, but Featured Gallery listing feature is deprecated for all sites. If a seller attempts to add Featured Gallery as a listing enhancement, it is allowed, but a warning will be returned announcing the deprecation of the feature. Each returned Duration field indicates a supported time duration that a picture gallery can be featured. The <code>Lifetime</code> value indicates that the Featured Gallery enhancement will be active for the lifetime of the listing. ListingEnhancementDurationCodeType GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Type defining the listing upgrades that may be available to the seller when listing or revising an item. Note: <code>BoldTitle</code> is the only enum value that can be used in the ListingEnhancement field. BoldTitle, CustomCode This enumeration value is deprecated. This value is used if the seller wants the listing title to be in boldface type. This feature will incur a listing fee. Note that this enhancement will not put the listing subtitle in boldface type (if a subtitle is used). This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. This enumeration value is deprecated. Reserved for internal or future use. eBay Listing Enhancements Codes Code List Agency - eBay, Inc. Code List Version - 1.0 This type is used by the ListingFeatureDetails container in the GeteBayDetails response. This container indicates the listing features that are enabled or disabled for an eBay site. Border, Highlight, ProPack, GiftIcon The enumeration value returned in this field indicates whether or not the Bold Title featured is enabled for the eBay site. If this feature is available for an eBay site, the seller can pass in <code>BoldTitle</code> as an enumeration value in the ListingEnhancement field of an Add/Revise/Relist call. GeteBayDetails Always Note: The Picture Border feature is no longer available on any eBay marketplace site, so this value should not be used in Add/Revise/Relist calls, and will not be returned in 'Get' calls. Defines the availability of the Picture Border feature for the site. GeteBayDetails Always Note: The Highlight feature is no longer available on any eBay marketplace, so this value should not be used in Add/Revise/Relist calls, and will not be returned in 'Get' calls. Defines the availability of the Highlight feature for the site. GeteBayDetails Always Note: The Gift Icon feature is no longer available on any eBay marketplace. Defines the availability of the Gift Icon feature for the site. GeteBayDetails Always Note: Home Page Featured is no longer available on any eBay marketplace. The enumeration value returned in this field indicates whether or not the Home Page Featured feature is enabled for the eBay site. If this feature is available for an eBay site, the seller can pass in <code>HomePageFeatured</code> as an enumeration value in the ListingEnhancement field of an Add/Revise/Relist call. GeteBayDetails Always Note: Featured First is no longer available on any eBay marketplace. The enumeration value returned in this field indicates whether or not the Featured First feature is enabled for the eBay site. As of October 2017, this listing feature is only available to Top-Rated Sellers on the Germany site. GeteBayDetails Always Note: Featured Plus is no longer available on any eBay marketplace. The enumeration value returned in this field indicates whether or not the Featured Plus feature is enabled for the eBay site. GeteBayDetails Always Note: The Pro Pack Bundle feature is no longer available on any eBay marketplace. Defines the availability of the Pro Pack Bundle for the site. GeteBayDetails Always Returns the current version of details. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always Gives the time in GMT that the feature flags for the details were last updated. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always Type defining the ListingStartPriceDetails container returned in GeteBayDetails. The ListingStartPriceDetails container lists the minimum start price for auction listings, the minimum sale price for fixed-price listings, and the minimum percentage value that a Buy It Now price for an auction listing must be above the minimum start price for that same listing. The ListingStartPriceDetails container is returned if ListingStartPriceDetails is included as a DetailName filter in the request, or if no DetailName filters are used in the request. This value is a string description of the listing type for which the pricing data is intended, such as "Pricing for the auction-like listings". GeteBayDetails Conditionally This value indicates the listing type of the listing, and is a value defined in ListingTypeCodeType enumerated type. The only possible values for this field are 'Chinese' (auction listing) and 'FixedPriceItem'. Chinese, FixedPriceItem GeteBayDetails Conditionally For auction listings, the StartPrice indicates the lowest dollar value that can be set for the item's Starting bid. For fixed-price listings, the StartPrice indicates the lowest dollar value that can be set for the item's sale price. GeteBayDetails Conditionally Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always This field is only returned and applicable for auction listings. This float value indicates the minimum percentage value that a Buy It Now price for an auction listing must be above the Starting bid price for that same listing. On the US eBay Motors site (Site ID 100), this field only applies to the Parts and Accessories categories. GeteBayDetails Conditionally 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., total price and buyer/high bidder) and the transaction fees. The listing is still active or the listing has ended with a sale but eBay has not completed processing the sale details. If the listing has ended with a sale but this Active status is returned, please allow several minutes for eBay to finish processing the listing. The listing has ended. If the listing ended with a sale, eBay has completed processing of the sale. All sale information returned from eBay should be considered accurate and complete. However, the transaction fees are not yet available. The listing has closed and eBay has completed processing the sale. All sale information returned from eBay should be considered accurate and complete. In this state, all transaction fees should be calculated. Reserved for internal or future use. Reserved for internal or future use. This enumerated type defines the two subtypes that can be used if the main listing type (in ListingType field) is <code>LeadGeneration</code>. A ListingSubtype2 value must be specified if the ListingType value is set to <code>LeadGeneration</code>. This value indicates that the lead generation listing is a classifed ad. Note that only some eBay categories support classified ad listings. Use the GetCategoryFeatures call (with FeatureID value set to <code>AdFormatEnabled</code>) to see which categories support classified ad listings. This value indicates that the lead generation listing is a US Motors Local Market listing. Note that only some eBay Motors categories support Motors Local Market listings. Use the GetCategoryFeatures call (with the SITEID header set to <code>100</code> and the FeatureID value set to <code>LocalMarketAdFormatEnabled</code>) to see which eBay Motors categories support Motors Local Market listings. Reserved for internal or future use This enumerated type contains the valid selling formats for eBay listings. StoresFixedPrice, Dutch, Live, Express, Half, Shopping Unknown or undefined auction type. Applicable to user preferences and other informational use cases. This value indicates an auction listing. In an auction listing, prospective buyers engage in a competitive bidding process, although Buy It Now may be offered as long as no bids have been placed. Auctions occur on the eBay marketplace site, and the auction listings will also appear in the seller's eBay Store (if the seller has an eBay Store). Although listing durations may vary by eBay marketplace and category, typical listing durations for auctions are 3, 5, 7, and 10 days. It is recommended that the seller uses the GetCategoryFeatures call to retrieve the actual listing durations that are supported for auctions on a particular marketplace and category. This value is no longer applicable. This value is no longer applicable. This enumeration value is only applicable to the GetMyeBaySelling call. This value is used in the ActiveList.ListingType field if the seller only wants to retrieve active listings that are in the auction format. This enumeration value represents a classified ad in a Real Estate category. This listing type is only used to solicit inquiries from interested parties. To express interest, a buyer fills in a contact form that eBay forwards to the seller as a lead. This format does not enable buyers and sellers to transact online through eBay, and eBay Feedback is not available for ad format listings. Although listing durations may vary by eBay marketplace and category, typical listing durations for real estate ads are 30 and 90 days. It is recommended that the seller uses the GetCategoryFeatures call to retrieve the actual listing durations that are supported for real estate ads on a particular marketplace and category. This value is no longer applicable. Second chance offer made to a non-winning bidder on an ended listing. A seller can make an offer to a non-winning bidder when either the winning bidder has failed to pay for an item or the seller has a duplicate of the item. A seller can create a Second Chance Offer immediately after a listing ends and up to 60 days after the end of the listing. eBay does not charge an Insertion Fee, but if the bidder accepts the offer, the regular Final Value Fee is charged. In the case of an Unpaid Item, the seller should ensure that everything has been done to resolve the issue with the winning bidder before sending a Second Chance Offer to another bidder. See the Unpaid Items Process for details. Make sure you're aware of other rules and restrictions surrounding Second Chance Offers. Use AddSecondChanceItem to submit Second Chance Offers. Listed on eBay, but does not appear when browsing or searching listings. With this listing format, the selling is offering the item at a fixed price, although it is still possible for the seller to negotiate the price with prospective buyers using the Best Offer feature. A fixed-price listing can offer a single item, or if the seller has multiple quantity of the same item, multiple quantity of that same item can be made available for sale through the same listing. Additionally, the seller can set up a multiple-variation, fixed-price listing, where similar items can be sold through the same listing. An example of a multiple-variation, fixed-price listing might be a t-shirt (or another article of clothing) that is available in multiple color and size combinations. Traditionally, listing durations for fixed-prices listings have varied by eBay marketplace and category. Typical listing durations for fixed-price listings ranged from three to 30 days, or GTC (Good 'Til Cancelled). As of April 1, 2019, 'GTC' is the only supported listing duration for all eBay marketplaces with the following exceptions: <ul> <li>The following eBay Motors US categories are exempt from this change: Cars & Trucks (6001), Motorcycles (6024), Other Vehicles & Trailers (6038), Boats (26429), Powersports (66466).</li> <li>All child categories under Cars, Motorcycles & Vehicles (9800) categories on the eBay UK and eBay Italy sites are also exempt from this change. </li> </ul> With the 'GTC' listing duration, the listing will remain active as long as the listing shows that inventory is available for purchase (available quantity is '1' or more). For sellers listing motor vehicles on the eBay US Motors, eBay UK, or eBay Italy sites, it is recommended that the seller uses the GetCategoryFeatures call to retrieve the supported listing durations for their particular marketplace and category. Note: As long as a fixed-price listing has inventory available, or if the out-of-stock control feature is being used, GTC listings are automatically renewed each month according to the calendar day. Note: This listing type is no longer applicable as the Half.com site has been shut down. This enumeration value represents a (non-Real Estate) classified ad listing. The <code>AdType</code> enumeration value represents Real Estate classified ads. This listing type is only used to solicit inquiries from interested parties. To express interest, a buyer fills in a contact form that eBay forwards to the seller as a lead. This format does not enable buyers and sellers to transact online through eBay, and eBay Feedback is not available for ad format listings. Non-Real Estate classified ads are only available in a limited number of eBay categories, including Business and Industrial categories, Travel, ans Specialty Services. Although listing durations may vary by eBay marketplace and category, typical listing durations for (non-Real Estate) classified ads are 30, 60, and 90 days. It is recommended that the seller uses the GetCategoryFeatures call to retrieve the actual listing durations that are supported for real estate ads on a particular marketplace and category. This value is no longer applicable. This value is no longer applicable, as Shopping.com is no longer a property of eBay, Inc. Reserved for internal or future use. Defines the LocalListingDistancesNonSubscription feature. This feature displays all the supported local listing distances for items listed by sellers who have not subscribed to either Local Market for Vehicles or Local Market for Specialty Vehicles. Defines the LocalListingDistancesRegular feature. This feature displays all the supported local listing distances for items listed by sellers subscribed to Local Market for Vehicles. Defines the LocalListingDistancesSpecialty feature. This feature displays the supported local listing distances for items listed by sellers subscribed to Local Market for Specialty Vehicles. Defines the AdFormatEnabled feature. If the field is present, the corresponding feature applies to the category. This field is returned as an empty element (e.g., a boolean value is not returned). Added for Local Market users. Indicates whether automatic acceptance of Best Offers is allowed for this category for Motors Local Market listings. Returned only if this category overrides the site default. Indicates whether automatic declination of Best Offers is allowed for this category for Motors Local Market listings. Returned only if this category overrides the site default. Indicates whether Contact Seller is enabled for Classified Ads. Added for Local Market users. Indicates whether the category supports the use of the company name to contact the seller for Classified Ad format listings. Added for Local Market users. Indicates whether the category supports using an address when contacting the seller for Classified Ad format listings. Added for Local Market users. Indicates whether the category supports the use of email to contact the seller for Classified Ad format listings.Added for Local market users. Indicates whether the category supports using the telephone as a contact method. Added for Local Market users. Indicates whether counter offers to Best Offers are allowed for this category for Motors Local Market listings. Returned only if this category overrides the site default. Defines the LocalMarketNonSubscription feature. If the field is present, the corresponding feature applies to the category. The field is returned as an empty element (i.e., a boolean value is not returned). Indicates whether the category supports the use of payment method checkOut for Classified Ad format listings. Added for Local market users. Indicates which phone option the category supports when contacting the seller about listings in Classified Ad format. Added for Local Market users. Defines the LocalMarketPremiumSubscription feature. If this field is present, the corresponding feature applies to the category. The field is returned as an empty element (i.e., a boolean value is not returned). Defines the LocalMarketRegularSubscription feature. If this field is present, the corresponding feature applies to the category. The field is returned as an empty element (i.e., a boolean value is not returned). A subscription for Local Market for Vehicles will be returned by GetUser if a dealer has subscribed to any of the following Local Market Regular sub-types: Vehicles Regular Six Months, Vehicles Regular Special Promotion, Vehicles Regular Multistore Level S, Vehicles Regular Multistore Level M, or Vehicles Regular Multistore Level L. Each of these sub-types has a separate discount and billing cycle. Defines the SellerContactDetailsEnabled feature. If the field is present, the category allows retrieval of seller-level contact information. The field is returned as an empty element (e.g., a boolean value is not returned). Added for Local Market users. Indicates if shipping options are available for Classified Ad format listings in the category. Added for Local Market users. Defines the LocalMarketSpecialitySubscription feature. If this field is present, the corresponding feature applies to the category. The field is returned as an empty element (i.e., a boolean value is not returned). Indicates which address option the category supports for Classified Ad format listings. Added for Local Market users. This enumerated type is used by OrderType and TransactionType to indicate which logistics plan was selected by the buyer at the order or order line item level. Currently, this type is only supporting the "Click and Collect" and digital gift card use cases, but more logistics plan types may be added in the future. This value indicates that the buyer has selected "Click and Collect" as the logistics plan. With the 'Click and Collect' feature, a buyer can purchase certain items on eBay and collect them at a local store. Buyers are notified by eBay once their items are available. The "Click and Collect" feature is only available to large merchants on the eBay UK (site ID - 3), eBay Australia (Site ID - 15), and eBay Germany (Site ID - 77) sites. This value indicates that the order or order line item is a digital gift card that will be delivered to the buyer or the recipient of the gift card by email. This value is reserved for internal or future use. Type that provides the name and contact detail information for the manufacturer of the item. Note: As a part of General Product Safety Regulation (GPSR) requirements effective on December 13th, 2024, sellers operating in, or shipping to, EU-based countries or Northern Ireland are conditionally required to provide product manufacturer information in their eBay listings. For more information on GPSR, see <a href = "https://www.ebay.com/sellercenter/resources/general-product-safety-regulation" target="_blank">General Product Safety Regulation (GPSR)</a>. The company name of the product manufacturer. 100 characters for this field AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally The first line of the product manufacturer's street address. 180 characters for this field AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally The second line of the product manufacturer's street address. This field is not always used, but can be used for secondary address information such as 'Suite Number' or 'Apt Number'. 180 characters for this field AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem GetItems Conditionally The city of the product manufacturer's street address. 64 characters for this field AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally The state or province of the product manufacturer's street address. 64 characters for this field AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally The postal code of the product manufacturer's street address. 9 characters for this field AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally The two letter <a href="https://www.iso.org/iso-3166-country-codes.html" target="_blank">ISO 3166-1</a> standard abbreviation of the country of the product manufacturer's address. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally The product manufacturer's business phone number. 64 characters for this field AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally The product manufacturer's business email address. 180 characters for this field AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally The product manufacturer's business contact URL. 250 characters for this field AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally Describes an individual mark-up or mark-down event. eBay will automatically mark an application as down if attempts to deliver a notification fail repeatedly. eBay may mark an application down manually under certain circumstances. Whether the application has been marked up or marked down. GetNotificationsUsage Conditionally Time when the application was marked up or marked down. GetNotificationsUsage Conditionally Describes how the application was marked down, automatically or manually. When an application is automatically marked down, eBay will ping the application periodically, and if communication is restored, eBay will automatically mark the application up. If your application is marked down manually, you must contact eBay Developer Support to get your application marked up. A Reason is not provided for mark up events. GetNotificationsUsage Conditionally Valid application status codes, either MarkUp (application was marked up, communication is restored) or MarkDown (application was marked down, no communication). Status indicating the application was or is marked up. Status indicating the application was marked down. Reserved for future internal or external use. List of objects representing markup or markdown events for a given application and time period. If no time period is specified in the request, the information for only one day (24 hours before the time the call is made to the time the call is made) is included. The maximum time period is allowed is 3 days (72 hours before the call is made to the time the call is made). Details for a MarkDown or MarkUp event. GetNotificationsUsage Conditionally Type used by the MaxFlatShippingCostCBTExempt field that is returned under the FeatureDefinitions container. The MaxFlatShippingCostCBTExempt field is returned as empty and indicates that a maximum flat-rate shipping cost is not imposed by the corresponding eBay site if the item is being shipped internationally. This field will not be returned if one or more FeatureID fields are included in the call request and MaxFlatShippingCostCBTExempt is not one of the values passed into those FeatureID fields. Type used by the MaxFlatShippingCost field that is returned under the FeatureDefinitions container. The MaxFlatShippingCost field is returned as empty and indicates that a maximum flat-rate shipping cost threshold is enforced for some categories on the corresponding eBay site. This field will not be returned if one or more FeatureID fields are included in the call request and MaxFlatShippingCost is not one of the values passed into those FeatureID fields. Type used by the MaxGranularFitmentCount field that is returned under the FeatureDefinitions container. The MaxGranularFitmentCount field is returned as empty and indicates that a maximum parts compatibility threshold is applicable to some motor vehicle parts and accessory categories on the corresponding eBay site. This field will not be returned if one or more FeatureID fields are included in the call request and MaxGranularFitmentCount is not one of the values passed into those FeatureID fields. Defines the maximum limit on compatible applications as part of the parts compatibility feature. If the field is present, the corresponding feature applies to the site. The field is returned as an empty element (e.g., a boolean value is not returned). Parts compatibility listings contain information to determine the assemblies with which a part is compatible. For example, an automotive part or accessory listed witih parts compatibility can be matched with vehicles (e.g., specific years, makes, and models) with which the part or accessory can be used. There are two ways to enter parts compatibility: by application and by specification. <ul> <li> Entering parts compatibility by application specifies the assemblies (e.g., a specific year, make, and model of car) to which the item applies. This can be done automatically by listing with a catalog product that supports parts compatibility, or manually, using Item.ItemCompatibilityList when listing or revising an item. </li> <li>Entering parts compatibility by specification involves specifying the part's relevant dimensions and characteristics necessary to determine the assemblies with which the part is compatible (e.g., Section Width, Aspect Ratio, Rim Diammeter, Load Index, and Speed Rating values for a tire) using attributes.</li> </ul> Although the MaximumBuyerPolicyViolations container is still returned in GeteBayDetails, a Maximum Buyer Policy Violations threshold value can no longer be set at the account or listing level, so this type is no longer applicable. As a Maximum Buyer Policy Violations threshold value can no longer be set at the account or listing level, this field is no longer applicable. GeteBayDetails Conditionally As a Maximum Buyer Policy Violations threshold value can no longer be set at the account or listing level, this field is no longer applicable. GeteBayDetails Conditionally This type is deprecated as sellers can no longer set a buyer policy violation threshold Buyer Requirement at the listing-level in Add/Revise/Relist calls. This field is deprecated. 4 1065 NoOp 1065 This field is deprecated. Days_30 1065 NoOp 1065 This type is used by the MaximumItemRequirements container that is returned under the BuyerRequirementDetails in the GeteBayDetails. The Maximum Item Requirement settings of Buyer Requirements allow a seller to restrict the quantity of a line item that may be purchased during a consecutive 10-day period. Values returned in this field indicate the maximum quantity of an order line item that one buyer can purchase during a consecutive 10-day period. GeteBayDetails Conditionally A Minimum Feedback Score threshold can be added to the Maximum Item Requirement rule if the seller only wishes to restrict possible buyers with low Feedback scores. The values returned in this field indicate the minimum Feedback Score thresholds that can be used. GeteBayDetails Conditionally Type used by the MaximumItemRequirements container to specify the maximum quantity of an order line item that a prospective buyer may purchase during any given 10-day period. This field indicates the maximum quantity of a line item that one prospective buyer may purchase from the listing. This buyer requirement is only applicable to fixed-price listings where multiple quantity is available for purchase. If the MinimumFeedbackScore field is also set/returned, the maximum quantity threshold value will only apply to those prospective buyers who don't meet or exceed the minimum Feedback score threshold returned in that field. If the MinimumFeedbackScore field not set/returned, the maximum quantity threshold value will apply to all prospective buyers. This field is always returned along with the MaximumItemRequirements container. GetBidderList GetSellerList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally AddSellingManagerTemplate ReviseSellingManagerTemplate If this field is returned, it indicates that the seller has set a maximum quantity threshold value, but this maximum quantity threshold value (returned in MaximumItemCount will only apply to those prospective buyers who don't meet or exceed the minimum Feedback score threshold returned in this field. If this field is not returned, the maximum quantity threshold value will apply to all prospective buyers. GetBidderList GetSellerList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally AddSellingManagerTemplate ReviseSellingManagerTemplate Type defining the MaximumUnpaidItemStrikesCount container that is returned in the GeteBayDetails response. The MaximumUnpaidItemStrikesCount container consists of multiple Count fields with values that can be used in the BuyerRequirementDetails.MaximumUnpaidItemStrikesInfo.Count field when using the Trading API to add, revise, or relist an item. The Item.MaximumUnpaidItemStrikesInfo container in Add/Revise/Relist API calls is used to block buyers with unpaid item strikes equal to or exceeding the specified Count value during the specified Period value from buying/bidding on the item. GeteBayDetails Conditionally Each value returned in each MaximumUnpaidItemStrikesCount.Count field can be used in the BuyerRequirementDetails.MaximumUnpaidItemStrikesInfo.Count field when using the Trading API to add, revise, or relist an item. GeteBayDetails Conditionally Type used by the MaximumUnpaidItemStrikesDuration container that is returned in GeteBayDetails. The MaximumUnpaidItemStrikesDuration container indicates the periods of time that can be used when evaluating how many unpaid item strikes against a buyer during this given period will exclude the prospective buyer from purchasing the line item. GeteBayDetails Conditionally The period is the number of days (last 60 days, last 180 days, etc.) during which the buyer's unpaid item strikes are calculated. This is applicable only to sellers. GeteBayDetails Conditionally The description of the period, such as 'month', 'quarter', or 'half a year'. The data in this field can be used as a label in your application's display. This is applicable only to sellers. GeteBayDetails Conditionally Details of a buyer's maximum unpaid item strikes in a pre-defined time period. This is applicable only to sellers. The number of the maximum unpaid item strikes. This is applicable only to sellers. GeteBayDetails Conditionally Range of time used to determine maximum unpaid item count. This is applicable only to sellers. GeteBayDetails Conditionally Type defining the MaximumUnpaidItemStrikesInfo container, which indicates if the seller has enabled a setting to block prospective buyers who have unpaid items and/or buyer-inititated cancellations on their account exceeding the value set in the Count field during a specified time period (set in the Period field). This integer value indicates the maximum number of unpaid items and/or buyer-initiated cancellations that a prospective buyer is allowed to have during a specified time period (MaximumUnpaidItemStrikesInfo.Period) before being blocked from buying or bidding on the item. GetBidderList GetSellerList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally AddSellingManagerTemplate ReviseSellingManagerTemplate This enumerated value defines the length of time over which a prospective buyer's unpaid items and/or buyer-initiated cancellations will be counted. If the prospective buyer's number of unpaid items and/or buyer-initiated cancellations during this defined period exceeds the value set in the MaximumUnpaidItemStrikesInfo.Count field, that prospective buyer is blocked from buying/bidding on the item. If the Count value is 2, and the specified Period is <code>Days_30</code> (counting back 30 days from the present day), any prospective buyer that has had three or more unpaid items and/or buyer-initiated cancellations is blocked from buying/bidding on the item. GetBidderList GetSellerList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally AddSellingManagerTemplate ReviseSellingManagerTemplate Type is used by the MemberMessage container that is returned in the GetMemberMessages and GetAdFormatLeads calls. The MemberMessage container will consists of one or more member messages that meet the input criteria in the call request. Each MemberMessageExchange container consists of detailed information about a member-to-member message. GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally GetMemberMessages Conditionally Container for message metadata. The item about which the question was asked. Returned if the parent container is returned. GetMemberMessages Conditionally Contains all the information about the question being asked. Returned if the parent container is returned. GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally GetMemberMessages Conditionally An answer to the question. Returned if the parent container is returned. For GetAdFormatLeads, returned if the seller responded to the lead's question. Contains the body of the seller's response message. GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally GetMemberMessages Conditionally Status of the message. Returned if the parent container is returned. GetMemberMessages Conditionally Date the message was created. Returned if the parent container is returned. GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally Date the message was last modified. Returned if the parent container is returned. GetMemberMessages Conditionally Media details stored as part of the message. GetMemberMessages Conditionally Container for individual message information. Type of message being retrieved. Note that some message types can only be created via the eBay Web site. GetMemberMessages Conditionally Context of the question (e.g. Shipping, General). AddMemberMessageAAQToPartner Yes GetMemberMessages Conditionally Indicates if a copy of the messages is to be emailed to the sender. If omitted, this defaults to whatever the user set in preferences. omitted AddMemberMessageAAQToPartner AddMemberMessageRTQ AddMemberMessagesAAQToBidder No Indicates if the member message is viewable in the item listing. AddMemberMessageRTQ No GetMemberMessages Conditionally The eBay user ID of the person who asked the question or sent the message. Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. Note: Effective September 26, 2025, both usernames and public user IDs will be accepted in this field. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetMemberMessages Conditionally SenderEmail contains the static email address of an eBay member, used within the "reply to" email address when the eBay member sends a message. (Each eBay member is assigned a static alias. The alias is used within a static email address.) SenderEmail is returned if MessageType is AskSellerQuestion. SenderEmail is also returned in the AskSellerQuestion notification. The following functionality of this field has been deprecated: return of a dynamic email address. GetMemberMessages Conditionally Recipient's eBay user ID. For AddMemberMessagesAAQToBidder, it must be the seller of an item, that item's bidder, or a user who has made an offer on that item using Best Offer. Note: maxOccurs is a shared schema element and needs to be unbounded for AddMemberMessagesAAQToBidder. For AddMemberMessageRTQ, this field is mandatory if ItemID is not in the request. For all other uses, there can only be one RecipientID. Note: Effective September 26, 2025, both usernames and public user IDs will be accepted in this field. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. AddMemberMessageAAQToPartner AddMemberMessageRTQ AddMemberMessagesAAQToBidder Yes AddMemberMessageRTQ GetMemberMessages Conditionally Subject of this email message. GetMemberMessages Conditionally AddMemberMessageAAQToPartner Yes Content of the message is input into this string field. HTML formatting is not allowed in the body of the message. If plain HTML is used, an error occurs and the message will not go through. If encoded HTML is used, the message may go through but the formatting will not be successful, and the recipient of the message will just see the HTML formatting tags. 2000 AddMemberMessageAAQToPartner AddMemberMessageRTQ Yes 1000 AddMemberMessagesAAQToBidder Yes GetAdFormatLeads

DetailLevel: ReturnAll

Conditionally 4000 GetMemberMessages Conditionally ID that uniquely identifies a message for a given user. This value is not the same as the value used for the GetMyMessages MessageID. However, this MessageID value can be used as the GetMyMessages ExternalID. GetMemberMessages Conditionally ID number of the question to which this message is responding. AddMemberMessageRTQ Yes Media details attached to the message. AddMemberMessageAAQToPartner AddMemberMessageRTQ AddMemberMessageCEM AddMemberMessageAAQToSeller No GetMemberMessages Conditionally Type used by the Program container that is returned in the response of the GetUser call if the seller is enrolled in one or more eBay membership programs, such as eBay Plus. The Program container provides the eBay site, program (such as '<code>EBAYPLUS</code>'), and the membership expiration date. Note: Currently, eBay Plus is available only to buyers on Germany and Australia marketplaces. In Australia, the seller has no control/responsibility over setting the eBay Plus feature for a listing. Instead, eBay will evaluate/determine whether a listing is eligible for eBay Plus. This value indicates the name of the membership program, such as <code>EBAYPLUS</code>. This field will always be returned with each Program container. GetUser

DetailLevel: none,ReturnAll

Conditionally This enumeration value indicates the eBay site for which the seller is enrolled in a membership program. This field will always be returned with each Program container. GetUser

DetailLevel: none,ReturnAll

Conditionally This dateTime value is the expiration date of the seller's membership within the program specified in the ProgramName field. This field will always be returned with each Program container. GetUser

DetailLevel: none,ReturnAll

Conditionally Type used by the Membership container that is returned in the response of the GetUser call if the seller is enrolled in one or more eBay membership programs such as eBay Plus. Note: Currently, eBay Plus is available only to buyers on Germany and Australia marketplaces. A Program container will be returned for each eBay membership program for which the seller is enrolled. This container provides the the eBay site, the membership program (such as '<code>EBAYPLUS</code>'), and the membership expiration date. GetUser

DetailLevel: none,ReturnAll

Conditionally This type is deprecated. This value is not used. This value is not used. This value is not used. This enumerated type is deprecated. This value is not used. This value is not used. This value is not used. Container for the image file that is to be sent in a message, which lets sellers share photos in messages using the API. The photo must be uploaded by the seller or buyer to <a href="https://developer.ebay.com/devzone/xml/docs/reference/ebay/uploadsitehostedpictures.html">EPS (eBay Picture Services)</a> using a separate API call or the web flow. After the image is on the eBay server, you can use AddMemberMessage calls to pass the URL of the image in a message. The uploaded images will be available as part of the email as a thumbnail image. Clicking on the thumbnail, opens a larger version of the image in a filmstrip. The image name will be displayed on the title of the filmstrip component. These uploaded images will also be returned as MessageMediaType arrays in the GetMemberMessages and GetMyMessages API response. It doesn't matter if an image was uploaded using the web flow or using the API, it can be accessed using either the web flow or the API and web. URL of an image to be included in a message. The image must be uploaded to <a href="https://developer.ebay.com/devzone/xml/docs/reference/ebay/uploadsitehostedpictures.html">EPS (eBay Picture Services)</a> using a separate API call or the web flow. This URL will be validated and if it doesn't exist, the request will fail. 200 AddMemberMessageAAQToPartner AddMemberMessageRTQ Conditionally GetMemberMessages GetMyMessages Conditionally The name of the image. This will be displayed on the flimstrip. 100 AddMemberMessageAAQToPartner AddMemberMessageRTQ Conditionally GetMemberMessages GetMyMessages Conditionally This enumerated type is used to indicate whether or not a question has been answered. The question has been answered at least once. The question has not yet been answered. Reserved for future or internal use. Member to Member message initiated by bidder/potential bidder to a seller of a particular item. Member to Member message initiated as a response to an Ask A Question message. Note: This value is not supported in the MailMessageType field of a GetMemberMessages request. Member to Member message initiated by any eBay member to another eBay member. Note: This value is not supported in the MailMessageType field of a GetMemberMessages request. Member message between order partners within 90 days after creation of the order. Note: This value is not supported in the MailMessageType field of a GetMemberMessages request. Member to Member message initiated as a response to a Contact eBay Member message. Note: This value is not supported in the MailMessageType field of a GetMemberMessages request. Reserved Member to Member message initiated by any eBay member to another eBay member who has posted on a community forum within the past 7 days. Note: This value is not supported in the MailMessageType field of a GetMemberMessages request. Reserved Reserved for future or internal use. Note: This value is not supported in the MailMessageType field of a GetMemberMessages request. All message types. Member to Member message initiated by sellers to their bidders during an active listing. Note: This value is not supported in the MailMessageType field of a GetMemberMessages request. Reserved Member message initiated after eBay receives an email sent by an eBay member's email client to another eBay member. Note: This value is not supported in the MailMessageType field of a GetMemberMessages request. Indicates that an inquiry has been sent to the seller regarding the corresponding classified ad listing. Note: This value is not supported in the MailMessageType field of a GetMemberMessages request. Indicates that a Best Offer has been made on the seller's corresponding classified ad listing. This message type is only applicable to Classified categories that allow the Best Offer feature, such as motor vehicles. Note: This value is not supported in the MailMessageType field of a GetMemberMessages request. Defines the minimum requirement for compatible applications as part of the parts compatibility feature. If the field is present, the corresponding feature applies to the site. The field is returned as an empty element (e.g., a boolean value is not returned). Parts compatibility listings contain information to determine the assemblies with which a part is compatible. For example, an automotive part or accessory listed witih parts compatibility can be matched with vehicles (e.g., specific years, makes, and models) with which the part or accessory can be used. There are two ways to enter parts compatibility: by application and by specification. <ul> <li> Entering parts compatibility by application specifies the assemblies (e.g., a specific year, make, and model of car) to which the item applies. This can be done automatically by listing with a catalog product that supports parts compatibility, or manually, using Item.ItemCompatibilityList when listing or revising an item. </li> <li>Entering parts compatibility by specification involves specifying the part's relevant dimensions and characteristics necessary to determine the assemblies with which the part is compatible (e.g., Section Width, Aspect Ratio, Rim Diammeter, Load Index, and Speed Rating values for a tire) using attributes.</li> </ul> This enumerated type defines the special price treatments that can be set up for listings enabled with the Minimum Advertised Price feature. The Minimum Advertised Price (MAP) feature is only supported on the eBay US site. This enumeration value indicates that the buyer must add the item to his/her cart before the discounted price can be displayed. To enable this pricing treatment when adding/revising/relisting an item, include the DiscountPriceInfo.MinimumAdvertisedPriceExposure field in an Add/Revise/Relist calls and set its value to <code>PreCheckout</code>. This enumeration value indicates that the discounted price will only be shown to the buyer once the buyer reaches the eBay Checkout page. To enable this pricing treatment when adding/revising/relisting an item, include the DiscountPriceInfo.MinimumAdvertisedPriceExposure field in an Add/Revise/Relist calls and set its value to <code>DuringCheckout</code>. The value None is no longer valid. If provided in the request, it will be mapped to <code>PreCheckout</code>. Reserved for future use. Type defining the MinimumFeedbackScore container that is returned in GeteBayDetails. The MinimumFeedbackScore container consists of the values that can be used as the threshold value for a buyer's Minimum Feedback Score in Buyer Requirements. The Feedback Score for a potential buyer must be greater than or equal to the specified value, or that buyer is blocked from buying the item. For the MinimumFeedbackScore container to appear in the GeteBayDetails response, BuyerRequirementDetails must be one of the values passed into the DetailName field in the GeteBayDetails request (or, no DetailName filters should be used). Note: Although the MinimumFeedbackScore container is still returned in GeteBayDetails, sellers can no longer set a buyer's Minimum Feedback Score threshold Buyer Requirement at the listing-level in Add/Revise/Relist calls. Each value that is returned in this field can be used as an account-level Minimum Feedback Score. Sellers can no longer set a buyer's Minimum Feedback Score threshold Buyer Requirement at the listing-level in Add/Revise/Relist calls. The Feedback Score for a potential buyer must be greater than or equal to the specified value in the seller's account settings, or that buyer is blocked from buying the item. One or more FeedbackScore fields are always returned with the MinimumFeedbackScore container. 1065 NoOp 1065 Defines the Minimum Reserve Price feature. If the field is present, the feature applies to the category. The field is returned as an empty element (i.e., a boolean value is not returned). This enumerated type defines the values that can be used when adding, modiying, or deleting a shipping discount profile (through the ModifyActionCode field in SetShippingDiscountProfiles). This value is used in a SetShippingDiscountProfiles request to create a new shipping discount profile. This value is used in a SetShippingDiscountProfiles request to delete an existing shipping discount profile. This value is used in a SetShippingDiscountProfiles request to modify an existing shipping discount profile. Reserved for future use. This type is used by the ModifyNameList container in a ReviseFixedPriceItem or RelistFixedPriceItem call to rename one or more Variation Specific names for a multiple-variation listing. A ModifyName container is needed for each Variation Specific name that the seller wishes to change in a multiple-variation listing. You cannot change the name of an Item Specific that is required for the listing category. Use the <a href="https://developer.ebay.com/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory" target="_blank">getItemAspectsForCategory</a> method of the Taxonomy API to determine which Item Specifics names are required for a category. To get a current list of Variation Specifics defined for a multiple-variation listing, the seller can use GetItem, and then view all Variation Specific names in the VariationSpecificsSet container in the response. RelistFixedPriceItem ReviseFixedPriceItem No 5 Type used by the ModifyName container in a ReviseFixedPriceItem or RelistFixedPriceItem call to rename a Variation Specific name for a multiple-variation listing. A ModifyName container is needed for each Variation Specific name that the seller wishes to change the name of in a multiple-variation listing. In this field, the seller identifies the current name (e.g., Material) of a Variation Specific in the active listing that the seller wishes to change. If this field is used, the NewName field must also be specified. 40 ReviseFixedPriceItem RelistFixedPriceItem Conditionally In this field, the seller states the new name of the Variation Specific (e.g., Fabric). In addition to changing a Variation Specific name through the ModifyName container, the seller must also include the new Variation Specific name (and its available values) in the VariationSpecificsSet container, and omit the original name. Note that variations that were sold while they used the old name will also be changed to use the new name in eBay's system. If you are making other changes to a variation (such as adding new values or pictures), use consistent names to avoid unexpected results. For example, specify the same new name to identify the Variation Specific in the Pictures container and in the VariationSpecifics containers for each variation within the listing. 40 RelistFixedPriceItem ReviseFixedPriceItem Conditionally This type is used to provide details on a motor vehicle order using Secure Purchase. The value returned in this field identifies the party that is facilitating the motor vehicle order. Currently, only <code>CARAMEL</code> is supported. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The facilitator's unique reference identifier associated with the motor vehicle order. This ID can be used to retrieve transaction details on the facilitator's website. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This container shows the service cost, if any, owed to the facilitator to complete the motor vehicle order. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This field returns the current status of the buying process for the motor vehicle order. The value returned in this field indicates the current step for the buyer in terms of the order. For more information, see <a href="https://pages.ebay.com/secure-purchase/" target="_blank">Secure Purchase</a>. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This field returns the current status of the selling process for the motor vehicle order. The value returned in this field indicates the current step for the seller in terms of the order. For more information, see <a href="https://pages.ebay.com/secure-purchase/" target="_blank">Secure Purchase</a>. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This field returns the current status of the overall motor vehicle order. The value returned in this field will indicate if the purchase process is active, inactive, or complete. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This type provides information about the shipping service, cost, address, and delivery estimates for the domestic leg of international shipments. This type is only applicable for international shipments using either the Global Shipping Program or eBay International Shipping. Contains information about the shipping service and cost of the domestic leg of a Global Shipping Program shipment. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Contains shipping address information for the domestic leg of a Global Shipping Program shipment or an eBay International Shipping shipment. For a Global Shipping Program shipment, this container includes the ReferenceID field, which can be printed on the package to give the international shipping provider a unique identifier for the order. For an eBay International Shipping shipment, the eBay Virtual Tracking Number is returned in the Street2 field. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The integer value returned here indicates the minimum number of business days that the corresponding shipping service (indicated in ShippingServiceDetails.ShippingService field) will take to be delivered to eBay's domestic shipping partner. This minimum shipping time does not include the seller's handling time, and the clock starts on the shipping time only after the seller has delivered the item to the shipping carrier for shipment to eBay's domestic shipping partner. 'Business days' can vary by shipping carrier and by country, but 'business days' are generally Monday through Friday, excluding holidays. This field is returned if defined for that particular shipping service option. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The integer value returned here indicates the maximum number of business days that the corresponding shipping service (indicated in ShippingServiceDetails.ShippingService field) will take to be delivered to eBay's domestic shipping partner. This maximum shipping time does not include the seller's handling time, and the clock starts on the shipping time only after the seller has delivered the item to the shipping carrier for shipment to eBay's domestic shipping partner. 'Business days' can vary by shipping carrier and by country, but 'business days' are generally Monday through Friday, excluding holidays. This field is returned if defined for that particular shipping service option. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This type provides information about the domestic leg of a Global Shipping Program shipment or an eBay International Shipping shipment. Note: The LogisticsProviderShipmentToBuyer field is reserved for the exclusive use of the international shipping provider. Contains information about the domestic leg of a international order being shipped through the Global Shipping Program or eBay International Shipping, including the selected shipping service, the domestic shipping cost, the domestic address of the international shipping provider, and the estimated shipping time range. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Reserved for use by the international shipping provider. This type specifies the shipping service and cost of the domestic leg of a Global Shipping Program shipment or an eBay International Shipping shipment. The shipping service specified for the domestic leg of a Global Shipping Program shipment or an eBay International Shipping shipment. For the domestic leg, the value of this field can be any available shipping service that ships to the domestic address of the international shipping provider. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The total shipping cost of the domestic leg of a Global Shipping Program shipment or an eBay International Shipping shipment. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Contains a list of up to 10 external message IDs. Currently available on the US site. A message ID that uniquely identifies a message 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 the message ID. A total of 10 message IDs can be specified. GetMyMessages No Type defining the ExternalMessageID field used in GetMyMessages to identify a specific eBay message to retrieve. Up to 10 ExternalMessageID values can be specified in one API call. The ExternalMessageIDs container is only available for use on the eBay US site (SiteID 0). This enumerated type contains the operations that can be used in a ReviseMyMessagesFolders call. This enumeration value is used to create one or more custom folders in My eBay Messages. For a 'Display' operation, the new folder name(s) are specified in one or more FolderName fields. The maximum length of a folder name is 15 characters. Up to 10 new folders can be created with one ReviseMyMessagesFolders call, but this is also limited by how many custom folders exist at the time of the call, as only a maximum of 10 custom folders are supported in My eBay Messages. This enumeration value is used to rename one or more existing folders in My eBay Messages. For a 'Rename' operation, the unique identifier(s) of the message folder(s) to rename are specified in one or more FolderID fields, and the new name for the folder(s) are specified in one or more FolderName fields. The FolderID and FolderName values can be retrieved by calling GetMyMessages with a DetailLevel value set to <code>ReturnSummary</code>, or these folder names and identifiers can be found by navigating to My eBay Messages (Folder ID values are displayed at the end of the browser's URL when that folder is opened). The maximum length of a folder name is 15 characters. The Inbox and Sent folders cannot be renamed. Note: If multiple folders will be renamed with one call, the user must pay close attention to the order of the FolderID and FolderName fields, as eBay will process these requests in order according to the placement of the the FolderID and FolderName fields. So, the existing folder identified by the first FolderID field in the request payload will get renamed to the folder name passed into the first FolderName field in the request payload, and so on. This enumeration value is used to remove one or more custom folders in My eBay Messages. For a 'Remove' operation, the folder(s) to remove are specified in one or more FolderID fields. The FolderID values for a My eBay Messages folders can be retrieved by calling GetMyMessages with a DetailLevel value set to <code>ReturnSummary</code>, or these folder IDs can be found by navigating to a specific folder in My eBay Messages, and the ID value for the opened folder is displayed at the end of the browser's URL. A My eBay Messages folder must be empty before being removed, and an error is returned if a user tries to remove a non-empty folder. The Inbox and Sent folders cannot be removed under any circumstance. Reserved for future or internal use. Summary details for a specified My Messages folder. NewAlertCount, TotalAlertCount An ID that uniquely identifies a My Messages folder. Always returned for detail level ReturnSummary. GetMyMessages

DetailLevel: ReturnSummary

Conditionally The name of a specified My Messages folder. For GetMyMessages, Inbox (FolderID = 0) and Sent (FolderID = 1) are not returned. GetMyMessages

DetailLevel: ReturnSummary

Conditionally The number of new messages in a given folder. Always returned for detail level ReturnSummary. GetMyMessages

DetailLevel: ReturnSummary

Conditionally The total number of messages in a given folder. Always returned for detail level ReturnSummary. GetMyMessages

DetailLevel: ReturnSummary

Conditionally The total number of new high priority messages that a given user has. GetMyMessages

DetailLevel: ReturnSummary

Conditionally The total number of high priority messages that a given user has. GetMyMessages

DetailLevel: ReturnSummary

Conditionally Details relating to a My Messages folder. An ID that uniquely identifies a My Messages folder. GetMyMessages Conditionally Alerts Messages

DetailLevel: ReturnHeaders, ReturnMessages

The name of a specified My Messages folder. Type used by the Messages container that is returned in GetMyMessages. The Messages container consists of an array of one or more messages. A Message container is returned for each message that matches the input criteria in the call request. Each Message container consists of detailed information on a message. The amount of information that is returned in each Message container is partially dependent on the value that is set in the required DetailLevel field. GetMyMessages

DetailLevel: ReturnHeaders, ReturnMessages

Conditionally Contains a list of up to 10 MessageID values. An ID that uniquely identifies a message for a given user. DeleteMyMessages Conditionally GetMyMessages Conditionally ReviseMyMessages Conditionally Type defining the MessageID field used in GetMyMessages, ReviseMyMessages, and DeleteMyMessages to identify a specific eBay message to retrieve, revise, or delete, respectively. Up to 10 MessageID values can be specified in one API call. Container for the message information for each message specified in MessageIDs. The amount and type of information returned varies based on the requested detail level. Display name of the eBay user that sent the message. Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetMyMessages

DetailLevel: ReturnHeaders, ReturnMessages

Conditionally Displayable user ID of the recipient. Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetMyMessages

DetailLevel: ReturnHeaders, ReturnMessages

Conditionally Displayable name of the user or eBay application to which the message is sent. Only returned for M2M, and if a value exists. Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetMyMessages

DetailLevel: ReturnHeaders, ReturnMessages

Conditionally Subject of the message. GetMyMessages

DetailLevel: ReturnHeaders, ReturnMessages

Conditionally ID that uniquely identifies a message for a given user. This value is not the same as the value used for the GetMemberMessages MessageID. Use the GetMemberMessages value (used as the GetMyMessages ExternalID) instead. GetMyMessages

DetailLevel: ReturnHeaders, ReturnMessages

Conditionally ID used by an external application to uniquely identify a message. Returned only when specified by the external application on message creation. This value is equivalent to the value used for MessageID in GetMemberMessages. GetMyMessages

DetailLevel: ReturnHeaders, ReturnMessages

Conditionally Contains the message content, and can contain a threaded message. This field can contain plain text or HTML, depending on the format of the original message. The API does not check the email-format preferences in My Messages on the eBay Web site. 2 megabytes in size GetMyMessages

DetailLevel: ReturnMessages

Conditionally Indicates if the message is displayed with a flag in the seller's My Messages mailbox on eBay. It is strongly recommended that the seller act on the message by the specified date (or within 60 days, if not specified). GetMyMessages

DetailLevel: ReturnHeaders, ReturnMessages

Conditionally Indicates if a message has been viewed by a given user. Note that retrieving a message with the API does not mark it as read. GetMyMessages

DetailLevel: ReturnHeaders, ReturnMessages

Conditionally Date and time that a message was received by My Messages and stored in a database for the recipient. GetMyMessages

DetailLevel: ReturnHeaders, ReturnMessages

Conditionally Date and time at which a message expires. GetMyMessages

DetailLevel: ReturnHeaders, ReturnMessages

Conditionally Unique identifier of an eBay listing. This field is returned if the corresponding message is associated with a specific listing. GetMyMessages

DetailLevel: ReturnHeaders

Conditionally Details relating to the response to a message. GetMyMessages

DetailLevel: ReturnHeaders, ReturnMessages

Conditionally Details relating to a My Messages folder. GetMyMessages

DetailLevel: ReturnHeaders, ReturnMessages

Conditionally Message body in plain text format. The message body is displayed in plain text even if the eBay user's Preferred Email Format preference on My eBay is set to HTML. Graphics and text formatting are dropped if the eBay user's preference is set to HTML. GetMyMessages

DetailLevel: ReturnMessages

Conditionally Type of message being retrieved through GetMyMessages. This is available only on the US site. GetMyMessages Conditionally 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., total price and buyer/high bidder) and the transaction fees. This processing can take several minutes. If you retrieve a sold item and no details about the buyer/high bidder are returned or no transaction fees are available, use this listing status information to determine whether eBay has finished processing the listing. Note: For GetMyMessages, the listing status reflects the status of the listing at the time the question was created. The listing status for this call must not match the listing status returned by other calls (such as GetItemTransactions). This is returned only if Messages.Message.MessageType is AskSellerQuestion. This tag is no longer returned in the Sandbox environment. GetMyMessages Conditionally ComingSoon Currently available only on the US site. Context of the question (e.g. Shipping, General). Corresponds to the message subject. Applies if Messages.Message.MessageType is AskSellerQuestion. GetMyMessages Conditionally ComingSoon Indicates if there has been a reply to the message. GetMyMessages

DetailLevel: ReturnHeaders, ReturnMessages

Conditionally Indicates if this message is marked as a high-priority message. GetMyMessages Conditionally Date and time for the ended item. GetMyMessages Conditionally Title of the item listing. 55 GetMyMessages Conditionally Media details stored as part of the message. GetMyMessages

DetailLevel: ReturnHeaders, ReturnMessages

Conditionally Details relating to the response to a message. Whether a message can be responded to. To respond to a message, use the URL in ResponseURL. You may need to log into the eBay Web site to complete the response. GetMyMessages Conditionally Alerts Messages

DetailLevel: ReturnHeaders, ReturnMessages

A URL that the recipient must visit to respond to a message. Responding may require logging into the eBay Web site. GetMyMessages Conditionally Alerts

DetailLevel: ReturnMessages

GetMyMessages Conditionally Messages

DetailLevel: ReturnHeaders, ReturnMessages

Summary data for a given user's alerts and messages. This includes the numbers of new alerts and messages, unresolved alerts, flagged messages, and total alerts and messages. Folder summary for each folder. Always returned for detail level ReturnSummary. GetMyMessages

DetailLevel: ReturnSummary

Conditionally The number of new messages that a given user has. Always returned for detail level ReturnSummary. GetMyMessages

DetailLevel: ReturnSummary

Conditionally The number of messages that have been flagged. Always returned for detail level ReturnSummary. GetMyMessages

DetailLevel: ReturnSummary

Conditionally The total number of messages for a given user. Always returned for detail level ReturnSummary. GetMyMessages

DetailLevel: ReturnSummary

Conditionally The total number of new high priority messages that a given user has. GetMyMessages

DetailLevel: ReturnSummary

Conditionally The total number of high priority messages that a given user has. GetMyMessages

DetailLevel: ReturnSummary

Conditionally A list of favorite searches a user has saved on the My eBay page. The total number of favorite searches saved. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally A favorite search the user has saved, with a name and a search query. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally Type defining the FavoriteSearch container returned in GetMyeBayBuying. The FavoriteSearch container consists of options and filtering used in a buyer's Saved Search on My eBay, and is only returned in GetMyeBayBuying if the FavoriteSearches container is included the request, and if there is at least one Saved Search for the buyer. The name of the buyer's Saved Search on My eBay. The name defaults to the user's original search string, or the user has the option of modifying the name of the Saved Search. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally This is the URL of the buyer's Saved Search on My eBay. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally This string is the original search string of the buyer's Saved Search on My eBay. This is the string that the user input into the search field. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally This is the unique identifier (Category ID) of the category in which the user was searching for the item for the Saved Search. Specifying a category in a query restricts the search to a specific category. If the Saved Search is not restricted to a specific category, the CategoryID field will not appear in the request. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally This enumeration value indicates the "Sort by" value that the user specified in the Saved Search. Some of the ways buyers can sort items include by Best Match (generally, the default), item price, item price + shipping, listing end time, and item distance (relative to the buyer's shipping address). Available sort values may vary for each search, but below is the complete set of values that may be returned in this field. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The SortOrder value works in conjunction with the ItemSort value, and indicates whether Saved Search results are returned in ascending (low to high values) or descending (high to low values) order. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The EndTimeFrom and EndTimeFrom values indicates that a date range has been specified in the Saved Search. Only listings ending during the date range defined with the EndTimeFrom and EndTimeFrom values are retrieved in the search results. The EndTimeFrom value indicates the beginning of the date range. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The appearance of EndTimeFrom and EndTimeFrom values in the response indicates that a date range has been specified in the Saved Search. Only listings ending during the date range defined with the EndTimeFrom and EndTimeFrom values are retrieved in the search results. The EndTimeTo value indicates the ending of the date range. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The appearance of a MaxDistance value in the response indicates that a proximity (Items near me) filter has been specified in the Saved Search. The MaxDistance value is the maximum distance (in miles) away from the buyer's postal code (specified or default) that an item may be located (based on the PostalCode value returned in the FavoriteSearch container). In a Saved Search, a buyer can supply a postal code or can base that postal code on a major city. If neither one of these methods for selecting a postal code is used, the postal code defaults to the buyer's primary shipping address. Only items located within the MaxDistance value are returned in the search results. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The PostalCode value is either the postal code for the buyer's primary shipping address, or it is the postal code specified through the proximity (Items near me) filter of a Saved Search. In a Saved Search, a buyer can supply a postal code or can base that postal code on a major city. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally Enumerated value that provides more information on the type of listing type filtering the buyer used when setting up a Saved Search in My eBay. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The appearance of a PriceMax value indicates that a maximum price filter has been specified in the Saved Search. Only listings with an item price at or below the PriceMax value are retrieved in the search results. PriceMax can be used in conjunction with PriceMin in a Saved Search to specify a price range. Only listings with item prices within this price range are retrieved in the search results. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The appearance of a PriceMin value indicates that a minimum price filter has been specified in the Saved Search. Only listings with an item price at or above the PriceMin value are retrieved in the search results. PriceMin can be used in conjunction with PriceMax in a Saved Search to specify a price range. Only listings with item prices within this price range are retrieved in the search results. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The appearance of a Currency value indicates that a currency filter has been specified in the Saved Search. Only listings with the specified Currency value are retrieved in the search results. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The BidCountMax value in a My eBay Favorite Search. The BidCountMax limits the search results to items with a maximum number of bids. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The BidCountMin value in a My eBay Favorite Search. The BidCountMin limits the results of a search to items with a maximum number of bids. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The SearchFlag value in a My eBay Favorite Search. The SearchFlag allows you to specify whether you want to include charity listings, free-shipping listings, and listings with other features in your search. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The PreferredLocation value of a My eBay Favorite Search. The PreferredLocation specifies the criteria for filtering search results by site, where site is determined by the site ID in the request. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The SellerID value in a My eBay Favorite Search. The SellerID is the eBay ID of a specific seller. Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The SellerIDExclude value in a My eBay Favorite Search. The SellerIDExclude limits the search results to exclude items sold by a specific seller or by specific sellers. Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The ItemsAvailableTo value in a My eBay Favorite Search. ItemsAvailableTo limits the result set to just those items available to the specified country. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The ItemsLocatedIn value in a My eBay Favorite Search. ItemsLocatedIn limits the result set to just those items located in the specified country. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The SellerBusinessType value in a My eBay Favorite Search. The SellerBusinessType limits the search results to those of a particular seller business type such as commercial or private. SellerBusinessType is only available for sites that have business seller features enabled. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The Condition value in a My eBay Favorite Search. Condition limits the results to new or used items, plus items that have no condition specified. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The Quantity value in a My eBay Favorite Search. The Quantity limits the search results to listings that offer a certain number of items matching the query. The Quantity field is used with QuantityOperator to specify that you are seeking listings with quantities greater than, equal to, or less than the value you specify in Quantity. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The Quantity Operator value in a My eBay Favorite Search. The Quantity Operator limits the results to listings with quantities greater than, equal to, or less than the value you specify in Quantity. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally A list of favorite sellers the user has saved on the My eBay page. The total number of favorite sellers saved. 100 GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally A favorite seller the user has saved, with a user ID and store name. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally Characteristics of the My eBay Favorite Seller. The favorite seller's eBay user ID. Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally The name of the store owned by the favorite seller, if applicable. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally Specifies how to return the result list for My eBay features such as saved searches, favorite sellers, and second chance offers. Specifies whether or not to include the container in the response. Set the value to true to return the default set of fields for the container. Not needed if you set a value for at least one other field in the container. If you set DetailLevel to ReturnAll, set Include to false to exclude the container from the response. GetMyeBayBuying No Specifies whether or not to include the item count in the response. Set the value to true to return the default set of fields for the container. Not needed if you set a value for at least one other field in the container. If you set DetailLevel to ReturnAll, set Include to false to exclude the container from the response. GetMyeBayBuying No This field is not supported. Specifies whether or not to include FavoriteSellerCount in the response. Set the value to true to return the default set of fields for the container. Not needed if you set a value for at least one other field in the container. If you set DetailLevel to ReturnAll, set Include to false to exclude the container from the response. GetMyeBayBuying No Specifies the sort order of the result. Default is Ascending. GetMyeBayBuying No Specifies the maximum number of items in the returned list. If not specified, returns all items in the list. GetMyeBayBuying No Specifies that only the user defined list whose name matches the given name should be in the returned list. If the user does not have a matching record, no data is returned. If this element is omitted, the information for all records is returned. For use only within the UserDefinedLists element. GetMyeBayBuying FavoriteSearches FavoriteSellers SecondChanceOffer No Specify true to return the full user defined list contents in the response's UserDefinedList containers. A value of false means only a summary of the user defined list will be returned. The default value is false. GetMyeBayBuying FavoriteSearches FavoriteSellers SecondChanceOffer No Contains summary information about the items the seller is selling. The number of currently active auctions that will sell. That is, there is at least one bidder, and any reserve price has been met. Equivalent to the "Will Sell" value in My eBay. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally The total number of currently active auctions for a given seller. Note that this does not include listings that are FixedPriceItem or StoresFixedPrice. Equivalent to the "Auction Quantity" value in My eBay. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally For all items that the seller has for sale, the total selling values of those items having bids and where the Reserve price is met (if a Reserve price is specified). GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally The total number of items that the seller has sold in the past 31 days. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally The total monetary value of the items the seller has sold. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally The average duration, in days, of all items sold. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally The total number of Classified Ad listings listed by the seller. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally The total number of Classified Ad listings that have an associated lead. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally The quantity of items that this seller can list. This number refers to the total quantity of items in all listings. For example, if the seller's limit was a quantity of 100, this could be 100 listings of one item each, or one listing with a quantity of 100 items. The seller will be unable to list additional items or quantities of items for sale in excess of this number for the current month unless the seller requests an increase from eBay using the "Request higher selling limits" link in the All Selling section of My eBay. (Under "Selling Limits".) Notice that the amount limit (see AmountLimitRemaining) may be reached before the quantity limit is reached. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally Seller Limits https://developer.ebay.com/api-docs/user-guides/static/make-a-call/fg-replaced.html The total value of the items listed price that this seller can list. This amount is the total of the prices specified upon listing. For example, for fixed price listings, this is the total of the fixed price amounts. For auction listings, this is the total of the starting prices. The seller will be unable to list an item if the amount of the item's fixed price or starting price (for auctions) exceeds the amount limit. This is part of the seller limit, which can be increased by requesting an increase from eBay using the "Request higher selling limits" link in the All Selling section of My eBay. (Under "Selling Limits".) Notice that the quantity limit (see QuantityLimitRemaining) may be reached before the amount limit is reached. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally Seller Limits https://developer.ebay.com/api-docs/user-guides/static/make-a-call/fg-replaced.html A list of one or more valid names and corresponding values. Currently used to identify Item Specifics and individual variations within a multiple-variation listing. For the AddItem family of calls: Contains the name and value(s) for an Item Specific. Only required when the ItemSpecifics container is specified. For the AddFixedPriceItem family of calls: The same NameValueList schema is used for the ItemSpecifics node, the VariationSpecifics node, and the VariationSpecifcsSet node. If the listing has variations, any name that you use in the VariationSpecifics and VariationSpecificsSet nodes can't be used in the ItemSpecifics node. When you list with Item Variations: <ul> <li>Specify shared Item Specifics (e.g., Brand) in the ItemSpecifics node. </li> <li>Specify up to five VariationSpecifics in each Variation node. </li> <li>Specify all applicable names with all their supported values in the VariationSpecificSet node. </li> </ul> See the Variation sample in the AddFixedPriceItem call reference for examples. For PlaceOffer: Required if the item being purchased includes Item Variations. For AddToWatchList and RemoveFromWatchList: The ItemID value of the multiple-variation listing and the name-value pair to identify each variation in the listing are required. Note: As of August 30, 2018, California will require sellers to display a Proposition 65 warning on online retail sites if products contain chemicals and/or substances that may impact the health of California buyers. This requirement is applicable to most eBay US categories, including eBay Motors, Motors Parts & Accessories, and catalog-enabled categories. The warning message can be customized by the seller, but should contain the following basic information: <ul> <li>The name of at least one listed chemical that prompted the warning</li> <li>Text stating that the product 'can expose you to' the chemical(s) in the product </li> <li>The URL for OEHHA's new Proposition 65 warnings website, which is <a href="www.P65Warnings.ca.gov" target="_blank">www.P65Warnings.ca.gov</a></li> </ul> Unlike standard item specifics that allow a maximum of 65 characters in the Value field, the matching value for the 'California Prop 65 Warning' item specific allows up to 800 characters of text. When a seller passes in this item specific, eBay will automatically insert a warning symbol icon for the listing. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem ItemSpecifics 45 Conditionally AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Variations Conditionally 2 5 AddToWatchList RemoveFromWatchList Conditionally GetItem No GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Variation Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetOrders

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally OrderReport Conditionally PlaceOffer Conditionally SetUserNotes No GetItemTransactions Conditionally ActiveInventoryReport Conditionally This type is used to set or identify either an Item Specific name/value pair for a category/item/variation, or to identify a Parts Compatibility name/value pair. Depending on the call and context, this value is either a name of an Item/Variation Specific, or a Parts Compatibility name. For the AddItem and AddFixedPriceItem families of calls: In the Item.ItemSpecifics context, the value in this field will either be the name of a required/recommended/optional item specific name for the category, or it may be a seller's customized item specific name. For the AddFixedPriceItem family of calls: In the Compatibility.NameValueList context, this value is a motor vehicle aspect such as Year, Make, and Model. A Compatibility.NameValueList container is applicable for motor vehicle parts and accessories listings. For PlaceOffer: Required if the line item being purchased is an item variation within a multiple-variation listing. Note: For required and recommended item specifics that are returned in the <a href="https://developer.ebay.com/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory" target="_blank">getItemAspectsForCategory</a> method of the Taxonomy API, the seller should pass in the name of these item specifics just as they are shown in the getItemAspectsForCategory response. Similarly, for catalog-enabled categories, the seller should pass in the name of instance aspects just as they are shown in the getItemAspectsForCategory response. Instance aspects are additional details unique to a specific item or listing that a seller can include along with the product aspects that are already defined in the eBay catalog product associated with the listing. Instance aspects common to many catalog-enabled categories include 'Bundle Description' and 'Modification Description'. eBay US sellers who ship to California are required to pass in a 'California Prop 65 Warning' item specific if the item in the listing contains one or more chemicals known to be harmful to human health. This item specific is passed at the listing level for both single-variation and multiple-variation listings. The 'California Prop 65 Warning' is considered an instance specific because it will be retained on the listing even when the seller lists using an eBay catalog product. The 'California Prop 65 Warning' may be applicable in most eBay US categories, including eBay Motors, Motors Parts & Accessories, and catalog-enabled categories. Note: If Brand and MPN (Manufacturer Part Number) are being used to identify product variations in a multiple-variation listing, the Brand must be specified at the item level (ItemSpecifics container) and the MPN for each product variation must be specified at the variation level (VariationSpecifics container). The Brand name must be the same for all variations within a single listing. 65 AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddToWatchList RemoveFromWatchList Conditionally GetItem No GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetOrders

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally OrderReport Conditionally PlaceOffer Conditionally SetUserNotes No ActiveInventoryReport Conditionally Depending on the call and context, this value is either the value of an Item/Variation Specific, a Parts Compatibility value, or a product identifier. For the AddItem family of calls: Multiple values can only be specified for an Item Specific if the <a href="https://developer.ebay.com/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory#response.aspects.aspectConstraint.itemToAspectCardinality" target="_blank">itemToAspectCardinality</a> field of the getItemAspectsForCategory method shows a value of <code>MULTI</code>. If an item specific only supports a single value, only the first item specific value specified in the request will be used. For the Compatibility.NameValueList context, this is the corresponding value of a motor vehicle aspect such as Year, Make, and Model. A Compatibility.NameValueList container is applicable for motor vehicle parts and accessories listings. For PlaceOffer: Required if the line item being purchased is an item variation within a multiple-variation listing. Note: The standard maximum length for the value of an item specific is 65, but the maximum allowed length increases for instance aspects such as 'Bundle Description' and 'Modification Description'. For item specifics with max lengths greater than 65, the actual max length will be returned in a corresponding <a href="https://developer.ebay.com/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory#response.aspects.aspectConstraint.aspectMaxLength" target="_blank">aspectMaxLength</a> field. The maximum allowed length for the new 'California Prop 65 Warning' item specific is 800 characters. For more information about the 'California Prop 65 Warning' item specific, see the ItemSpecifics.NameValueList field description. 65 (but longer for some instance aspects, including 800 for 'California Prop 65 Warning') AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddToWatchList RemoveFromWatchList Conditionally 50 GetItem No GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetOrders

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally OrderReport Conditionally PlaceOffer Conditionally SetUserNotes No ActiveInventoryReport Conditionally This enumerated value indicates whether the Item Specific was manually input or selected during listing/revision/re-listing time, or if the Item Specific name-value pair came from an eBay catalog product that the listing is associated with. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Conditionally This type is used by the NettedTransactionSummary container, which shows the total amount of fees (and credits if applicable) that have already been paid through seller payout deductions. The amount in this field is the total amount of all charges/fees that have been deducted from seller payouts, and not invoiced to the seller. This value should equal the total sum of all the 'netted' fees in the AccountEntries array. The corresponding Netted boolean field for each fee in AccountEntries array will show as <code>true</code> if the fee has already been deducted from a seller payout. This field is returned even if <code>0.0</code>. GetAccount Conditionally The amount in this field is the total amount of all credits for fees that have been deducted from seller payouts, and not invoiced to the seller. This value should equal the total sum of all the 'netted' credit in the AccountEntries array. The corresponding Netted boolean field for each credit in AccountEntries array will show as <code>true</code> if the credit is for a fee that has already been deducted from a seller payout. This field is returned even if <code>0.0</code>. GetAccount Conditionally This is for FSBO. Each of the subscriptions will have following options, which will define "National" vs "Local" ad format listing. "LocalOptional" : This will allow national and local listing. "LocalOnly" : Seller can have Local listings only. "NationalOnly" : Seller can not opt into local only exposure. It has to be national listing. Type used by the NotificationDetailsArray container that is returned by the GetNotificationsUsage call. The NotificationDetailsArray container consists of one or more notifications that match the input criteria in the call request. This container is only returned if there were notifications related to this listing during the specified time range. Each NotificationDetails container consists of detailed information about one notification. NotificationDetails container(s) are only returned if there were one or more notifications related to this listing during the specified time range. GetNotificationsUsage Conditionally Information about a single notification. Notification information includes the reference ID, notification type, current status, time delivered, error code, and error message for the notification. If notification details are included in the response, all of the detail fields are returned. Returns the destination address for the notification. This is the value set using SetNotificationPreferences. GetNotificationsUsage Conditionally Reference identifier for the notification. Date and time when this notification will be removed from the eBay system. GetNotificationsUsage Conditionally The returned enumeration value indicates the type of platform notification, GetNotificationsUsage Conditionally Returns the total number of retries for the given notification. GetNotificationsUsage Conditionally Returns the notification status. Possible values include Delivered, Failed, Rejected, and MarkedDown. GetNotificationsUsage Conditionally Returns the time when the notification is scheduled for retry. This won't be included if the DeliveryStatus is Delivered. GetNotificationsUsage Conditionally Returns the time when the notification was delivered. GetNotificationsUsage Conditionally Returns the error message. GetNotificationsUsage Conditionally Returns the delivery URL name for the notification. This is the value set using SetNotificationPreferences. GetNotificationsUsage Conditionally This type is used by the UserDeliveryPreferenceArray container of the SetNotificationPreferences and GetNotificationPreferences calls. The UserDeliveryPreferenceArray container consists of one or more notifications and whether or not each notification is enabled or disabled. In a SetNotificationPreferences call, one NotificationEnable container is used for each notification that the user either wants to subsribe to or disable. If a UserDeliveryPreferenceArray container is used, at least one NotificationEnable container must be specified. In a GetNotificationPreferences call, one NotificationEnable container is returned for each notification that the user has set a preference on - enabled or disabled. SetNotificationPreferences Conditionally GetNotificationPreferences Conditionally Specifies a notification event and whether the notification is enabled or disabled. The name of the notification event. GetNotificationPreferences FeedbackForSeller Conditionally SetNotificationPreferences None, FeedbackForSeller No Whether the event is enabled or disabled. GetNotificationPreferences Conditionally SetNotificationPreferences No Defines all property names that can be used. Property name for WatchedItemEndingSoon events, enabling a user to specify a time in minutes before the end of the listing. Acceptable values: 5, 10, 15, 30, 60, 75, and 180. For example, to receive a WatchedItemEndingSoon notification 30 minutes before the item listing ends, specify 30. Reserved for future use. Defines properties associated with a particular event. The name of the notification event. GetNotificationPreferences ItemsCanceled Conditionally SetNotificationPreferences ItemsCanceled No Specify property name associated with an particular event. GetNotificationPreferences Conditionally SetNotificationPreferences No Specifies the value for the property. GetNotificationPreferences Conditionally SetNotificationPreferences No Valid notification status codes MarkedDown, MarkedDownPending Status indicating the notification is newly created Status indicating the notification was failed This enumeration value is deprecated and should no longer be used. Status indicating the end user application is marked down. Status indicating the notification is pending Status indicating the notification is failed pending This enumeration value is deprecated and should no longer be used. Status indicating the notification is marked down pending Status indicating the notification was successfully delivered Status indicating the notification was unable to deliver Status indicating the notification was rejected Status indicating the notification was cancelled. This can be caused by multiple reasons, such as the destination being marked down or an unknown system error. Reserved for future internal or external use Enumerated type that contains the complete list of platform notifications that can be sent out to subscribed users, servers, or applications. Some notifications are only sent to buyers or sellers, and some are sent to both buyers and sellers. FeedbackForSeller, MyMessagesAlertHeader, MyMessagesAlert, Checkout, ThirdPartyCartCheckout, ItemAddedToBidGroup, ItemRemovedFromBidGroup, AddToWatchList, PlaceOffer, RemoveFromWatchList, AddToBidGroup, RemoveFromBidGroup, ItemsCanceled, ReadyToShip, ReadyForPayout, UnmatchedPaymentReceived, RefundSuccess, RefundFailure, OrderInquiryClosed, OrderInquiryOpened, INRBuyerOpenedDispute, OrderInquiryProvideShipmentInformation, OrderInquiryEscalatedToCase, INRBuyerClosedDispute, INRSellerRespondedToDispute, UserIDChanged, BulkDataExchangeJobCompleted This buyer-facing notification is sent when another buyer has outbid (placed a higher bid) the subscribed buyer on an auction listing, and the subscribed buyer is no longer the current high bidder. This notification is only applicable for auction listings. This notification will appear in the GetItem call response. See <a href="https://developer.ebay.com/api-docs/static/pn_outbid.html" target="_blank">OutBid</a> for additional information about this notification. This notification is applicable to both buyers and sellers and is sent as soon as an auction listing ends with or without a winning bidder. This notification will also be sent if the auction ends as a result of a buyer using the auction listing's Buy It Now feature. This notification is only applicable for auction listings. This notification will appear in the GetItemTransactions call response. See <a href="https://developer.ebay.com/api-docs/static/pn_end-of-auction.html" target="_blank">EndOfAuction</a> for additional information about this notification. This seller-facing notification is sent when the winning bidder or buyer has paid for the auction or fixed-price item and completed the checkout process. For multiple line item orders, an AuctionCheckoutComplete notification is only generated for one of the line items in the order. This notification will appear in the GetItemTransactions call response. See <a href="https://developer.ebay.com/api-docs/static/pn_auction-checkout-complete.html" target="_blank">AuctionCheckoutComplete</a> for additional information about this notification. This seller-facing notification is sent when a buyer/winning bidder is requesting a total price before paying for the item. This notification is applicable for auction listings and for fixed-price listings that do not require immediate payment. This notification will appear in the GetItemTransactions call response. See <a href="https://developer.ebay.com/api-docs/static/pn_buyer-requests-total.html" target="_blank">CheckoutBuyerRequestsTotal</a> for additional information about this notification. This notification is applicable to both buyers and sellers and is sent when that buyer or seller has left Feedback for the other party in the order, or has received Feedback from the other party in the order. Feedback is given at the order line item level. This notification will appear in the GetFeedback call response. See <a href="https://developer.ebay.com/api-docs/static/pn_feedback.html" target="_blank">Feedback</a> for additional information about this notification. This notification is deprecated. Use the Feedback notification instead. 415 Avoid Feedback This seller-facing notification is sent each time a buyer purchases an item in a single or multiple-quantity, fixed-price listing. This notification is only applicable for fixed-price listings. This notification will appear in the GetFeedback call response. See <a href="https://developer.ebay.com/api-docs/static/pn_fixed-price-transaction.html" target="_blank">GetItemTransactions</a> for additional information about this notification. This buyer-facing notification is sent when the buyer is offered a Second Chance Offer from the seller, after that buyer failed to win the original auction of the item. This notification will appear in the GetItem call response. See <a href="https://developer.ebay.com/api-docs/static/pn_second-chance.html" target="_blank">SecondChanceOffer</a> for additional information about this notification. This is a seller-facing notification that is sent when an eBay user has used the Ask a Question feature on the seller's active listing. An eBay user does not have to be an active bidder on an auction listing to ask a seller a question. This notification will appear in the GetMemberMessages call response. See <a href="https://developer.ebay.com/api-docs/static/pn_ask-seller-question.html" target="_blank">AskSellerQuestion</a> for additional information about this notification. This seller-facing notification is sent each time one of the subscribed seller's items is listed or relisted. This notification is also triggered when the Unpaid Item preferences relists an item for the seller. This notification will appear in the GetItem call response. See <a href="https://developer.ebay.com/api-docs/static/pn_item-listed.html" target="_blank">ItemListed</a> for additional information about this notification. This seller-facing notification is sent when one of the subscribed seller's items is revised. This notification will appear in the GetItem call response. See <a href="https://developer.ebay.com/api-docs/static/pn_item-revised.html" target="_blank">ItemRevised</a> for additional information about this notification. This seller-facing notification is sent if a potential buyer has made a Best Offer on a Best Offer-enabled listing. This notification will appear in the GetBestOffers call response. See <a href="https://developer.ebay.com/api-docs/static/pn_best-offer.html" target="_blank">BestOffer</a> for additional information about this notification. This notification is deprecated and can no longer be used. This notification is deprecated. Use MyMessagesHighPriorityMessage instead. This notification is sent to a subscribed buyer or seller when eBay sends a message to that user's InBox. If subscribed to by a buyer or seller, and when applicable, this notification will appear in the GetMyMessages call response. For this notification to be returned in GetMyMessages, the DetailLevel value in the GetMyMessages request must be set to <code>ReturnHeaders</code>. MyMessageseBayMessageHeader and MyMessageseBayMessage cannot be subscribed to at the same time or specified in the same call. This notification is sent to a subscribed buyer or seller when eBay sends a message to that user's InBox. If subscribed to by a buyer or seller, and when applicable, this notification will appear in the GetMyMessages call response. For this notification to be returned in GetMyMessages, the DetailLevel value in the GetMyMessages request must be set to <code>ReturnMessages</code>. MyMessageseBayMessageHeader and MyMessageseBayMessage cannot be subscribed to at the same time or specified in the same call. This notification is sent to a subscribed buyer or seller when another eBay user sends a message to that user's InBox. If subscribed to by a buyer or seller, and when applicable, this notification will appear in the GetMyMessages call response. For this notification to be returned in GetMyMessages, the DetailLevel value in the GetMyMessages request must be set to <code>ReturnHeaders</code>. MyMessagesM2MMessageHeader and MyMessagesM2MMessage cannot be subscribed to at the same time or specified in the same call. This notification is sent to a subscribed buyer or seller when another eBay user sends a message to that user's InBox. If subscribed to by a buyer or seller, and when applicable, this notification will appear in the GetMyMessages call response. For this notification to be returned in GetMyMessages, the DetailLevel value in the GetMyMessages request must be set to <code>ReturnMessages</code>. MyMessagesM2MMessageHeader and MyMessagesM2MMessage cannot be subscribed to at the same time or specified in the same call. This event type has been deprecated along with legacy user disputes. As an alternative, subscribe to EBPMyResponseDue event type. This notification is sent to a subscribed seller when a buyer responds to an Item Not Received case opened by that buyer. This event type has been deprecated along with legacy user disputes. As an alternative, subscribe to EBPClosedCase event type. This event type has been deprecated along with legacy user disputes. This notification is deprecated. Use AuctionCheckoutComplete instead. This buyer-facing notification is sent when a listing that the buyer is watching is ending soon. This event has a TimeLeft property that defines the 'ending soon' threshold value. This notification will appear in the GetItem call response. See <a href="https://developer.ebay.com/api-docs/static/pn_watched-item-ending-soon.html" target="_blank">WatchedItemEndingSoon</a> for additional information about this notification. This notification is applicable to both buyers and sellers and is sent when a listing ends. This notification can be triggered by an ItemWon, an ItemSold, or an ItemUnsold event. This notification will appear in the GetItem call response. See <a href="https://developer.ebay.com/api-docs/static/pn_item-closed.html" target="_blank">ItemClosed</a> for additional information about this notification. This notification is sent to a subscribed buyer or seller when a listing is administratively taken down by eBay. This seller-facing notification is sent when an eBay listing ends in a sale. This notification will appear in the GetItem call response. See <a href="https://developer.ebay.com/api-docs/static/pn_item-sold.html" target="_blank">ItemSold</a> for additional information about this notification. This notification is sent to a subscribed seller when the duration of an eBay listing has been extended. This notification is no longer applicable. This notification is deprecated. 621 707 NoOp This notification is sent to a subscribed seller when the seller has revised a listing and added a nonprofit organization to receive a percentage (10 percent up to 100 percent) of the proceeds. This buyer-facing notification is sent when that buyer adds an item to the Watch List. This notification will appear in the GetItem call response. See <a href="https://developer.ebay.com/api-docs/static/pn_item-added-to-watch-list.html" target="_blank">ItemAddedToWatchList</a> for additional information about this notification. This buyer-facing notification is sent when that buyer removes an item from the Watch List. This notification will appear in the GetItem call response. See <a href="https://developer.ebay.com/api-docs/static/pn_item-removed-from-watch-list.html" target="_blank">ItemRemovedFromWatchList</a> for additional information about this notification. This notification is deprecated. This notification is deprecated. This notification is applicable to both buyers and sellers and is sent when that user leaves feedback for an order partner. This notification will appear in the GetFeedback call response. See <a href="https://developer.ebay.com/api-docs/static/pn_feedback-left.html" target="_blank">FeedbackLeft</a> for additional information about this notification. This notification is applicable to both buyers and sellers and is sent when that user receives feedback from an order partner. This notification will appear in the GetFeedback call response. See <a href="https://developer.ebay.com/api-docs/static/pn_feedback-received.html" target="_blank">FeedbackReceived</a> for additional information about this notification. This notification is applicable to both buyers and sellers and is sent when that user's Feedback star has changed. Sent to a subscribing third party when a user's Feedback star level changes. This notification will appear in the GetUser call response. See <a href="https://developer.ebay.com/api-docs/static/pn_feedback-star-changed.html" target="_blank">FeedbackStarChanged</a> for additional information about this notification. This buyer-facing notification is sent when the buyer places a bid for an auction item. This notification will appear in the GetItem call response. See <a href="https://developer.ebay.com/api-docs/static/pn_bid-placed.html" target="_blank">BidPlaced</a> for additional information about this notification. This seller-facing notification is sent each time a prospective buyer places a bid for the seller's auction item. This notification will appear in the GetItem call response. See <a href="https://developer.ebay.com/api-docs/static/pn_bid-received.html" target="_blank">BidReceived</a> for additional information about this notification. This buyer-facing notification is sent if the buyer is the winner of an auction item. This notification will appear in the GetItem call response. See <a href="https://developer.ebay.com/api-docs/static/pn_item-won.html" target="_blank">ItemWon</a> for additional information about this notification. This buyer-facing notification is sent if that buyer did not end up as the highest bidder for an auction item. This notification will appear in the GetItem call response. See <a href="https://developer.ebay.com/api-docs/static/pn_item-lost.html" target="_blank">ItemLost</a> for additional information about this notification. This seller-facing notification is sent when an auction listing ends with no winning bidder or when a fixed-price listing ends with no sale(s). This notification will appear in the GetItem call response. See <a href="https://developer.ebay.com/api-docs/static/pn_item-unsold.html" target="_blank">ItemUnsold</a> for additional information about this notification. This buyer-facing notification is sent when a seller makes a counter offer to the buyer's Best Offer on an item. This notification will appear in the GetBestOffers call response. See <a href="https://developer.ebay.com/api-docs/static/pn_counter-offer-recd.html" target="_blank">CounterOfferReceived</a> for additional information about this notification. This buyer-facing notification is sent when a seller declines the buyer's Best Offer on an item. This notification will appear in the GetBestOffers call response. See <a href="https://developer.ebay.com/api-docs/static/pn_best-offer-declined.html" target="_blank">BestOfferDeclined</a> for additional information about this notification. This buyer-facing notification is sent each time a prospective buyer places a Best Offer on an item. This notification will appear in the GetBestOffer call response. See <a href="https://developer.ebay.com/api-docs/static/pn_best-offer-placed.html" target="_blank">BestOfferPlaced</a> for additional information. This notification is deprecated. Use ItemAddedToWatchList notification instead. This notification is deprecated. Use BidPlaced notification instead. This notification is deprecated. Use ItemRemovedFromWatchList notification instead. ItemRemovedFromWatchList This notification is deprecated. This notification is deprecated. This notification is deprecated. This notification is applicable to both buyers and sellers and is sent if that user's authentication token is revoked. This notification will appear in the GetTokenStatus call response. See <a href="https://developer.ebay.com/api-docs/static/pn_token-revocation.html" target="_blank">TokenRevocation</a> for additional information about this notification. Reserved for future use. This notification is sent to a subscribed buyer and seller when that seller has marked an item as 'shipped'. This notification is sent to a subscribed buyer and seller when that seller has marked an order as 'paid'. This notification is applicable to both buyers and sellers and is sent when a response to the eBay Money Back Guarantee case is due from that user. When an eBay Money Back Guarantee case is opened, this notification is only sent to the seller involved in the case and not the buyer. This notification is also sent to a subscribed seller when the buyer has opened up either of the following:<ul><li>an Item Not Received inquiry against an order line item</li><li>an Item Not Received case against that seller.</li></ul> This notification will appear in the getEBPCaseDetail call response. See <a href="https://developer.ebay.com/api-docs/static/pn_ebp-my-response-due.html" target="_blank">EBPMyResponseDue</a> for additional information about this notification. This notification is applicable to both buyers and sellers and is sent when a response to the eBay Money Back Guarantee case is due from the other party in the case. This notification will appear in the getEBPCaseDetail call response. See <a href="https://developer.ebay.com/api-docs/static/pn_ebp-other-party-response-due.html" target="_blank">EBPOtherPartyResponseDue</a> for additional information about this notification. This notification is applicable to both buyers an sellers and is sent when an eBay Money Back Guarantee case is escalated to eBay customer support. This notification is also sent to a subscribed seller when an Item Not Received inquiry against an order line item has been escalated to an eBay Money Back Guarantee case. This notification will appear in the getEBPCaseDetail call response. See <a href="https://developer.ebay.com/api-docs/static/pn_ebp-escalated-case.html" target="_blank">EBPEscalatedCase</a> for additional information about this notification. This notification is applicable to both buyers and sellers and is sent when the decision of an eBay Money Back Guarantee case is appealed. This notification will appear in the getEBPCaseDetail call response. See <a href="https://developer.ebay.com/api-docs/static/pn_ebp-appealed-case.html" target="_blank">EBPAppealedCase</a> for additional information about this notification. This seller-facing notification is sent when payment (to eBay or buyer) related to the outcome of an eBay Money Back Guarantee case is due. This notification will appear in the getEBPCaseDetail call response. See <a href="https://developer.ebay.com/api-docs/static/pn_ebp-my-payment-due.html" target="_blank">EBPMyPaymentDue</a> for additional information about this notification. This seller-facing notification is sent when payment (to eBay or buyer) related to the outcome of an eBay Money Back Guarantee case is processed. This notification will appear in the getEBPCaseDetail call response. See <a href="https://developer.ebay.com/api-docs/static/pn_ebp-my-payment-done.html" target="_blank">EBPPaymentDone</a> for additional information about this notification. This notification is applicable to both buyers and sellers and is sent when an appeal of an eBay Money Back Guarantee case decision has been closed. This notification will appear in the getEBPCaseDetail call response. See <a href="https://developer.ebay.com/api-docs/static/pn_ebp-closed-appeal.html" target="_blank">EBPClosedAppeal</a> for additional information about this notification. This notification is is applicable to both buyers and sellers and is sent when an eBay Money Back Guarantee case has been closed. This notification can also be sent to the subscribed seller when the buyer has closed either of the following:<ul><li>an Item Not Received inquiry against an order line item</li><li>an Item Not Received case opened by that buyer</li></ul> This notification will appear in the getEBPCaseDetail call response. See <a href="https://developer.ebay.com/api-docs/static/pn_ebp-closed-case.html" target="_blank">EBPClosedCase</a> for additional information about this notification. This notification is sent to a subscribed buyer or seller when that user receives a high-priority message in InBox. If subscribed to by a buyer or seller, and when applicable, this notification will appear in the GetMyMessages call response. For this notification to be returned in GetMyMessages, the DetailLevel value in the GetMyMessages request must be set to <code>ReturnMessages</code>. MyMessagesHighPriorityMessage, MyMessagesM2MMessage, and MyMessagesHighPriorityMessageHeader cannot be subscribed to at the same time or specified in the same call. This notification is sent to a subscribed buyer or seller when that user receives a high-priority message in InBox. If subscribed to by a buyer or seller, and when applicable, this notification will appear in the GetMyMessages call response. For this notification to be returned in GetMyMessages, the DetailLevel value in the GetMyMessages request must be set to <code>ReturnHeaders</code>. MyMessagesHighPriorityMessage, MyMessagesM2MMessage, and MyMessagesHighPriorityMessageHeader cannot be subscribed to at the same time or specified in the same call. This notification is is applicable to both buyers and sellers and is sent when an eBay Money Back Guarantee case has been put on hold by eBay customer support. This notification will appear in the getEBPCaseDetail call response. See <a href="https://developer.ebay.com/api-docs/static/pn_ebp-on-hold-case.html" target="_blank">EBPOnHoldCase</a> for additional information about this notification. This notification is sent to a subscribed seller after the buyer's payment on an order has cleared. This notification is sent to a subscribed seller when eBay is prepared to send the seller's funds for an order that was previously placed on hold. This notification is sent to a subscribed buyer when the listing of the auction item where the buyer has an active bid is about to end. This event has a TimeLeft property that defines the 'ending soon' threshold value. This notification is sent to a subscribed buyer when an item in the buyer's shopping cart is about to end. This event has a TimeLeft property that defines the 'ending soon' threshold value. This notification is applicable to both buyers and sellers and is sent when a return request involving those users is created. This notification will appear in the getReturnDetail call response. See <a href="https://developer.ebay.com/api-docs/static/pn_return-created.html" target="_blank">ReturnCreated</a> for additional information about this notification. This seller-facing notification is sent when a return request is waiting for information from the seller, like a Return Merchandise Authorization (RMA) number or a correct return address. IThis notification will appear in the getReturnDetail call response. See <a href="https://developer.ebay.com/api-docs/static/pn_return-wait-for-seller-info.html" target="_blank">ReturnWaitingForSellerInfo</a> for additional information about this notification. This notification is applicable to both buyers and sellers and is sent when information from the seller (e.g. a Return Merchandise Authorization number) is overdue. This notification will appear in the getReturnDetail call response. See <a href="https://developer.ebay.com/api-docs/static/pn_return-seller-info-overdue.html" target="_blank">ReturnSellerInfoOverdue</a> for additional information about this notification. This notification is applicable to both buyers and sellers and is sent when the buyer has shipped a return item back to the seller. This notification will appear in the getReturnDetail call response. See <a href="https://developer.ebay.com/api-docs/static/pn_return-shipped.html" target="_blank">ReturnShipped</a> for additional information about this notification. This notification is applicable to both buyers and sellers and is sent when a return item is received by the seller. This notification will appear in the getReturnDetail call response. See <a href="https://developer.ebay.com/api-docs/static/pn_return-delivered.html" target="_blank">ReturnDelivered</a> for additional information about this notification. This notification is applicable to both buyers and sellers and is sent when a refund to the buyer is overdue on a return. This notification will appear in the getReturnDetail call response. See <a href="https://developer.ebay.com/api-docs/static/pn_return-refund-overdue.html" target="_blank">ReturnRefundOverdue</a> for additional information about this notification. This notification is applicable to both buyers and sellers and is sent when a return request is closed. This notification will appear in the getReturnDetail call response. See <a href="https://developer.ebay.com/api-docs/static/pn_return-closed.html" target="_blank">ReturnClosed</a> for additional information about this notification. This notification is applicable to both buyers and sellers and is sent when a return request is escalated into a eBay Money Back Guarantee case. This notification will appear in the getReturnDetail call response. See <a href="https://developer.ebay.com/api-docs/static/pn_return-escalated.html" target="_blank">ReturnEscalated</a> for additional information about this notification. This notification is sent to a subscribed seller when a buyer has requested an order cancellation. This notification is no longer applicable. Do not use. This notification is sent to a subscribed seller when a refund to the buyer has been successfully processed. This notification is sent to a subscribed seller when a refund to the buyer has failed. This event type has been deprecated along with legacy user disputes. As an alternative, subscribe to EBPMyResponseDue event type. This notification is sent to a subscribed seller alerting the seller that the buyer will soon be eligible to escalate an Item Not Received inquiry into an eBay Money Back Guarantee case. This event type has been deprecated along with legacy user disputes. This event type has been deprecated along with legacy user disputes. As an alternative, subscribe to EBPClosedCase event type. This event type has been deprecated along with legacy user disputes. As an alternative, subscribe to EBPEscalatedCase event type. This notification is sent to a subscribed buyer when an In-Store Pickup or Click and Collect order is ready to be picked up at the merchant's store. This notification is sent to a subscribed seller when the quantity of a multiple-quantity, Good 'Til Cancelled, fixed-price listing has reached '0'. This notification will only be sent if the seller has the out-of-stock feature turned on in My eBay Preferences. This notification is sent to a subscribed buyer if payment is still due for an order. This notification is sent to a subscribed buyer or seller if the status of a member-to-member message has changed. A template for an SMS notification message. The SMS message. Conditionally The EIAS userId. This enumeration type contains the payloads to use for delivering platform notifications. Note: The notification payload type defaults to <code>eBLSchemaSOAP</code>, so the NotificationPayloadType field no longer has to be included in a SetNotificationPreferences call. NonSchemaSOAP The only schema format supported for both standard XML and SOAP API payloads. Reserved for internal or future use Defines roles for platform notifications. (in) Specifies that you want to set or return application-level preferences. Default value. (in) Specifies that you want to set or return user-level preferences. (in) Specifies that you want to set or return user data-level preferences. (in) Specifies that you want to set or return event-level preferences. Reserved for future use Summary information about notifications delivered, failed, errors, queued for a given application ID and time period. Returns the number of notifications delivered successfully during the given time period. GetNotificationsUsage Always Returns the number of new notifications that were queued during the given time period. GetNotificationsUsage Always Returns the number of pending notifications in the queue during the given time period. GetNotificationsUsage Always Returns the number of notifications that permanently failed during the given time period. GetNotificationsUsage Always Returns the number of notifications for which there were delivery errors during the given time period. GetNotificationsUsage Always User data related to notifications. An application subscribing to notifications can include an XML-compliant string, not to exceed 256 characters, which will be returned in the notification payload. The string can contain user-specific information to identify a particular user. Any sensitive information should be passed with due caution and proper encryption. SetNotificationPreferences Conditionally GetNotificationPreferences Conditionally This type is deprecated, as the maximum number of policy violations for a buyer is no longer a valid Buyer Requirement at the account or listing level. GeteBayDetails Conditionally This field is deprecated. 1065 NoOp 1065 Type used by the BidArray container that is returned in the GetAllBidders response. The BidArray container is an array of all bids made on an auction listing that is specified in the call request. Each Offer container consists of detailed information on each bid made on an auction listing that is specified in the call request. Information in this container includes the amount of the bid, the time of the bid, and data for the user making the bid. GetAllBidders Conditionally Contains information pertaining to an offer made on an item listing and the current bidding or purchase state of the listing. Indicates the type of offer being made on the specified listing. If the item is Best Offer-enabled and the buyer makes a Best Offer (or a counter offer), then after the PlaceOffer call, the buyer can get the status of the Best Offer (and a seller-counter-offer, etc.) using the GetBestOffers call. See <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/best-offers.html" target="_blank">Best Offer</a> for information about Best Offer-enabled listings and about GetBestOffers. GetAllBidders Always Absentee, Bid, BuyItNow, Cancelled, Counter, Decline, Offer, Purchase, Retraction, Unknown PlaceOffer Bid, Purchase, Accept, Counter, Decline, Offer Yes Three-digit currency code for the currency used for the auction. Valid values can be viewed in the CurrencyCodeType code list. GetAllBidders Always The unique identifier of an eBay listing item listed on the eBay site. Returned by eBay when the item is created. 533 629 NoOp PlaceOfferRequest.ItemID,ItemBidDetails.ItemID Amount of the offer placed. For auction listings, the amount bid on the item (subject to outbid by other buyers). For fixed-price listings, the fixed sale price at which the item is purchased. For auction listings with an active Buy It Now option, this amount will be either the Buy It Now price for purchase or the amount of a bid, depending on the offer type (as specified in Action). For PlaceOffer, the CurrencyID attribute is ignored if provided. Regarding Value-Added Tax (VAT): Even if VAT applies, you do not need to add VAT to the MaxBid value. If VAT applies to the listing, the seller can specify a VAT percent value when they list the item. GetAllBidders Always PlaceOffer Yes Specifies the quantity of items from the specified listing that the user tendering the offer intends to purchase, bid on, or make a Best Offer on. For auctions, the value is always 1 . For multiple-quantity listings, this value must be greater than zero but not exceeding the quantity available for sale in the listing. GetAllBidders Always PlaceOffer Yes Indicates the user's preference to accept second chance offers. If <code>true</code>, the user is willing to be the recipient of second chance offers. GetAllBidders Always Unique ID identifying the currency in which the localized offer amounts are expressed. GetAllBidders Always Timestamp indicating the date and time that the bid was placed. GetAllBidders Always This amount indicates the highest bid that the corresponding bidder has made on the auction item. If that specific bidder has only made one bid on the auction listing, this value will be the same value as in the MaxBid field, but if the bidder has made multiple bids on the auction item, the HighestBid will show the highest of the bidder's bids, but MaxBid will show the value of the corresponding bid. GetAllBidders Always Dollar amount of the bid in the user's currency. This field is always returned but its amount will be the same as the value in the MaxBid field, unless currency conversion was actually performed. GetAllBidders Always The unique identifier of the order line item (transaction). An order line item is created when a winning bidder commits to purchasing an item. The TransactionID value for auction listings is always <code>0</code> since there can be only one winning bidder/one sale for an auction listing. Note: Historically, TransactionID values have been '0' for auction listings, and some developers may have built logic around this. However, non-zero TransactionID values for auction listings started being used for some eBay marketplaces beginning in July 2024, and all eBay marketplaces are expected to start using non-zero TransactionID values for auction listings in the near future. If necessary, developers should update code to handle non-zero transaction IDs for auction transactions. This container consists of detailed information on the user that made the bid. Some information in this container will be masked unless the call is made by the owner of the listing. GetAllBidders Always If <code>true</code>, confirms that the bidder read and agrees to eBay's privacy policy. Applies if the subject item is in a category that requires user consent. If user consent, which is confirmation that a bidder read and agrees to eBay's privacy policy, is required for a category that the subject item is in, this value must be <code>true</code> for a bid to occur. PlaceOffer No This field is deprecated. A message from the buyer to the seller. Applies if the buyer is using PlaceOffer to perform a Best Offer-related action (Best Offer, Counter Offer, etc.). PlaceOffer No The unique identifier of a Best Offer on an item. This value must be specified as input to PlaceOffer if a buyer is performing any action against a Best Offer or Counter Offer. PlaceOffer Conditionally The maximum bid placed by the user making the call. This field is only returned if the corresponding bid was made by the user making the call. GetAllBidders Conditionally Type used by the OrderArray container that is returned in order management calls. The OrderArray container consists of one or more eBay orders that match the input criteria. Details of an eBay order. One eBay order can have one or more order line items (Transaction objects). GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manage-fulfill-combine-invoices.html Combined Invoice This container will be returned if there are one or more errors or warnings with the corresponding order. This container consists of detailed information on the warning or error, including the actual error message and information on any input parameters that actually triggered the warning or error. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Type defining the OrderIDArray container, which consists of an array of order IDs. The OrderIDArray container is used to specify one or more orders to retrieve in a GetOrders call. A unique identifier for an eBay order. If one or more OrderID values are used in a GetOrders call, any order status or date range filters are ignored. Note: The unique identifier of a 'non-immediate payment' order will change as it goes from an unpaid order to a paid order. Due to this scenario, all calls that accept Order ID values as request filters/parameters, including the GetOrders call, will support the identifiers for both unpaid and paid orders. 40 GetOrders

DetailLevel: none, ReturnAll

Conditionally Type that represents the unique identifier for an eBay order. The format is a non-parsable string, globally unique across all eBay marketplaces, and consistent for both single line item and multiple line item orders. Enumerated type that defines the possible values for order states. Some of these values can be used as OrderStatus filters in the GetOrders request payload, and some of these values may be returned in any of the order management calls under the OrderStatus field. See the individual value descriptions for more information on how they are used and/or when they are returned. Authenticated, Default, Invalid, Shipped This value indicates that the order is not yet complete. An order in the <code>Active</code> state means that the buyer has not initiated payment for the order. While an order is in this state, it can be combined into a <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manage-fulfill-combine-invoices.html" target="_blank">Combined Invoice</a>, a buyer can request a cancellation, and/or a seller can update payment details (including a change in order price) or shipping details (including shipping cost and shipping service). This value can be used a filter value in the OrderStatus field of the GetOrders request payload, and it can also be returned in any of the order management calls. This value can be used a filter value in the OrderStatus field, and if used, all inactive orders will be returned. This value indicates that the order is paid for and complete. An order in the <code>Completed</code> state means that no other changes to the order can be made. This value can be used a filter value in the OrderStatus field of the GetOrders request payload, and it can also be returned in any of the order management calls. This value indicates that the order has been cancelled. Depending on whether payment was made or not, the seller may also need to refund the buyer after an order is cancelled. This value can be used a filter value in the OrderStatus field of the GetOrders request payload, and it can also be returned in any of the order management calls. This enumeration value was only used for the deprecated Half.com site, so is no longer applicable and should not be used as an OrderStatus value in the GetOrders request payload. This value is not used. This enumeration value is no longer applicable and should not be used as an OrderStatus value in the GetOrders request payload. This enumeration value indicates that the order is currently in the state of being processed, but is not yet complete. This value is not supported by the OrderStatus field of the GetOrders request payload, but it can be returned in any of the order management calls. This enumeration value is no longer applicable and should not be used as an OrderStatus value in the GetOrders request payload. Reserved for internal or future use. This enumeration value is passed into the OrderStatus of GetOrders to retrieve orders in all states. This is the default value. This value is not applicable to the response payloads of the order management calls. This value indicates that a buyer has initiated a cancellation request on the order. If a seller sees an order in this state, that seller must either approve or reject the cancellation request through My eBay Web flows or through the Post-Order API cancellation calls. This enumeration value cannot be used as an OrderStatus value in the GetOrders request payload. All applicable sold listings, regardless of their Paid or Shipped status. Sold listings that have not yet been marked as Paid in My eBay. Sold listings that have not yet been marked as Shipped in My eBay. Sold listings that have been marked as Paid and Shipped in My eBay. Reserved for future or internal use. Type used by the OrderTransactionArray container that is returned in the GetMyeBaySelling and GetMyeBayBuying calls. The OrderTransactionArray container consists a list of orders and each order line item in that order. This container consists of detailed information on a specific order and each order line item in that order. GetMyeBayBuying Conditionally WonList DeletedFromWonList

DetailLevel: none, ReturnAll

GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally Contains an order or a transaction. A transaction is the sale of one or more items from a seller's listing to a buyer. An order combines two or more transactions into a single payment. Contains the information describing an order. GetMyeBayBuying Conditionally WonList DeletedFromWonList

DetailLevel: none, ReturnAll

GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally Contains the information describing a transaction. GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally This type is used to express the details of an order. An order may contain one or more line items (purchases) from the same buyer. Regardless of how many line items an order has, only one payment is made for the order. The GetOrders call returns many of the fields of this type. The GetItemTransactions and GetSellerTransactions calls will only return order-level details if the IncludeContainingOrder boolean field is included in the call request and set to <code>true</code>. The AddOrder call is used to combine two or more unpaid order line items (between the same seller and buyer) into a 'Combined Invoice' order. While combining these order line items into one 'Combined Invoice' order, the seller can make adjustments to accepted payment methods, shipping details (including costs), and the total cost of the order. Sometimes, sellers will reduce the cost of shipping if one or more order line items can be shipped together in the same package. The GetMyeBaySelling call returns order details if the seller wishes to view listings that have sold, and the GetMyeBayBuying call returns order details if the buyer wishes to view items they have won or purchased. A unique identifier for an eBay order. This identifier is globally unique across all eBay marketplaces, and consistent for both single line item and multiple line item orders. Note that the order ID will change for a 'non-immediate payment' order as it goes from an unpaid order to a paid order. Note: The value in the OrderID and ExtendedOrderID fields should always be the same. The ExtendedOrderID field was added back in 2019 during a transition period where the Trading API was supporting both old and new order ID formats, and which order ID format that was returned was dependent on the compatibility level version used. 40 GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetItemTransactions GetSellerTransactions ContainingOrder

DetailLevel: none, ReturnAll

Conditionally This enumeration value indicates the current status of the order. GetOrders All, Authenticated, Default, Inactive, Invalid, Shipped

DetailLevel: none, ReturnAll

Always OrderReport All, Authenticated, Default, Inactive, Invalid, Shipped Always GetItemTransactions GetSellerTransactions All, Authenticated, Default, Inactive, Invalid, Shipped

DetailLevel: none, ReturnAll

Conditionally This value indicates the dollar amount by which the buyer has adjusted the order total. Adjustments to order costs may include shipping and handling, buyer discounts, or added services. A positive amount indicates the amount is an extra charge being paid to the seller by the buyer. A negative value indicates this amount is a credit given to the buyer by the seller. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always This value indicates the total amount paid by the buyer for the order. This amount includes the sale price of each line item, shipping and handling charges, additional services, sales tax, and any <a href="https://www.ebay.co.uk/help/buying/paying-items/buyer-protection-fee?id=5594" target="_blank">Buyer Protection fee</a>s + tax against this fee for any line items in the order. This value is only returned after the buyer has paid for the order. Note: For GetOrders only: If using Trading WSDL Version 1307 or above, the amount in this field will include sales tax. If using a Trading WSDL older than Version 1307, the amount in this field will not include sales tax. To incorporate the new logic while using a Trading WSDL that is older than 1307, developers can also use the X-EBAY-API-COMPATIBILITY-LEVEL header and set its value to 1307 or higher. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This value indicates the amount that the buyer saved on the order due to any discounts (item, shipping, promotional) applied to the purchase, or if the seller 'manually' reduced the order total. This field is always returned even when it is '0.0'. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always This container indicates the current status of the order, including a timestamp that indicates the last time that the status of the order changed. For orders that have been paid for, the Status value will show as <code>Complete</code>. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always Container consisting of order-level shipping details. More shipping-related details can be found at the line item level for each line item in the order. In an AddOrder call, the seller can use the ShippingDetails container to make adjustments to shipping details, including the available shipping service options and shipping cost. Sometimes, sellers will reduce the cost of shipping if one or more order line items can be shipped together in the same package. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always AddOrder No GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally ShippingServiceOptions, ShippingType This value indicates whether a 'Combined Invoice' order was initiated/created by the buyer or by the seller. This field is only returned for Combined Invoice orders. An AddOrder call can be used by a seller or buyer to combine two or more unpaid order line items into a 'Combined Invoice' order. Once two or more line items are successfully combined into one order, the buyer only needs to make one payment (instead of multiple payments - one for each order line item). The CreatingUserRole field is required in the AddOrder call request. Note: Except for listings that required immediate payment, buyers also may have the opportunity to combine multiple line items (from the same seller) into a 'Combined Invoice' order through the buy/checkout flow. This may include accepted Best Offers or auctions that the buyer wins. https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manage-fulfill-combine-invoices.html Combined Invoice GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally AddOrder Yes Timestamp that indicates the date and time that the order was created. Note: For single line item orders, this timestamp value is often the same as the CreatedDate field in the corresponding Transaction container. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always In GetOrders and OrderReport, a PaymentMethods field will appear for each payment method available to the buyer for the order's purchase. However, once the buyer pays for the order, any and all of these PaymentMethods fields will stop being returned, and instead, the actual payment method used will be returned in the PaymentMethod field of the CheckoutStatus container. Note: Effective September 26, 2025, access to buyer payment details for U.S. users will be limited to select developers. All other developers will receive a value of "CustomCode" in place of buyer payment details. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. In an AddOrder call, the seller can use one or more PaymentMethods fields to override whatever available payment methods were already defined for each individual line item. Note: For AddOrder, the seller can only specify offline payment methods (if offline payment is supported for the listing), as eBay now controls all electronic payment methods avaialable to buyers, and sellers have no control over these payment methods. AddOrder Conditionally CreditCard, DirectDebit GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always The email address of the seller involved in the order. The email address of the seller is only returned if it is the same seller making the call. Note: For the GetOrders calls, this field is only returned to the seller of the order; this field is not returned to the buyer or to a third party. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally AddOrder No This container shows the shipping address for the order. Note: For an Authenticity Guarantee program shipment, this is the address of the authenticator's warehouse. The authenticator is responsible for delivery to the buyer's shipping address. Note: For transactions completed offline, the shipping address detail may be empty. Note: For In-Store Pickup and Click and Collect orders, this is the address of the merchant's store where the buyer will pick up the order. Note: For eBay Vault scenarios: GetOrders and GetItemTransactions calls, mock address details are returned for: - Vault to vault orders: Buyer and Seller View - Ship to vault orders: Mock addresses are returned for the Buyer View (only); the address returned for the Seller View will be the authenticator's address. - Vault in-hand submission orders: the address returned for the Buyer View will be the authenticator's address. The following address details are returned for mock addresses: <pre> <ShippingAddress> <code>  <Name>eBay Vault</Name></code> <code>  <AddressID>Invalid Request</AddressID></code> <code>  <AddressOwner>eBay</AddressOwner></code> <code>  <AddressUsage>Invalid</AddressUsage></code> <code>  <CityName>Invalid Request</CityName></code> <code>  <Country>US</Country></code> <code>  <CountryName>Invalid Request</CountryName></code> <code>  <ExternalAddressID>Invalid Request</ExternalAddressID></code> <code>  <Phone>Invalid Request</Phone></code> <code>  <PostalCode>Invalid Request</PostalCode></code> <code>  <StateOrProvince>Invalid Request</StateOrProvince></code> <code>  <Street1>Invalid Request</Street1></code> <code>  <Street2></Street2></code> </ShippingAddress> </pre> GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always Container consisting of details about the domestic or international shipping service selected by the buyer for delivery of the order. Note that more shipping service information may be returned at the order line item level in the Transaction.ShippingServiceSelected container. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always The cumulative item cost for all line items in the order. This value does not take into account any shipping/handling costs, sales tax costs, or any discounts. For a single line item order, the amount in this field should be the same as the amount in the Transaction.TransactionPrice field. For a multiple line item order, the amount in this field should equal the cumulative amount of each Transaction.TransactionPrice fields for each order line item. Note: For GetOrders only: This field, for backward compatibility, includes discounts from the TransactionPrice value and Order.Subtotal value. GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always The Total amount shows the total cost for the order, including total item cost (shown in Subtotal field), shipping charges (shown in ShippingServiceSelected.ShippingServiceCost field), sales tax (shown in SalesTax.SalesTaxAmount field), and any <a href="https://www.ebay.co.uk/help/buying/paying-items/buyer-protection-fee?id=5594" target="_blank">Buyer Protection fee</a>s + any taxes applied against this fee for any line items in the order. Note: For GetOrders only: If using Trading WSDL Version 1307 or above, the amount in this field will include sales tax. If using a Trading WSDL older than Version 1307, the amount in this field will not include sales tax. To incorporate the new logic while using a Trading WSDL that is older than 1307, developers can also use the X-EBAY-API-COMPATIBILITY-LEVEL header and set its value to 1307 or higher. In an AddOrder call, the seller can pass in the Total amount for the 'Combined Invoice' order, and this is what the buyer will be expected to pay for the order. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always AddOrder Yes Container consisting of one or more line items that comprise an order. The data for each order line item in the order is stored in a separate Transaction container. Under the TransactionArray container in an AddOrder call, a seller or buyer specifies two or more (up to 40) order line items into a 'Combined Invoice' order. https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/manage-fulfill-combine-invoices.html Combined Invoice GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally AddOrder Yes The eBay user ID of the order's buyer. Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always Timestamp indicating the date and time of order payment. This field is not returned until payment has been made by the buyer. This time is specified in GMT (not Pacific time). See <a href="https://developer.ebay.com/api-docs/user-guides/static/make-a-call/tapi-data-types.html#utc-local"> API data types</a> section of the Making a Trading API call guide for information about converting between GMT and other time zones. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Timestamp indicating the date and time of order shipment. This field is not returned until shipment tracking is provided for all line items in the order, or if the order has been marked as 'shipped' by the seller. This time is specified in GMT (not Pacific time). See <a href="https://developer.ebay.com/api-docs/user-guides/static/make-a-call/tapi-data-types.html"> API data types</a> section of the Making a Trading API call guide for information about converting between GMT and other time zones. GetOrders

DetailLevel: none, ReturnAll

Conditionally Reserved for future use. This field is returned if the buyer left a message for the seller during checkout. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Unique identifier for the user that does not change when the eBay user name is changed. Use when an application needs to associate a new eBay user name with the corresponding eBay user. Since a bidder's user info is anonymous, this tag will be returned only to that bidder, and to the seller of an item that the user is bidding on. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This field indicates the type and/or status of a payment hold on the item. It is always returned for GetOrders, even if there are no payment holds (in which case, an enumeration value of <code>None</code> is shown). Note: For the GetItemTransactions and GetOrders calls, this field is only returned to the seller of the order; this field is not returned for the buyer or third party. Note: This field will stop being returned by GetItemTransactions and GetSellerTransactions on January 31, 2024. GetOrders

DetailLevel: none

Always OrderReport Always The amount of the refund due to, or already issued to the buyer for the order. This field is only returned in GetMyeBaySelling if a buyer refund is due, or was issued for the order. GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally This string value indicates the result of a seller's refund to the buyer. Its value are 'Success', 'Failure' or 'Pending'. This field is only returned in GetMyeBaySelling if the buyer has received a refund from the seller, or is due to receive a refund. GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally If IsMultilegShipping is <code>true</code>, at least one order line item in the order will not be shipped directly to the buyer. Orders requiring multiple shipping legs include international orders being shipped through the Global Shipping Program or through eBay International Shipping, as well as orders subject to/eligible for the Authenticity Guarantee program. For both international shipping options, the address of the shipping logistics provider is shown in the MultiLegShippingDetails.SellerShipmentToLogisticsProvider.ShipToAddress container. Similarly, for Authenticity Guarantee orders, the authentication partner's shipping address is shown in the same container. If an order line item is subject to the Authenticity Guarantee service, the Transaction.Program container will be returned. Note: The ContainingOrder.IsMultiLegShipping field will stop being returned by GetItemTransactions and GetSellerTransactions on January 31, 2024. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This container consists of details related to the first leg of an order requiring multiple shipping legs. Types of orders that require multiple shipping legs include international orders going through Global Shipping Program or eBay International Shipping, as well as orders subject to/eligible for the Authenticity Guarantee program. If the item is subject to the Authenticity Guarantee service program, the seller ships the item to the authentication partner, and if the item passes an authentication inspection, the authentication partner ships it directly to the buyer. This container is only returned if the order has one or more order line items requiring multiple shipping legs. Note: The ContainingOrder.MultiLegShippingDetails container will stop being returned by GetItemTransactions and GetSellerTransactions on January 31, 2024. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Contains information about each monetary transaction that occurs for the order, including order payment, any refund, a credit, etc. Both the payer and payee are shown in this container. Note: The ContainingOrder.MonetaryDetails container will stop being returned by GetItemTransactions and GetSellerTransactions on January 31, 2024. GetOrders

DetailLevel:ReturnAll

Conditionally OrderReport Conditionally Container consisting of an array of PickupOptions containers. Each PickupOptions container consists of the pickup method and its priority. The priority of each pickup method controls the order (relative to other pickup methods) in which the corresponding pickup method will appear in the View Item and Checkout page. For GetOrders, this container is always returned prior to order payment if the seller created/revised/relisted the item with the EligibleForPickupInStore and/or EligibleForPickupDropOff flag in the call request set to 'true'. If and when the In-Store pickup method (US only) or 'Click and Collect' pickup method (UK and Australia only) is selected by the buyer and payment for the order is made, this container will no longer be returned in the response, and will essentially be replaced by the PickupMethodSelected container. Note: A seller must be eligible for the In-Store Pickup feature or Click and Collect feature to list an item that is eligible for In-Store Pickup or Click and Collect. At this time, the In-Store Pickup and Click and Collect features are generally only available to large retail merchants, and can only be applied to multiple-quantity, fixed-price listings. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally Container consisting of details related to the selected pickup method, including the pickup method type, the merchant's store ID, the status of the pickup, and the pickup reference code (if provided by merchant). This container is only returned when the buyer has selected the In-Store Pickup or Click and Collect option and has paid for the order. All fields in the PickupMethodSelected container are static, except for the PickupStatus field, which can change states based on the notifications that a merchant sends to eBay through the Inbound Notifications API. Note: A seller must be eligible for the In-Store Pickup or Click and Collect feature to list an item that is eligible for these features. At this time, the In-Store Pickup and Click and Collect features are generally only available to large retail merchants, and can only be applied to multiple-quantity, fixed-price listings. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally This is the eBay user ID of the order's seller. Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This is a unique identifier for the seller that does not change when the eBay user name is changed. This is useful when an application needs to associate a new eBay user name with the corresponding eBay user. Note: For the GetOrders call, this field is only returned to the seller of the order; this field is not returned for the buyer or third party. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This value indicates the reason why the order cancellation was initiated. This field is only returned if an order cancellation has been initiated by the buyer or seller. Typical buyer-initiated cancellation reasons include 'OrderPlacedByMistake', 'WontArriveInTime', or 'FoundCheaperPrice'. Sellers may initiate an order cancellation on behalf of the buyer. In this scenario, the seller should state the cancellation reason as 'BuyerCancelOrder'. If the seller is cancelling an order because he/she is out of stock on an item, the seller should state the cancellation reason as 'OutOfStock'. Unfortunately, in this scenario, the seller will receive a seller defect for this cancellation reason. See <a href="types/CancelReasonCodeType.html">CancelReasonCodeType</a> for the complete list of enumeration values that can be returned in this field. CancelReasonCodeType GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The current status for the order cancellation request (if it exists for the order). This field is only returned if a cancellation request has been made on the order, or if the order is currently going through the cancellation process, or if the order has already been cancelled. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This field will be returned at the order level only if the buyer purchased a digital gift card, which is delivered by email, or if the buyer purchased an item that is enabled with the 'Click and Collect' feature. Currently, LogisticsPlanType has two applicable values: <code>PickUpDropOff</code>, which indicates that the buyer selected the 'Click and Collect' option. With Click and Collect, buyers are able to purchase from thousands of sellers on the eBay UK and Australia sites, and then pick up their order from the nearest 'eBay Collection Point', including over 750 Argos stores in the UK. The Click and Collect feature is only available on the eBay UK and Australia sites; or, <code>DigitalDelivery</code>, which indicates that the order is a digital gift card that will be delivered to the buyer or recipient of the gift card by email. Note: The ContainingOrder.LogisticsPlanType field will stop being returned by GetItemTransactions and GetSellerTransactions on January 31, 2024. LogisticsPlanCodeType GetOrders

DetailLevel:none,ReturnAll

Conditionally OrderReport Conditionally This container will either consist of VAT or Codice Fiscale taxpayer identification information for the buyer. It is required that buyers registered on the Italy site provide their Codice Fiscale ID (similar to the Social Security Number for US citizens) before buying an item on the Italy site. On the Spain site, a Spanish seller has the option to require that Spanish buyers (registered on Spain site) provide a tax ID before checkout. This option is set by the seller at the account level. Once a Spanish buyer provides a tax ID, this tax ID is associated with his/her account, and once a tax ID is associated with the account, Spanish buyer will be asked to provide the tax ID during checkout on all eBay sites. Buyers with a registered address outside of Spain will not be asked to provide a tax ID during checkout. This container is only returned for Spanish or Italian sellers when the buyer was asked to provide tax identifier information during checkout. A BuyerTaxIdentifier container will be returned for each tax ID that is associated with the buyer's account. Note: The ContainingOrder.BuyerTaxIdentifier container will stop being returned by GetItemTransactions and GetSellerTransactions on January 31, 2024. GetOrders

DetailLevel:none,ReturnAll

Conditionally OrderReport Conditionally This container is returned in GetOrders (and other order management calls) if the 'Pay Upon Invoice' option is being offered to the buyer, and the seller is including payment instructions in the shipping package(s) for the order. The 'Pay Upon Invoice' option is only available on the Germany site. Note: The ContainingOrder.BuyerPackageEnclosures container will stop being returned by GetItemTransactions and GetSellerTransactions on January 31, 2024. GetOrders

DetailLevel:none,ReturnAll

Conditionally OrderReport Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally A unique identifier for an eBay order. This identifier is globally unique across all eBay marketplaces, and consistent for both single line item and multiple line item orders. Note that the order ID will change for a 'non-immediate payment' order as it goes from an unpaid order to a paid order. Note: The value in the OrderID and ExtendedOrderID fields should always be the same. The ExtendedOrderID field was added back in 2019 during a transition period where the Trading API was supporting both old and new order ID formats, and which order ID format that was returned was dependent on the compatibility level version used. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally If <code>true</code>, the order includes at least one transaction purchased under the eBay Plus program. eBay Plus is a premium buyer program offering fast, free domestic shipping and free returns on eligible items. eBay determines which listings qualify for eBay Plus based on whether the buyer has an active eBay Plus subscription and whether the listing meets the program's requirements. See <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-plus.html" target="_blank">eBay Plus</a> for listing requirements. Note: Currently, eBay Plus is available only to buyers in Germany and Australia. more details eBay Plus https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-plus.html OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This boolean field is returned as <code>true</code> if one or more line items in the order are subject to a tax (US sales tax or Australian Goods and Services tax) that eBay will collect and remit to the proper taxing authority on the buyer's behalf. This field is also returned if <code>false</code> (not subject to eBay Collect and Remit). A Transaction.eBayCollectAndRemitTaxes container is returned for any order line items subject to such a tax, and the type and amount of this tax is displayed in the Transaction.eBayCollectAndRemitTaxes.TaxDetails container. Australian 'Goods and Services' tax (GST) is automatically charged to buyers outside of Australia when they purchase items on the eBay Australia site. Sellers on the Australia site do not have to take any extra steps to enable the collection of GST, as this tax is collected by eBay and remitted to the Australian government. For more information about Australian GST, see the <a href="https://www.ebay.com.au/help/selling/fees-credits-invoices/taxes-import-charges?id=4121">Taxes and import charges</a> help topic. Buyers in all US states will automatically be charged sales tax for purchases, and the seller does not set this rate. eBay will collect and remit this sales tax to the proper taxing authority on the buyer's behalf. For more US state-level information on sales tax, see the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/taxes-import-charges?id=4121#section3">eBay sales tax collection</a> help topic. Note: The ContainingOrder.eBayCollectAndRemitTax field will stop being returned by GetItemTransactions and GetSellerTransactions on January 31, 2024. GetOrders Always OrderReport Always This field indicates the total number of line items in the order. This field is returned under the ContainingOrder container of a GetItemTransactions or GetSellerTransactions call. In order for the ContainingOrder container to be returned, a user must include the IncludeContainingOrder field in the call request and set its value to true. Note: This field is automatically returned if the user is using Version 1113 of the Trading WSDL (or newer), or if the user includes the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header and sets its value to <code>1113</code> (or newer). If a user is using a Trading WSDL older than 1113 (or is not setting the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header value to 1113 or newer), this field will not be returned. GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Contains a paginated list of items. An array of one or more items returned under one or more containers in a GetMyeBayBuying or GetMyeBaySelling call response. GetMyeBayBuying BidList BestOfferList LostList WatchList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList ScheduledList UnsoldList BidList

DetailLevel: none, ReturnAll

Conditionally This container shows the total numer of items that matched the input criteria and the total number of the results set. Users can use the Pagination.PageNumber field in the request to toggle through different pages in the results set. GetMyeBayBuying BidList LostList WatchList WonList BestOfferList DeletedFromLostList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList BidList

DetailLevel: none, ReturnAll

Conditionally Contains a paginated list of orders. Contains the list of orders. GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally Specifies information about the list, including number of pages and number of entries. GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList DeletedFromSoldList

DetailLevel: none, ReturnAll

Conditionally Contains a paginated list of order line items. Contains a list of Transaction objects. Returned as an empty tag if no applicable order line items exist. GetItemsAwaitingFeedback Always Provides information about the list of order line items, including number of pages and number of entries. GetItemsAwaitingFeedback Always Shows the pagination of data returned by call requests. Pagination of returned data is not needed nor supported for every Trading API call. See the documentation for individual calls to determine whether pagination is supported, required, or desirable. Indicates the total number of pages of data that could be returned by repeated requests. Returned with a value of 0 if no pages are available. GetAccount GetItemsAwaitingFeedback GetMemberMessages Always GetFeedback Always

DetailLevel: none, ReturnAll

GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always Conditionally GetMyeBayBuying BidList BestOfferList LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Always GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetBestOffers

DetailLevel: none, ReturnAll

Conditionally Indicates the total number of entries that could be returned by repeated call requests. Returned with a value of 0 if no entries are available. GetItemsAwaitingFeedback GetMemberMessages Always GetFeedback Always

DetailLevel: none, ReturnAll

GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetAccount Always Conditionally GetMyeBayBuying BidList BestOfferList LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Always GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetBestOffers

DetailLevel: none, ReturnAll

Conditionally Enumerated type that lists the possible states of buyer payment for an order. PaymentPendingWithEscrow, PaidWithEscrow, EscrowPaymentCancelled, PaymentPendingWithPaisaPay, PaidWithPaisaPay, PaymentPendingWithPaisaPayEscrow, PaidWithPaisaPayEscrow, PaisaPayNotPaid, PaymentPendingWithPayPal, PaidWithPayPal This enumeration value is returned if the buyer has completed checkout, but eBay cannot confirm whether or not the buyer has paid for the order. It is possible that the buyer has paid with an 'offline' payment method, but the order has not been marked as paid. This enumeration value is returned if the buyer has not completed the checkout process and so has not made payment. This value is deprecated and should no longer be returned. This value is deprecated and should no longer be returned. This enumeration value is returned if the order was marked as paid by eBay or the seller. No longer an applicable value. No longer an applicable value. No longer an applicable value. PaisaPay is a deprecated payment method, so this value is no longer applicable. PaisaPay is a deprecated payment method, so this value is no longer applicable. This enumeration value is returned if the buyer's payment is in process, but not yet complete. PaisaPay is a deprecated payment method, so this value is no longer applicable. PaisaPay is a deprecated payment method, so this value is no longer applicable. PaisaPay is a deprecated payment method, so this value is no longer applicable. This enumeration value is returned if the buyer's payment was refunded. The selected payment method is COD and the buyer will make the payment upon delivery. The buyer has paid for the order with the COD payment method. Reserved for future use. This enumeration value is returned if the buyer has paid for the order. This enumeration value is returned if the buyer was offered the 'Pay Upon Invoice' option. The 'Pay Upon Invoice' option is only available to eligible German buyers as part of Progressive Checkout on the German site. If a German buyer is offered the 'Pay Upon Invoice' option, that buyer is not required to pay for the order until after receiving an order invoice from the seller. This type is no longer applicable/used, as the the Paisa Pay Escrow payment feature was only applicable to the eBay India site, and this site is no longer a functional eBay marketplace for sellers. This type is deprecated. This type is deprecated. Type defining the PaymentDetails container, which is used by the seller to specify the amount of the initial deposit, and the due dates for the deposit and the full payment for a motor vehicle listing. Note: The seller may not use the PaymentDetails container if selling a motor vehicle through a Classified Ad listing. If it is used in a Trading call, it will be dropped and the seller will get a warning that it was dropped. For a Classified Ad listing, the buyer and seller directly discuss amongst themselves any details on a deposit, or due dates for a deposit and full balance. eBay will not be involved in this process for a Classified Ad listing. This field is used to set the due date (in hours) for the motor vehicle deposit. The deposit amount is specified in the DepositAmount field. The "clock starts" on the deposit due date as soon as the buyer commits to buying the vehicle by clicking the Buy It Now button, by winning the auction, or by the seller accepting that buyer's Best Offer/counteroffer. The three supported values here are <code>24</code>, <code>48</code> (default), and <code>72</code> hours. Note: If the immediate payment requirement is set for the listing (see Item.AutoPay description), and the listing qualifies for immediate payment (e.g. the Buy It Now button is used), the HoursToDeposit field will not be applicable, since the buyer will be required to pay any deposit amount immediately (and not within 1, 2 or 3 days). 24 (hours) 72 (hours) 48 (hours) AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This field is used to set the due date (in days) for the buyer to pay off the full balance of the motor vehicle. The "clock starts" on the full payment due date as soon as the buyer commits to buying the vehicle by clicking the Buy It Now button, by winning the auction, or by the seller accepting that buyer's Best Offer/counteroffer. The three supported values here are <code>3</code>, <code>7</code> (default), <code>10</code>, and <code>14</code> days. The seller must specify one or more of the following offline payment methods in the listing. The buyer will be expected to use one of these payment method options to pay the full balance of the motor vehicle. <ul> <li>CashOnPickup</li> <li>MOCC (money order or cashier's check)</li> <li>PersonalCheck</li> </ul> 3 14 7 AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem No GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This dollar value indicates the amount of the initial deposit on the vehicle required from the buyer. If the immediate payment requirement is set for the listing (see Item.AutoPay description), and the listing qualifies for immediate payment (e.g. the Buy It Now button is used), the deposit will be required immediately, and the HoursToDeposit field (if set) will not be applicable. If immediate payment is required for a motor vehicle deposit, the value input into this field cannot exceed '500.0', or an error will occur. If there is no immediate payment requirement set for the listing the deposit will be required in 24, 48, or 72 hours after commitment to purchase (see the HoursToDeposit field). If immediate payment is not required for a motor vehicle deposit, the value input into this field cannot exceed '2000.0', or an error will occur. If this field is not included in an Add/Revise call, its value defaults to '0.0', which would technically mean that a deposit is not required, even if the DepositType and HoursToDeposit fields were included. Motor vehicle deposit details will be shown to prospective buyers in the listing. The available payment methods for the deposit will be shown on the checkout page once the buyer clicks the the Buy It Now button. For ReviseItem and related calls: If the listing has no bids, the seller can add or lower a deposit; and they can increase the deposit if the listing doesn't require immediate payment. The seller can also remove the immediate payment option (if any). If the listing has bids, the seller can only lower an existing deposit; but not add or increase a deposit. The seller can't remove immediate payment when a listing with a deposit has bids. 500.0 (if immediate payment required); 2000.0 (if immediate payment not required) AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally In order for a seller to require a motor vehicle deposit from a buyer, this field must be included and set to <code>OtherMethod</code>. Otherwise, the field will default to <code>None</code> and a deposit will not be required. None AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Enumerated type that contains the list of possible values that can be returned in the PaymentHoldStatus container. ReleaseFailed This value indicates a possible issue with the buyer that needs to be reviewed by eBay. This value indicates a possible issue with the seller that needs to be reviewed by eBay. This value indicates that a payment hold on the order has been released. This value indicates that there is no payment hold on the order. This value indicates that there is a "new seller hold" on the order. eBay may hold payments to a new seller for up to 21 days. This value indicates that there is a payment hold on the order. This value indicates that the process for the release of funds for the order has been initiated. This value indicates that the funds are available in the seller's account. This value is no longer used. This value is reserved for internal or future use. This type contains information about one or more payments made by the buyer to pay for an order. This container consists of detailed information about each payment made by the buyer to pay for an order. In many cases, there may be only one payment - the payment made from the buyer to the seller, but in the case of an order going through the Global Shipping Program, one payment goes to the seller for the price of the order, and then an import charge and a portion of the shipping charges may go to eBay Global Shipping Program partner. In the case of an order that is subject to Australia import tax, one payment goes to the seller for the total price of the order, and the import tax goes to eBay for remittance to the Australian government. A Payment container will be returned that shows the <a href="https://www.ebay.co.uk/help/buying/paying-items/buyer-protection-fee?id=5594" target="_blank">Buyer Protection fees</a>, plus the tax applied against that fee. Please note that the additional Payment container will show <code>eBay</code> as the Payee instead of the seller. The FeeOrCreditAmount container will reflect the amount. Note: Australia import tax is only applicable to the Australia site. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This enumerated type indicates the type of payment instructions included in the shipping package. This enumeration value indicates that payment instructions were included in the shipping package for the 'Pay Upon Invoice' order. Reserved for internal or future use. Defines the Payment Method feature. If the field is present, the corresponding feature applies to the category. The field is returned as an empty element (i.e., a boolean value is not returned). This type is used by the PaymentOptionDetails containers that are returned in GeteBayDetails if the <code>PaymentOptionDetails</code> value is used in a DetailName field in the call request. Note: Although site-level payment options are still returned in GeteBayDetails, it may be better to use the GetCategoryFeatures call instead, as this call returns the specific payment options that are accepted in specific categories. Note: Sellers no longer have to specify any electronic payment methods for listings, so one or more PaymentMethods fields will only be needed for listings that require/support payments off of eBay's platform. If an electronic payment is supplied in a PaymentMethods field, a warning will be triggered and the payment method will be dropped. This enumeration value is the enumeration that the seller would pass in to one of the PaymentMethods fields in an Add/Revise/Relist call (or in to a Payment busines policy). 613 613 Avoid Category.PaymentMethod GeteBayDetails Conditionally This field is a text-based/user-friendly description of the payment option. 613 613 Avoid Category.PaymentMethod GeteBayDetails Conditionally This string value indicates the version number of the update made to any payment options returned in GeteBayDetails. 613 613 Avoid Category.PaymentMethod GeteBayDetails Conditionally This timestamp indicates the date and time of the last update made to any payment options returned in GeteBayDetails. 613 613 Avoid Category.PaymentMethod GeteBayDetails Conditionally Type defining the values that can be returned in the eBayPaymentStatus field of order management calls. These values indicate the current status of the buyer's payment for an order. BuyerECheckBounced, BuyerCreditCardFailed, PayPalPaymentInProcess This value indicates that the buyer's payment for the order has cleared. A CheckoutStatus.eBayPaymentStatus value of 'NoPaymentFailure' and a CheckoutStatus.Status value of 'Complete' indicates that checkout is complete. This value should no longer be returned as electronic checks are no longer a valid buyer payment method on any eBay marketplace. This value should no longer be returned as the buyer's form of electronic payment is no longer exposed to the seller since eBay now receives payment from the buyer. This value indicates that the seller reported the buyer's offline payment as failed. This enumeration value would only be applicable for a sales transaction that occurred off of eBay's platform. This value should no longer be returned as the buyer's form of electronic payment is no longer exposed to the seller since eBay now receives payment from the buyer. This value indicates that the buyer's payment is in process, but has not yet cleared. Note: This value may also get returned for a sales transaction that occurred off of eBay's platform, and the payment status may stay in this state unless the seller marks the order as paid. Reserved for internal or future use. This type contains details about the allocation of funds to one payee from a buyer payment for a specified order. This field indicates the eBay user or eBay partner who submitted the payment. Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. For GetOrders and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the correct payer is returned to the buyer or seller, but the identity of the payer will be masked to all third parties. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The person or organization who is to receive the payment allocation. Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The date and time when the payment is received by the payee. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The amount of the payment that is allocated to the payee. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally A unique transaction ID for the payment. This field is not returned if the Payee field's type attribute is <code>eBayPartner</code>. For GetOrders and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the correct payment identifier is returned to the buyer or seller, but the payment identifier will be masked to all third parties. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Fee Amount is a positive value and Credit Amount is a negative value. This field is not returned if the Payee field's type attribute is <code>eBayPartner</code>. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The payment transaction ID. For GetOrders and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the correct payment identifier is returned to the buyer or seller, but the payment identifier will be masked to all third parties. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This type defines the MonetaryDetails container, which consists of detailed information about one or more exchanges of funds that occur between the buyer, seller, eBay, and eBay partners during the lifecycle of an order, as well as detailed information about a seller's refund (or store credit) to a buyer who has returned an item. Contains information about how different portions of the funds exchanged for a specified order are allocated among payees. Each allocated portion is represented by a Payment container. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This container consists of an array of one or more Refund containers, and each Refund container consists of detailed information about a seller's refund (or store credit) to a buyer who has returned an item. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Type defining the time periods used when evaluating the number of unpaid item strikes that a buyer has against their account. A seller can set up listing-level Buyer Requirements in an Add/Revise/Relist call that will block a buyer if that buyer has a specified number of unpaid item strikes against their account during a specified time period. Days_1, Days_540 This value is no longer applicable. This value indicates that the evaluation period is set back 30 days from the present date. This value indicates that the evaluation period is set back 180 days (approximately 6 months) from the present date. This value indicates that the evaluation period is set back 360 days (approximately 12 months) from the present date. This value is no longer applicable. This value is reserved for future or internal use. This type defines the PickupDetails container, which contains an array of PickupOptions containers. Each PickupOptions container consists of the pickup method and its priority. Note: At this time, the In-Store Pickup and Click and Collect features are generally only available to large retail merchants, and can only be applied to multi-quantity, fixed-price listings. In-Store Pickup is only applicable to the US site, and Click and Collect is only applicable to the UK, Germany, and Australia sites. Container consisting of a pickup method and the priority of the pickup method. The priority of each pickup method controls the order (relative to other pickup methods) in which the corresponding pickup method will appear in the View Item and Checkout page. This container is always returned prior to order payment if the seller created/revised/relisted the item with the EligibleForPickupInStore and/or EligibleForPickupDropOff flag in the call request set to 'true'. If and when the In-Store pickup method (US only) or 'Click and Collect' pickup method (UK and Australia only) is selected by the buyer and payment for the order is made, this container will no longer be returned in the response, and will essentially be replaced by the PickupMethodSelected container. Note: At this time, the In-Store Pickup and Click and Collect features are generally only available to large retail merchants, and can only be applied to multi-quantity, fixed-price listings. In-Store Pickup is only applicable to the US site, and Click and Collect is only applicable to the UK, Germany, and Australia sites. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally The PickupDropOffEnabled field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the "Click and Collect" feature. This field will be returned as long as 'PickupDropOffEnabled' is included as a FeatureID value in the call request or no FeatureID values are passed into the call request. The 'Click and Collect' feature is only available to large merchants on the eBay UK (site ID - 3), eBay Australia (Site ID - 15), and eBay Germany (Site ID - 77) sites. To verify if a specific category supports the the "Click and Collect" feature, pass in a CategoryID value in the request, and then look for a 'true' value in the PickupDropOffEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Note: For Click and Collect eligible sellers, the Click and Collect feature can only be enabled at the account level, and then each of the seller's listings within an Click and Collect enabled category will be automatically evaluated for Click and Collect eligibility. Complex type defining the PickupInStoreDetails container, that is used in Add/Revise/Relist calls to enable the listing for In-Store Pickup or Click and Collect. Note: At this time, In-Store Pickup as a fulfillment method is only available to a limited number of large retail merchants in the US, Canada, UK, Germany, and Australia marketplaces, and can only be applied to multiple-quantity, fixed-price listings. The Click and Collect feature is only available to large merchants on the UK, Australia, and Germany marketplaces. For Add/Revise/Relist/Verify calls: this field is included to enable the listing for In-Store Pickup. To enable the listing for In-Store Pickup, the seller includes this boolean field and sets its value to <code>true</code>. In-Store Pickup as a fulfillment method is only available to a limited number of large retail merchants in the US, Canada, UK, Germany, and Australia marketplaces. The In-Store Pickup feature can only be applied to multiple-quantity, fixed-price listings. In addition to setting the EligibleForPickupInStore boolean field to <code>true</code>, the merchant must also perform the following actions in an Add/Revise/Relist/Verify call to enable the In-Store Pickup option on a multiple-quantity, fixed-price listing: <ul> <li>Have inventory for the product at one or more physical stores tied to the seller's account. By using the REST-based Inventory API, sellers can associate physical stores to their account by using the Create Inventory Location call, and then, using the Create Inventory Item call, they can add inventory to specific stores;</li> <li>Include the seller-defined SKU value of the product(s) in the call request. For a single-variation listing, the SKU value would be specified in the Item.SKU field, and for a multiple-variation listing, the SKU value(s) would be specified in the Item.Variations.Variation.SKU field(s);</li> <li>Set an immediate payment requirement on the item. </li> </ul> When a seller is successful at listing an item with the In-Store Pickup feature enabled, prospective buyers within a reasonable distance (25 miles or so) from one of the seller's stores (that has stock available) will see the "Available for In-Store Pickup" option on the listing, along with information on the closest store that has the item. This field is returned in the 'Get' calls if the listing is enabled with the In-Store Pickup feature. false AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetSellerList GetItemShipping GetItem Conditionally For sellers opted in to Click and Collect, this field was once used to set Click and Collect eligibility at the listing level. However, now the seller can only opt in to Click and Collect at the account level, and then each of their listings will be automatically evaluated by eBay for Click and Collect eligibility. Note: Until this field is fully deprecated in the Trading WSDL (and in Add/Revise/Relist/Verify calls), it can still be used, but it will have no functional affect. However, if set in an Add/Revise/Relist/Verify call, it will get returned in GetItem, but it won't be a true indicator if the item is actually available for the Click and Collect fulfillment method. Instead, the Item.AvailableForPickupDropOff field should be referenced to see if the listing actually has inventory that is available for pickup via the Click and Collect fulfillment method. GetSellerList GetItemShipping GetItem Conditionally Simple type defining all possible local pickup methods for buyers. A PickupMethodCodeType value is always returned under the PickupOptions and PickupMethodSelected containers. This value indicates that the buyer will pick up the In-Store Pickup item at the merchant's physical store. Note: A merchant must be eligible for the In-Store Pickup feature to list an item that is eligible for In-Store Pickup. At this time, the In-Store Pickup feature is generally only available to large retail merchants in US, and can only be applied to multi-quantity, fixed-price listings. This value indicates that the buyer will pick up the "Click and Collect" item at the merchant's physical store. Note: A merchant must be eligible for the "Click and Collect" feature to list an item that is eligible for "Click and Collect". At this time, the "Click and Collect" feature is only available to large merchants on the eBay UK (site ID - 3), eBay Australia (Site ID - 15), and eBay Germany (Site ID - 77) sites. sites. Reserved for internal or future use. Type defining the PickupMethodSelected container, which consists of details related to the selected local pickup method (In-Store Pickup or "Click and Collect"), including the pickup method, the merchant's store ID, the status of the pickup, and the pickup reference code (if provided by merchant). Note: At this time, the In-Store Pickup feature is generally only available to large retail merchants in US, and can only be applied to multi-quantity, fixed-price listings. The "Click and Collect" feature is only available to large merchants on the eBay UK (site ID - 3), eBay Australia (Site ID - 15), and eBay Germany (Site ID - 77) sites. This value indicates the local pickup method that was selected by the buyer at checkout. This field is always returned with the PickupMethodSelected container. Note: Merchants must be eligible for the In-Store Pickup or "Click and Collect" feature to list items that are eligible for these local pickup methods. PickupMethodCodeType GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally The unique identifier of the merchant's store where the item will be picked up. The PickupStoreID is picked up by eBay based on the LocationID value that is set by the merchant in the Inventory Management API. This field is always returned with the PickupMethodSelected container. Note: A seller must be eligible for the In-Store Pickup feature to list an item that is eligible for In-Store Pickup. At this time, the In-Store Pickup feature is generally only available to large retail merchants in US, and can only be applied to multi-quantity, fixed-price listings. Merchants/developers can test In-Store Pickup functionality in the Sandbox environment, including listing items enabled with the In-Store Pickup feature, creating store locations and adding inventory to these stores using the Inventory Management API, and informing eBay of In-Store Pickup status changes using the Inbound Notifications API. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally This field indicates the current status of the local pickup order. The value of the PickupStatus field can change during the lifecycle of the order based on the notifications that a merchant sends to eBay through the Inbound Notifications API. This field is always returned with the PickupMethodSelected container. Note: A seller must be eligible for the In-Store Pickup or Click and Collect features to list an item that is eligible for these features. At this time, these features are generally only available to large retail merchants in US, and can only be applied to multi-quantity, fixed-price listings. Merchants/developers can test In-Store Pickup functionality in the Sandbox environment, including listing items enabled with the In-Store Pickup feature, creating store locations and adding inventory to these stores using the Inventory Management API, and informing eBay of In-Store Pickup status changes using the Inbound Notifications API. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally The unique reference number defined by the merchant to track In-Store Pickup orders. The MerchantPickupCode is picked up by eBay if it is set by the merchant through the payload of a notification sent to eBay through the Inbound Notifications API. This field is only returned with the PickupMethodSelected container if it set by the merchant. For GetOrders and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the real reference number is only returned to the buyer or seller, and a string value of <code>Unavailable</code> will be returned to all third parties. Note: A seller must be eligible for the In-Store Pickup feature to list an item that is eligible for In-Store Pickup. At this time, the In-Store Pickup feature is generally only available to large retail merchants in US, and can only be applied to multi-quantity, fixed-price listings. Merchants/developers can test In-Store Pickup functionality in the Sandbox environment, including listing items enabled with the In-Store Pickup feature, creating store locations and adding inventory to these stores using the Inventory Management API, and informing eBay of In-Store Pickup status changes using the Inbound Notifications API. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally Timestamp indicating the date/time when the order is expected to be fulfilled by the merchant and available for pick up by the buyer. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The unique identifier of the merchant's store where the "Click and Collect" item will be picked up. This field will only be returned if supplied by the merchant. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally Type defining the PickupOptions container, which consists of a pickup method and the priority of the pickup method. Note: At this time, the In-Store Pickup and Click and Collect features are generally only available to large retail merchants in US, and can only be applied to multi-quantity, fixed-price listings. This value indicates an available pickup method. This field is always returned with the PickupOptions container. Note: At this time, 'InStorePickup' and 'PickUpDropOff' are the only available pickup methods; however, additional pickup methods may be added to the list in future releases. Note: A seller must be eligible for the In-Store Pickup or Click and Collect feature to list an item that is eligible for In-Store Pickup or Click and Collect. At this time, In-Store Pickup is generally only available to large retail merchants in US, and the 'Click and Collect' feature is only available to large merchants on the eBay UK (site ID - 3), eBay Australia (Site ID - 15), and eBay Germany (Site ID - 77) sites. PickupMethodCodeType GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally This integer value indicates the priority of the pickup method. The priority of each pickup method controls the order (relative to other pickup methods) in which the corresponding pickup method will appear in the View Item and Checkout page. This field is always returned with the PickupOptions container. Note: A seller must be eligible for the In-Store Pickup or Click and Collect features to list an item that is eligible for In-Store Pickup or Click and Collect. At this time, In-Store Pickup is generally only available to large retail merchants in US, and the 'Click and Collect' feature is only available to large merchants on the eBay UK (site ID - 3), eBay Australia (Site ID - 15), and eBay Germany (Site ID - 77) sites. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally Simple type defining all possible states for an In-Store Pickup order. The value of the PickupStatus field (returned under the PickupMethodSelected container) can change during the lifecycle of the order based on the notifications that a merchant sends to eBay through the Inbound Notifications API. Note: At this time, the In-Store Pickup feature is generally only available to large retail merchants in US, and can only be applied to multi-quantity, fixed-price listings. This value indicates that the current status value of the In-Store Pickup order is invalid. This value indicates that the current status value of the In-Store Pickup order is not applicable. This status indicates that the In-Store Pickup order has yet to be acknowledged by the merchant. This is typically the state before the merchant sends the ORDER.READY_FOR_PICKUP notification to eBay through the Inbound Notifications API. This status indicates that the In-Store Pickup order is ready to be picked up by the buyer. This state occurs after the merchant sends the ORDER.READY_FOR_PICKUP notification to eBay through the Inbound Notifications API. This status indicates that the In-Store Pickup order has been picked up by the buyer. This state occurs after the merchant sends the ORDER.PICKEDUP notification to eBay through the Inbound Notifications API. This status indicates that the In-Store Pickup order has been cancelled by the merchant, because the product was out of stock. This state occurs after the merchant sends the ORDER.PICKUP_CANCELED notification (with the CANCEL_TYPE parameter in the notification payload set to "OUT_OF_STOCK") to eBay through the Inbound Notifications API. This status indicates that the In-Store Pickup order has been cancelled by the merchant, because the buyer rejected the item. This state occurs after the merchant sends the ORDER.PICKUP_CANCELED notification (with the CANCEL_TYPE parameter in the notification payload set to "BUYER_REJECTED") to eBay through the Inbound Notifications API. This status indicates that the In-Store Pickup order has been cancelled by the merchant, because the buyer never showed up to pick up the item. This state occurs after the merchant sends the ORDER.PICKUP_CANCELED notification (with the CANCEL_TYPE parameter in the notification payload set to "BUYER_NO_SHOW") to eBay through the Inbound Notifications API. This status indicates that the In-Store Pickup order has been cancelled, and the exact reason is not available. This value is reserved for internal or future use. Type defining the Pictogram container used at the listing level to provide pictograms for the listing. This field sets the pictogram code(s) for Hazard and product safety Pictogram(s) for the listing. If your product contains hazardous substances or mixtures, please select the values corresponding to the hazard pictograms that are stated on your product's Safety Data Sheet. The selected hazard information will be displayed on your listing. If your product shows universal product safety or compliance symbols, please select the values corresponding to the product safety pictograms for display in the product safety section of the listing. The seller specifies the identifier of each pictogram in this field. A separate Pictogram field is required for each Hazard or product safety pictogram. Note: For Hazard pictograms, use the <a href="https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getHazardousMaterialsLabels">getHazardousMaterialsLabels</a> method in the <a href="https://developer.ebay.com/api-docs/sell/metadata/resources/methods">Metadata API</a> to find supported values for a specific marketplace/site. For sample values, see <a href="https://developer.ebay.com/api-docs/sell/static/metadata/feature-regulatorhazmatcontainer.html#Pictogra" target="_blank">Pictogram sample values</a>. For product safety pictograms, use the <a href = "/api-docs/sell/metadata/resources/marketplace/methods/getProductSafetyLabels" target="_blank">getProductSafetyLabels</a> method in the <a href="https://developer.ebay.com/api-docs/sell/metadata/resources/methods">Metadata API</a> to find supported values for a specific marketplace/site. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally Contains the data for the pictures associated with an item. <a name="galleryTypeField"></a> This field is used to specify the type of picture gallery to use for the listing. If this field is omitted, a standard picture gallery is used for the listing. There is no listing fee for a standard picture gallery. To use the Gallery Plus feature, you must include this field and set its value to <code>Plus</code>. The Gallery image will be the first URL passed into the first PictureURL field, so if you want a specific picture to be the Gallery image, you should make sure you pass the URL for this picture in the first PictureURL field. When revising a listing, if you disable the Gallery Plus feature by including the GalleryType field and setting its value to <code>Gallery</code>, the original feature fee for this feature will not be credited to the seller. Gallery AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Gallery AddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem VerifyAddFixedPriceItem No This field shows the URL for the gallery image of an item returned in GetMyeBayBuying and GetMyeBaySelling. 1024 GetMyeBayBuying BestOfferList BidList SecondChanceOffer WatchList LostList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally The PictureURL field contains a picture URL of the item, which can be sourced from eBay Picture Services (EPS-hosted) or an external server (self-hosted). A listing can include up to 24 picture URLs, but these URLs cannot be mixed between self-hosted and EPS-hosted within the same listing. Use the UploadSiteHostedPictures call to upload images to EPS. All URLs must use the 'https' protocol; URLs using the 'http' protocol are not permitted. Sellers can have up to 24 pictures in almost any category at no cost. Motor vehicle listings are an exception. The number of included pictures in motor vehicle listings depend on the selected vehicle package (see <a href="https://www.ebay.com/help/selling/fees-credits-invoices/motors-fees?id=4127">Fees for selling vehicles on eBay Motors</a>). Note: If a URL contains spaces, those spaces can be replaced with <code>%20</code>. For example, <code>https://example.com/my image.jpg</code> must be submitted as <code>https://example.com/my%20image.jpg</code> to replace the space in the image file name. However, a semicolon character (;) cannot be replaced with <code>%20</code>, so a semicolon cannot be a part of the URL, as an error will occur. The Gallery image will be the first PictureURL in the array of PictureURL fields. Note: All images, whether they are hosted by EPS or self-hosted, must comply with eBay picture requirements, including the requirement that all images must be at least 500 pixels on its longest side. If the image does not satisfy the 500 pixels requirement, the listing may be blocked. For more information about other requirements and tips for adding pictures to listings, see the <a href="https://www.ebay.com/help/selling/listings/adding-pictures-listings?id=4148">Adding pictures to your listings</a> help page. To specify multiple pictures, send each URL in a separate, PictureDetails.PictureURL element. The first URL passed in defaults to be the 'gallery image', and will be the first picture that is shown when a user lands on the View Item page. Note: The total length of all PictureURL values associated with a listing must not exceed 3975 characters. If a listing uses a single, self-hosted picture (except in the case of a multiple-variation listing), the picture will be copied to eBay Picture Services (EPS) and the PictureDetails.PictureURL value returned by GetItem will be an EPS URL. For VerifyAddItem only: You must include a picture even when using VerifyAddItem. If you don't have a image file, you can use the following fake eBay Picture Services URL (https://i2.ebayimg.com/abc/M28/dummy.jpg) with this call. For ReviseItem and RelistItem only: To remove a picture when revising or relisting an item, specify PictureDetails with all the pictures that you want the listing to include. That is, you need to completely replace the original set of URLs with the revised set. You cannot remove all the PictureURL fields from a listing because each listing requires at least one picture. Remember: The 'gallery image' will be the first PictureURL in the array of PictureURL fields. So, if the first image passed in when relisting/revising is different from when the listing was created, the 'gallery image' will be changed. Note: For some large merchants, there are no limitations on when pictures can be added or removed from a fixed-price listing, even when the listing has had transactions or is set to end within 12 hours. 500 per URL, 3975 for all specified URLs AddItem AddItems RelistItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ReturnAll

24 AddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem VerifyAddFixedPriceItem Conditionally Add pictures https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/pictures.html The value in this field indicates if the listing contains image files uploaded to the eBay Picture Server (EPS), or externally-hosted images for which eBay created EPS equivalents. This value defaults to <code>EPS</code>, so if a seller is going to upload externally-hosted image URLs, this field must be included and set to <code>Vendor</code>. Note: Original EPS and externally-hosted images cannot be mixed, so this value cannot be changed if a listing already has one or more images. GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally EPS AddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem VerifyAddFixedPriceItem No Indicates if the gallery image upload failed and gives a reason for the failure, such as 'InvalidUrl' or 'ServerDown'. It is not returned if the gallery image is uploaded successfully. GetItem Conditionally Indicates the reason the gallery generation failed, such as, URL for the image is not valid. This field is returned when GalleryStatus field is returned and does not appear when the gallery generation is successful. 1024 GetItem Conditionally When returned this contains the original URL of a self-hosted pictures, associated with the item when the item was listed. 500 1 GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ReturnAll

Picture hosting https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/picture-hosting.html The ExtendedPictureDetails container and its child fields are no longer returned under any circumstances, including when self-hosted pictures are used for the item. When self-hosted pictures are used by the seller, only the external URL of the gallery image is shown in the PictureDetails.ExternalPictureURL field, and only the equivalent eBay Picture Server (EPS) URLs are shown for the rest of the item's images in separate PictureDetails.PictureURL fields. 1375 NotReturned PictureDetails.ExternalPictureURL GetItem Conditionally Indicates the format of the picture returned. Sometimes this is different than the format of the uploaded picture. Indicates the picture was returned in JPG format. Uploaded pictures in JPG, TIF, or BMP will be returned as JPG. Indicates the picture was returned in GIF format. Indicates the picture was returned in PNG format. Reserved for internal use only. Specifies whether to generate the 'standard' set of images for each picture or to also generate a super-sized image. Note: This type is used only for images that will be used in a listing. Large Indicates to generate the "Standard" set of images, which is a set of 7 images of various sizes, for each ExternalPictureURL submitted in the request. This is the default. Note: This field is used only for images that will be used in a listing. Indicates to generate the "Standard" set plus a super-sized image for each ExternalPictureURL submitted in the request. In order to include the super-sized image in the Add Item calls, you must also specify Item.PictureDetails.PhotoDisplay.Supersize or Item.PictureDetails.PhotoDisplay.PicturePack. Note: This field is used only for images that will be used in a listing. This field is no longer returned. Reserved for internal use only. URL and size information for each generated and stored picture. This data is provided for use in application previews of pictures. This data is used for display control for specific pictures in the generated imageset. This container is supplied for all generated pictures. URL for the picture. UploadSiteHostedPictures Always Height of the picture in pixels. UploadSiteHostedPictures Always Width of the picture in pixels. UploadSiteHostedPictures Always PictureManager Enumerated type used to specify where a listing's image(s) are hosted. This value indicates that the image(s) specified in the PictureURL field(s) are hosted by eBay Picture Services. This value is deprecated. This value indicates that the image(s) specified in the PictureURL field(s) are hosted by a third-party vendor. Note that if pictures are externally-hosted, they must be hosted on a site that is using the 'https' protocol. (out) Reserved for internal or future use. This container returns the URLs of the seller's self-hosted (hosted outside of eBay) pictures and the URL for the corresponding eBay Picture Services (EPS), that was generated when the picture was uploaded. The ExtendedPictureDetails container and its child fields are no longer returned under any circumstances, including when self-hosted pictures are used for the item. When self-hosted pictures are used by the seller, only the external URL of the gallery image is shown in the PictureDetails.ExternalPictureURL field, and only the equivalent eBay Picture Server (EPS) URLs are shown for the rest of the item's images in separate PictureDetails.PictureURL fields. 150 24 GetItem Conditionally

DetailLevel: none,ItemReturnDescription,ReturnAll

The ExtendedPictureDetails container and its child fields are no longer returned under any circumstances, including when self-hosted pictures are used for the item. When self-hosted pictures are used by the seller, only the external URL of the gallery image is shown in the PictureDetails.ExternalPictureURL field, and only the equivalent eBay Picture Server (EPS) URLs are shown for the rest of the item's images in separate PictureDetails.PictureURL fields. 150 GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ReturnAll

Values to be used in choosing that an uploaded picture is added to the available pictures on the eBay site. Specifies that an uploaded picture is added to the pictures available to a seller on the eBay site. Specifies, first, that all pictures available to a seller on the eBay site are removed, and then second, that the currently uploaded picture is made available to the seller. Reserved for internal use ONLY. Defines variation-specific pictures associated with one VariationSpecificName (e.g., Color) whose values differ across variations. One aspect of the variations that will be illustrated in the pictures for all variations. For example, if each variation is visually distinguished by color and the pictures show the different colors available, then specify "Color" as the name. The name must match one of the names specified in the VariationSpecifics container. This field is required in each Item.Variations.Pictures container that is used. 40 AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

A container consisting of one or more picture URLs associated with a variation specific value (e.g., color=blue). For example, suppose a listing contains blue and black color variations, and VariationSpecificName=Color. In this case, one picture set could contain pictures of the blue shirts (e.g., front view, back view, and close-up of a trim detail), and another picture set could contain pictures of the black shirts. A variation specific picture set can consist of up to 12 images hosted by eBay Picture Services (EPS) or self-hosted (hosted outside of eBay) pictures. The eBay Picture Services and self-hosted images can never be combined into the same variation specific picture set. At least one picture set is required if the Pictures node is present in the request. You are not required to provide pictures for all values that correspond to the variation specific name. For example, a listing could have pictures depicting the blue and black color variations, but not the pink variations. Note: All images must comply with the <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/pictures.html">Picture Requirements</a>. AddFixedPriceItem VerifyAddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This type is deprecated, as the maximum number of policy violations for a buyer is no longer a valid Buyer Requirement at the account or listing level. GeteBayDetails Conditionally 1065 NoOp 1065 1065 NoOp 1065 Specifies the criteria for filtering search results by site, where site is determined by the site ID in the request. (in) Items listed in the currency implied by the site specified in the request. (in) Items located in the country implied by the site specified in the request. (in) Items available to the country implied by the site specified in the request. For the US site, this implies listings from ALL English-language countries that are available to the US. (in) Items listed on the site specified in the request, regardless of listing currency. (in) Items located in Belgium or listed on one of the two Belgian sites. (out) Reserved for internal or future use. Indicates category support for listing of Local Market items by sellers subscribed to Local Market for Premium Vehicles. Each of the subscriptions will have following options, which will define "National" vs "Local" ad format listing. "LocalOptional" : This will allow national and local listing. "LocalOnly" : Seller can have Local listings only. "NationalOnly" : Seller can not opt into local only exposure. It has to be national listing. This enumerated type defines the available discount price treatments that can be set up by eligible sellers. This enumeration value indicates that Strikethrough Pricing is enabled for the order line item. If this value is returned, the price in the OriginalRetailPrice field will be crossed out in the View Item page. This enumeration value indicates that Minimum Advertised Pricing is enabled for the order line item. If this value is returned, the minimum advertised price is found in the MinimumAdvertisedPrice field. This enumeration value indicates that neither Strikethrough Pricing or Minimum Advertised Pricing is enabled for the order line item. This enumeration value indicates that Made For Outlet Comparison Pricing is enabled for the order line item. If this value is returned, the Made For Outlet Comparison price is found in the MadeForOutletComparisonPrice field. Reserved for future use. Note: This enumerated type is deprecated as the Pro Pack Bundle feature is no longer available on any eBay Marketplace sites. This value indicates that the Pro Pack listing upgrade is available for all sellers on the listing site. This value indicates that the Pro Pack listing upgrade is not available to any sellers on the listing site. This value indicates that the Pro Pack listing upgrade is only available to seller with Power Seller status on the listing site. This value indicates that the Pro Pack listing upgrade is only available to Top Rated sellers on the listing site. Reserved for internal or future use. Defines the ProPack feature (a feature pack). If the field is present, the corresponding feature applies to the category. The field is returned as an empty element (i.e., a boolean value is not returned). Defines the ProPackPlus feature (a feature pack). If the field is present, the corresponding feature applies to the category. The field is returned as an empty element (i.e., a boolean value is not returned). This type is deprecated. Disabled, Enabled, Required, CustomCode Product creation is not supported for the category. AddItem family calls can still list with product. Product Creation is supported for the category. AddItem family calls can still list with product but can go through new product creation flow. Product Creation is required for the category. AddItem family calls have to list with a product. If no product exists can go through new product creation flow. (out) Reserved for internal or future use. Defines the product creation enable feature. If a field of this type is present, the corresponding feature applies to the site. The field is returned as an empty element (e.g., a boolean value is not returned). This type defines the ProductDetails container that is returned in the GeteBayDetails response if the <code>ProductDetails</code> value is used in a DetailName field (or no DetailName fields are used). The ProductDetails container shows the substitute text that can be used in place of an actual product identifier (e.g. EAN, ISBNs, UPC, or MPN) in case the product does not have a product identifier and/or the product identifier is not known by the seller. This field contains the actual text that should be passed into the relevant product identifier fields (e.g. ProductListingDetails.UPC in an AddItem call) when creating a listing. Some eBay categories require one or more Global Trade Item Numbers (GTINs), so either the actual GTIN or this substitute text must be passed into the relevant fields. GeteBayDetails Conditionally This enumeration type contains the values that may be returned in the EANEnabled, ISBNEnabled, and UPCEnabled fields at the site level (SiteDefaults container) and category level (Category nodes) to indicate which sites and categories support, require, or do not support the use of product identifiers to help create a listing. This enumeration value indicates that a product identifier (EAN, ISBN, UPC) may not be used to help create a listing. If returned at the site level (SiteDefaults container), most categories on the site (specified in the X-EBAY-API-SITEID) do not support the use of product identifiers. If returned at the category level (Category nodes), that specific category does not support the use of product identifiers. This enumeration value indicates that a product identifier (EAN, ISBN, UPC) may be used to help create a listing. If returned at the site level (SiteDefaults container), most categories on the site (specified in the X-EBAY-API-SITEID) support the use of product identifiers. If returned at the category level (Category nodes), that specific category supports the use of product identifiers. This enumeration value indicates that a product identifier (EAN, ISBN, UPC) is required when creating a listing. If returned at the site level (SiteDefaults container), most categories on the site (specified in the X-EBAY-API-SITEID) require the use of product identifiers. If returned at the category level (Category nodes), that specific category requires the use of product identifiers when creating a listing. This value is for future use. Type used by the ProductListingDetails container, which is used by a seller in an add/revise/relist call to identify a product through a Global Trade Item Number (EAN, ISBN, or UPC) or an eBay Product ID (e.g. 'ePID'). If a specified product identifier is matched to a product in the eBay catalog, some of the details for the product listing, such as listing category, product title, product description, product aspects, and stock photo are prefilled for the listing. Note: If a Brand/MPN pair is required for the product, these values must still be input through the BrandMPN container. If this value is <code>true</code>, the listing will use the eBay catalog product's stock photo. In an Add/Revise/Relist call, this field is set to <code>true</code> by default. If you will be using an eBay catalog product to list your item, it is always advised to include the stock photo. Sellers can also add their own pictures using one or more Item.PictureDetails.PictureURL fields. Seller photos are particularly recommended for used and modified products to give prospective buyers a clear sense of exactly what they are purchasing. In GetItem and other 'Get' calls, the URL of the stock photo will be returned in the StockPhotoURL field. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No true GetBidderList Conditionally GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally Using eBay stock photos https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/stock-photos.html If this value is <code>true</code>, the listing will use the eBay catalog product's stock photo as the Gallery thumbnail photo. In an Add/Revise/Relist call, this field is set to <code>true</code> by default. If this field is set to <code>true</code>, the IncludeStockPhotoURL field must also be set to <code>true</code> or this field will have no effect. Sellers can also add their own pictures using one or more Item.PictureDetails.PictureURL fields, but none of these photos will be the Gallery thumbnail photo. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No true GetBidderList Conditionally GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/stock-photos.html#gallery Stock photo as gallery image The full URL for the eBay catalog product's stock photo. This field is only returned if the seller used an eBay catalog product to list the item, and the IncludeStockPhotoURL field was set to <code>true</code>. GetBidderList Conditionally GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally Copyright statement indicating the source of the product information. This information will be included in the listing if the seller used an eBay catalog product to list the item. GetBidderList Conditionally GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally In an Add/Revise/Relist call, this field is used to pass in the eBay Product ID (e.g. ePID), which is the unique identifier of an eBay catalog product. Although an eBay catalog product match can be found using one or more GTIN values, passing in an ePID value is the best way to try and discover the appropriate eBay catalog product. This field is also returned in GetItem if the listing is associated with a eBay catalog product. 38 (42 with "EPID") AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This field is no longer applicable and should not be used. This field is no longer applicable and should not be used. If the seller attempts to use ProductListingDetails in an Add/Revise/Relist call to find an eBay catalog product match, and multiple matches are found, the call will actually fail. This field can be included and set to <code>true</code> if the seller wants to see the eBay catalog products that were found through error messages in the call response. This flag will not have an effect if only one catalog product match is found, or if the UseFirstProduct field is used and set to <code>true</code> and a catalog product is found to create/revise the listing. If this field is omitted or set to <code>false</code>, and multiple catalog products are found, the call will fail and no information about the matching catalog products will be returned. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No false This field is used if the seller wants to, or is required to identify a product using an ISBN (International Standard Book Number) value. An ISBN is a unique identifer for books. Both 10 and 13-character ISBNs are supported. When specifying a 13-character ISBN, the value must begin with either '978' or '979'. The seller can use the GetCategoryFeatures call to see if an ISBN is supported/required for a category. If the IncludeeBayProductDetails field is omitted or included and set to <code>true</code>, eBay will use the ISBN value passed into this field to try and find a matching eBay catalog product. If a match is found, the listing will pick up the product details of the catalog product, including the product title, product description, item specifics, and stock photo. If the seller is passing in an ePID through the ProductReferenceID field, this field is not needed, as all product identifiers will get picked up automatically by the listing if a matching catalog product is found. This field is only applicable for single-variation listings. For multiple-variation listings, if the category/product requires an ISBN value, this value should be passed into the Variation.VariationProductListingDetails.ISBN field instead. Note: If the listing is being posted to a category that expects an ISBN value, but one doesn't exist for the product, the seller must provide a string indicating that the product identifier is unavailable. This text varies by marketplace. Refer to <a href="https://developer.ebay.com/api-docs/sell/static/inventory/product-identifier-text.html" target="_blank">Product Identifier Text</a> for the specific text based on the listing marketplace. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally This field is used if the seller wants to, or is required to identify a product using a UPC (Universal Product Code) value. A UPC is a commonly used identifer for many different products. The seller can use the GetCategoryFeatures call to see if a UPC is supported/required for a category. Note: The UPC (and UPC values) are typically only applicable to US products listed on US eBay marketplace. If a European seller is selling a European-based product (with an EAN value) on the US site, instead of using the EAN field, the seller will use the UPC field to pass in the EAN value. If the IncludeeBayProductDetails field is omitted or included and set to <code>true</code>, eBay will use the UPC value passed into this field to try and find a matching eBay catalog product. If a match is found, the listing will pick up the product details of the catalog product, including the product title, product description, item specifics, and stock photo. If the seller is passing in an ePID through the ProductReferenceID field, this field is not needed, as all product identifiers will get picked up automatically by the listing if a matching catalog product is found. This field is only applicable for single-variation listings. For multiple-variation listings, if the category/product requires a UPC value, this value should be passed into the Variation.VariationProductListingDetails.UPC field instead. Note: If the listing is being posted to a category that expects a UPC value, but one doesn't exist for the product, the seller must provide a string indicating that the product identifier is unavailable. This text varies by marketplace. Refer to <a href="https://developer.ebay.com/api-docs/sell/static/inventory/product-identifier-text.html" target="_blank">Product Identifier Text</a> for the specific text based on the listing marketplace. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally This field is used if the seller wants to, or is required to identify a product using an EAN (European Article Number) value. An EAN is a unique 8 or 13-digit identifier that many industries (such as book publishers) use to identify products. The seller can use the GetCategoryFeatures call to see if an EAN is supported/required for a category. Note: The EAN (and EAN values) are typically only applicable to European products listed on European eBay marketplaces. If a US seller is selling a US-based product (with a UPC value) on a European site (such as eBay UK), instead of using the UPC field, the seller will use the EAN field to pass in the UPC value. If the IncludeeBayProductDetails field is omitted or included and set to <code>true</code>, eBay will use the EAN value passed into this field to try and find a matching eBay catalog product. If a match is found, the listing will pick up the product details of the catalog product, including the product title, product description, item specifics, and stock photo. If the seller is passing in an ePID through the ProductReferenceID field, this field is not needed, as all product identifiers will get picked up automatically by the listing if a matching catalog product is found. This field is only applicable for single-variation listings. For multiple-variation listings, if the category/product requires an EAN value, this value should be passed into the Variation.VariationProductListingDetails.EAN field instead. Note: If the listing is being posted to a category that requires an EAN value, but one doesn't exist for the product, the seller must provide a string indicating that the product identifier is unavailable. This text varies by marketplace. Refer to <a href="https://developer.ebay.com/api-docs/sell/static/inventory/product-identifier-text.html" target="_blank">Product Identifier Text</a> for the specific text based on the listing marketplace. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally This container is used if the seller wants to, or is required to identify a product using an Brand/Manufacturer Part Number (MPN) pair. The seller can use the GetCategoryFeatures call to see if a Brand/MPN pair is supported/required for a category. Both the Brand and MPN fields are required if the category/product requires an MPN value. If the IncludeeBayProductDetails field is omitted or included and set to <code>true</code>, eBay will use the Brand/MPN pair to try and find a matching eBay catalog product. If a match is found, the listing will pick up the product details of the catalog product, including the product title, product description, item specifics, and stock photo. If the seller is passing in an ePID through the ProductReferenceID field, this field is not needed, as all product identifiers associated with the catalog product will get picked up automatically by the listing if a matching catalog product is found. This container is only applicable for single-variation listings. For multiple-variation listings, if the category requires Brand/MPN pairs, the product brand (shared by all variations in this listing) is passed in through the item-level item specifics (Item.ItemSpecifics.NameValueList), and the MPN value for each variation in the listing is passed in through the variation-level item specifics (Variation.VariationSpecifics.NameValueList). Note: If the listing is being posted to a category that requires or recommends a Brand and MPN value, the Brand and MPN values for the product should always be passed in through separate ItemSpecifics.NameValueList containers since the Brand and MPN values passed in through the ProductListingDetails.BrandMPN will not get picked up by the generated/revised listing unless the the Brand/MPN pair is successfully matched to an eBay catalog product. If an MPN doesn't exist for a product, the seller must provide a string indicating that the product identifier is unavailable. This text varies by marketplace. Refer to <a href="https://developer.ebay.com/api-docs/sell/static/inventory/product-identifier-text.html" target="_blank">Product Identifier Text</a> for the specific text based on the listing marketplace. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally This field can be included and set to <code>true</code> if the seller wants to use the first eBay catalog product that is found to create/revise the listing. eBay will search for an eBay catalog product match if the seller provides an ePID or one or more GTIN values. If this field is omitted, or included and set to <code>false</code>, the call will fail if more than one eBay catalog product is found. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No false This boolean field controls whether or not an eBay catalog product is used to create or revise a listing. If an ePID or GTIN value is provided through the ProductListingDetails container when adding, revising, or relisting an item, the default behavior is for eBay to try and find a match for the product in the eBay catalog, and then automatically create/revise the listing using the product title, product description, item specifics, and stock photo defined for the catalog product. If the seller wants to use an eBay catalog product to create/revise a listing, the seller can include this field and set its value to <code>true</code>, or just omit this field, as its default value is <code>true</code>. If a seller doesn't want use an eBay catalog product to create/revise their listing, this field should be included and set to <code>false</code>. If the seller declines to use an eBay catalog product, they will be required to pass in their own listing title, listing description, item specifics, a listing category, and at least one picture. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No true GetBidderList Conditionally GetItem

DetailLevel: ItemReturnAttributes, ReturnAll

Conditionally This container is for future use. If it used, it will be ignored. This enumerated type is used by the ProductRequiredEnabled field that can be returned under the SiteDefaults and/or Category containers of a GetCategoryFeatures response. Note: Due to the rollback of the Product-Based Shopping Experience mandate for all eBay categories, the ProductRequiredEnabled field no longer has any practical use since it will show as Disabled for SiteDefaults and all Category nodes. Due to this fact, the ProductRequiredEnabledCodeType is currently not applicable. This value indicates that the category does not require product-based listings (associated with an eBay catalog product). Note: Due to the rollback of the Product-Based Shopping Experience mandate for all eBay categories, this value should get returned for SiteDefaults and all Category nodes. This value indicates that the category requires listings within the category to be associated with an eBay catalog product. Note: Due to the rollback of the Product-Based Shopping Experience mandate for all eBay categories, this value should never get returned for SiteDefaults or for any Category nodes. (out) Reserved for internal or future use. Type defining the ProductRequiredEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as ProductRequiredEnabled is included as a <a href="types/FeatureIDCodeType.html">FeatureID</a> value in the call request or no FeatureID values are passed into the call request). The ProductRequiredEnabled field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the Product-Based Shopping Experience. Note: Due to the rollback of the Product-Based Shopping Experience mandate for all eBay categories, the FeatureDefinitions.ProductRequiredEnabled field no longer has any practical use. Due to this fact, the ProductRequiredEnabledDefinitionType is currently not applicable. Type defining the Pictograms and Statements containers, and the Component field, that provide product safety and compliance related information. Note: As a part of General Product Safety Regulation (GPSR) requirements effective on December 13th, 2024, sellers sellers operating in, or shipping to, EU-based countries or Northern Ireland are conditionally required to provide product safety and compliance information in their eBay listings. For more information on GPSR, see <a href = "https://www.ebay.com/sellercenter/resources/general-product-safety-regulation" target="_blank">General Product Safety Regulation (GPSR)</a>. This container is used by the seller to provide product safety pictograms for the listing. This field is conditionally required if product safety information is supplied. Note: When supplying product safety information, one of the following elements is required: Pictograms or Statements. Both elements can be included on a listing, but only one is required. A maximum of 2 pictograms are allowed for product safety. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally This container is used by the seller to provide product safety statements for the listing. This field is conditionally required if product safety information is supplied. Note: When supplying product safety information, one of the following elements is required: Pictograms or Statements. Both elements can be included on a listing, but only one is required. A maximum of 8 statements are allowed for product safety. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally This field is used by the seller to provide product safety component information for the listing. For example, component information can include specific warnings related to product safety, such as 'Tipping hazard'. This field is optional for Product Safety. Note: Component information can only be specified if used with the Pictograms and/or Statements field; if the component is provided without one or both of these fields, an error will occur. 50 characters for this field AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem GetItems Conditionally Identifies an individual product suggestion. The product details include the EPID, Title, Stock photo url and if it is an exact match. The title of the product from the eBay catalog. 80 AddFixedPriceItem AddItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally The product reference Id of the product The eBay Product ID, a global reference ID for an eBay catalog product. The ePID is a fixed reference to a product (regardless of version). AddFixedPriceItem AddItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally Fully qualified URL for a stock image (if any) that is associated with the eBay catalog product. The URL is for the image eBay usually displays in product search results (usually 70px tall). It may be helpful to calculate the dimensions of the photo programmatically before displaying it. AddFixedPriceItem AddItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally If true, indicates that the product is an exact match, suitable for listing the item. AddFixedPriceItem AddItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally Provides a list of products recommended by eBay, which match the item information provided by the seller. Contains details for one or more individual product suggestions. The product details include the EPID, Title, Stock photo url and whether or not the product is an exact match for the submitted item. This product information can be used to list subsequent items. AddFixedPriceItem AddItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyRelistItem Conditionally Enumerated type that defines the category group values. Business Policies profiles (Payment, Shipping, and Return Policy) are linked to category groups. Default value. None. For Business Policies, the 'ALL' enumeration value represents all eBay categories except for motor vehicles. For Business Policies, the 'MOTORS_VEHICLE' enumeration value represents all motor vehicle categories. Type defining the PaymentProfileCategoryGroup, ReturnPolicyProfileCategoryGroup, and ShippingProfileCategoryGroup fields, which are all returned in the GetCategoryFeature response if these Business Policies profile types apply to the category. Each of these fields is returned as an empty element. If a seller has reduced the price of a listed item with the Promotional Price Display feature, this type contains the original price of the discounted item and other information. Original price of an item whose price a seller has reduced with the Promotional Price Display feature. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WatchList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList

DetailLevel: none, ReturnAll

Conditionally Start time of a discount for an item whose price a seller has reduced with the Promotional Price Display feature. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WatchList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList

DetailLevel: none, ReturnAll

Conditionally End time of a discount for an item whose price a seller has reduced with the Promotional Price Display feature. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WatchList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList

DetailLevel: none, ReturnAll

Conditionally Details of a promotional shipping discount. The type of promotional shipping discount that is detailed in the profile. If the discount type is <code>MaximumShippingCostPerOrder</code>, see ShippingCost. If the discount type is <code>ShippingCostXForAmountY</code>, see ShippingCost and OrderAmount. If the discount type is <code>ShippingCostXForItemCountN</code>, see ShippingCost and ItemCount. GetShippingDiscountProfiles MaximumShippingCostPerOrder, ShippingCostXForAmountY, ShippingCostXForItemCountN Conditionally SetShippingDiscountProfiles MaximumShippingCostPerOrder, ShippingCostXForAmountY, ShippingCostXForItemCountN Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

MaximumShippingCostPerOrder, ShippingCostXForAmountY, ShippingCostXForItemCountN Conditionally This is shipping cost X when DiscountName is either <code>ShippingCostXForAmountY</code> or <code>ShippingCostXForItemCountN</code>, and is the maximum cost when DiscountName is <code>MaximumShippingCostPerOrder</code>. GetShippingDiscountProfiles Conditionally SetShippingDiscountProfiles Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This is the cost Y of the order (not including shipping cost) when DiscountName is set to <code>ShippingCostXForAmountY</code>. GetShippingDiscountProfiles Conditionally SetShippingDiscountProfiles Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This is the number of items when DiscountName is set to <code>ShippingCostXForItemsY</code>. GetShippingDiscountProfiles Conditionally SetShippingDiscountProfiles Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Contains a seller's preference for sending a "Payment Reminder Email" to buyers. If true, a payment reminder Email is sent to buyers. GetUserPreferences Conditionally SetUserPreferences No Indicates the text message type of the item's quantity availability. (out) The message "Limited quantity available" is shown in the web flow (e.g., for a flash sale or a Daily Deal). (out) The message "More than 10 available" is shown in the web flow. 10 is the value of QuantityThreshold tag based on the seller's preference. Reserved for internal or future use. Enumerated type used by the QuantityOperator field that is returned under the FavoriteSearch container in a GetMyeBayBuying call. The values in this type indicate how the quantity of the item that the prospective desires compares to the quantity available. This enumeration value indicates that the quantity sought (specified in Quantity field) is less than the quantity available (specified in TotalAvailable field). This enumeration value indicates that the quantity sought (specified in Quantity field) is less than or equal to the quantity available (specified in TotalAvailable field). This enumeration value indicates that the quantity sought (specified in Quantity field) is equal to the quantity available (specified in TotalAvailable field). This enumeration value indicates that the quantity sought (specified in Quantity field) is greater than the quantity available (specified in TotalAvailable field). This enumeration value indicates that the quantity sought (specified in Quantity field) is greater than or equal to the quantity available (specified in TotalAvailable field). Reserved for internal or future use. This type defines the QuantityRestrictionPerBuyer container, which is used by the seller to restrict the quantity of items that may be purchased by one buyer during the duration of a fixed-price listing (single or multi-variation). This integer value indicates the maximum quantity of items that a single buyer may purchase during the duration of a fixed-price listing (single or multi-variation). The buyer is blocked from the purchase if that buyer is attempting to purchase a quantity of items that will exceed this value. Previous purchases made by the buyer are taken into account. For example, if MaximumQuantity is set to '5' for an item listing, and Buyer1 purchases a quantity of three, Buyer1 is only allowed to purchase an additional quantity of two in subsequent orders on the same item listing. This field is required if the QuantityRestrictionPerBuyer container is used. 1 AddFixedPriceItem AddItem AddItems VerifyAddItem VerifyAddFixedPriceItem Conditionally RelistFixedPriceItem RelistItem VerifyRelistItem ReviseFixedPriceItem ReviseItem Conditionally Enumerated type used by the member messaging calls to indicate the type of question that was asked. This enumeration value indicates that a general question was asked about the order line item. This enumeration value indicates that a question about shipping the order line item was asked. This enumeration value indicates that a payment question was asked about the order line item. This enumeration value indicates that a question was asked about a shipment that involves multiple packages. This enumeration value indicates that question was asked about a customized subject. Reserved This enumeration value indicates that question does not have a subject. Reserved for future or internal use. This type is used to reference a seller's specific domestic and/or international shipping rate tables. Shipping rate tables allow sellers to configure specific shipping costs based on the shipping destinations and level of service (e.g. economy, standard, expedite, and one-day). Generally speaking, sellers want to use these shipping rate tables so they can charge a higher shipping cost to the buyer whenever shipping costs are higher for them as well. For example, shipping to Alaska or Hawaii is generally more expensive than shipping to any other of the 48 US states, or in regards to international shipping, shipping to some regions and countries are more expensive than others. Sellers configure domestic, international, and regional shipping rate tables in My eBay Shipping Preferences. To apply shipping rate tables, the shipping cost type must be flat-rate. For domestic shipping rate tables, the three supported domestic regions are Alaska & Hawaii, US Protectorates (e.g. Puerto Rico and Guam), and APO/FPO destinations, which are US military bases/locations outside of the continental US. In addition to setting one flat rate based on the destination and service level, the seller also has the option of adding an extra charge based on the weight of the shipping package, or they can add a surcharge instead. For international shipping rate tables, specific rates may be set up for any and all geographical regions and individual countries within those regions. Similar to domestic shipping rate tables, the seller has the option of adding an extra charge based on the weight of the shipping package. Sellers cannot add a surcharge for international shipping. Note: The capability to create and use multiple domestic and international shipping rate tables (up to 40 per seller account) has rolled out to the US, Australia, Canada (English and French), Italy, UK, and Germany sites. For other sites, only one domestic and one international shipping rate table may be set up per seller. Until the seller's account is updated with the new shipping rate tables in My eBay, the seller will continue to use the DomesticRateTable and InternationalRateTable tags and pass in <code>Default</code> as the value. Once the seller's account is updated with the new shipping rate tables in My eBay, the seller will be required to use the new DomesticRateTableId and InternationalRateTableId tags, and the DomesticRateTable and InternationalRateTable tags will not work. Note that shipping rate tables can also be applied to Shipping business policies that are applied against a listing. The new shipping rate tables have all of the functionality of the old shipping rate tables, plus the seller has access to all domestic regions and not just the special regions (such as Alaska & Hawaii, US Protectorates, and APO/FPO locations in US). This field is used in an Add/Revise/Relist/Verify call to apply the domestic shipping rate table to the listing. In all cases, sellers pass in a string value of <code>Default</code> to apply the domestic shipping rate table. The shipping rates and/or surcharges set up in the domestic shipping rate table will only be applicable based on the location of the buyer, and if that shipping service level is covered in one of the specified shipping service options in the listing. Basically, domestic shipping costs and surcharges are set in one or more ShippingServiceOptions containers in the listing, and based on the settings and costs in the domestic shipping rate table, these shipping costs and/or surcharges may be overridden based on the buyer's location. For example, if the buyer lives in Alaska, and the domestic shipping rate table has one or more shipping rates set up for the Alaska & Hawaii domestic region, the buyer will see these rates in the View Item page and not the rates/costs that are defined in the ShippingServiceOptions containers. If a seller is revising or relisting an item, the domestic shipping rate table can be unassociated from the listing by using the empty tag: <code><DomesticRateTable /></code> This field is returned in the 'Get' calls if a domestic rate table is being applied to the listing, and it is only returned for the seller who listed the item. Note: The capability to create and use multiple domestic and international shipping rate tables (up to 40 per seller account) has rolled out to the US, Australia, Canada (English and French), Italy, UK, and Germany sites. Currently, for sites other than the ones stated, only one domestic and one international shipping rate table may be set up per seller. Until the seller's account is updated with the new shipping rate tables in My eBay, the seller will continue to use the DomesticRateTable and InternationalRateTable tags and pass in <code>Default</code> as the value. Once the seller's account is updated with the new shipping rate tables in My eBay, the seller will be required to use the new DomesticRateTableId and InternationalRateTableId tags, and the DomesticRateTable and InternationalRateTable tags will not work. Note that shipping rate tables can also be applied to Shipping business policies that are applied against a listing. The new shipping rate tables have all of the functionality of the old shipping rate tables, plus the seller has access to all domestic regions and not just the special regions (such as Alaska & Hawaii, US Protectorates, and APO/FPO locations in US). 50 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Shipping rate tables https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-rate-tables.html more information on using shipping rate tables. This field is used in an Add/Revise/Relist/Verify call to apply the international shipping rate table to the listing. International shipping rate tables can be used only for items listed on the eBay US, UK, and DE sites. In all cases, sellers pass in a string value of <code>Default</code> to apply the international shipping rate table. The shipping rates set up in the international shipping rate table will only be applicable based on the location of the buyer, and if that shipping service level is covered in one of the specified international shipping service options in the listing. Basically, international shipping costs are set in one or more InternationalShippingServiceOption containers in the listing, and based on the settings and costs in the international shipping rate table, these shipping costs may be overridden based on the buyer's location. For example, if the buyer lives in Argentina, and the international shipping rate table has one or more shipping rates set up for the country of Argentina, the buyer will see these rates in the View Item page and not the rates/costs that are defined in the InternationalShippingServiceOption containers. If a seller is revising or relisting an item, the international shipping rate table can be unassociated from the listing by using the empty tag: <code><InternationalRateTable /></code> This field is returned in the 'Get' calls if an international rate table is being applied to the listing, and it is only returned for the seller who listed the item. Note: The capability to create and use multiple domestic and international shipping rate tables (up to 40 per seller account) has rolled out to the US, Australia, Canada (English and French), Italy, UK, and Germany sites. Currently, for sites other than the ones stated, only one domestic and one international shipping rate table may be set up per seller. Until the seller's account is updated with the new shipping rate tables in My eBay, the seller will continue to use the DomesticRateTable and InternationalRateTable tags and pass in <code>Default</code> as the value. Once the seller's account is updated with the new shipping rate tables in My eBay, the seller will be required to use the new DomesticRateTableId and InternationalRateTableId tags, and the DomesticRateTable and InternationalRateTable tags will not work. Note that shipping rate tables can also be applied to Shipping business policies that are applied against a listing. The new shipping rate tables have all of the functionality of the old shipping rate tables, plus the seller has access to all domestic regions and not just the special regions (such as Alaska & Hawaii, US Protectorates, and APO/FPO locations in US). 50 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Shipping rate tables https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-rate-tables.html more information on using shipping rate tables. Note: This field is only available for sellers on the US, Australia, Canada (English and French), Italy, UK, and Germany sites. The unique shipping rate identifiers that will be passed into this field can be retrieved using the getRateTables call of the Account API, or these identifiers can be viewed in the displayed URL when the seller selects a specific shipping rate table in the Shipping rate tables UI in My eBay. This field is included in an Add/Revise/Relist/Verify call if the seller wants to apply a customized domestic shipping rate table to the listing. The string value that is supplied in this field is the unique identifier of the shipping rate table. If the DomesticRateTableId field is used, the seller must make sure that the DomesticRateTable and InternationalRateTable fields are not used, as the old and new rate tables cannot be used together or an error will occur. In domestic shipping rate tables, sellers customize the flat-rate cost of shipping based on shipping destination (region/state/province) and shipping service level (one-day, expedited, standard, economy in US). In addition to setting one flat rate based on the destination and service level, the seller also has the option of adding an extra charge based on the weight of the shipping package, or they can add a surcharge instead. When using a Revise or Relist call, the seller must include the DomesticRateTableId field: <ul><li>To keep the current domestic shipping rate table, pass the same DomesticRateTableId.</li><li>To switch to a different table, pass the identifier of the desired domestic shipping rate table. </li><li>To remove the association, revise or relist the item and send an empty tag: <code><DomesticRateTableId /></code></li></ul> This field is returned in the 'Get' calls if a customized domestic rate table is being applied to the listing, and it is only returned for the seller who listed the item. Note: The capability to create and use multiple domestic and international shipping rate tables (up to 40 per seller account) has rolled out to the US, Australia, Canada (English and French), Italy, UK, and Germany sites. For other sites, only one domestic and one international shipping rate table may be set up per seller. Until the seller's account is updated with the new shipping rate tables in My eBay, the seller will continue to use the DomesticRateTable and InternationalRateTable tags and pass in <code>Default</code> as the value. Once the seller's account is updated with the new shipping rate tables in My eBay, the seller will be required to use the new DomesticRateTableId and InternationalRateTableId tags, and the DomesticRateTable and InternationalRateTable tags will not work. Note that shipping rate tables can also be applied to Shipping business policies that are applied against a listing. The new shipping rate tables have all of the functionality of the old shipping rate tables, plus the seller has access to all domestic regions and not just the special regions (such as Alaska & Hawaii, US Protectorates, and APO/FPO locations in US). 50 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Note: This field is only available to sellers on specific sites. See <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-rate-tables.html#marketplaces" target="_blank">Marketplace support</a> for a list of marketplaces that support International shipping rate tables. The unique shipping rate identifiers that will be passed into this field can be retrieved using the getRateTables call of the Account API, or these identifiers can be viewed in the displayed URL when the seller selects a specific shipping rate table in the Shipping rate tables UI in My eBay. This field is included in an Add/Revise/Relist/Verify call if the seller wants to apply a customized international shipping rate table to the listing. The string value that is supplied in this field is the unique identifier of the shipping rate table. If the InternationalRateTableId field is used, the seller must make sure that the DomesticRateTable and InternationalRateTable fields are not used, as the old and new rate tables cannot be used together or an error will occur. In international shipping rate tables, sellers customize the flat-rate cost of shipping based on shipping destination (continent/region/country) and shipping service level (expedited, standard, economy in US). In addition to setting one flat rate based on the destination and service level, the seller also has the option of adding an extra charge based on the weight of the shipping package. Unlike domestic shipping, sellers cannot add a surcharge for international shipping. When using a Revise or Relist call, the seller must include the InternationalRateTableId field: <ul><li>To keep the current international shipping rate table, pass the same InternationalRateTableId.</li><li>To switch to a different table, pass the identifier of the desired international shipping rate table. </li><li>To remove the association, revise or relist the item and send an empty tag: <code><InternationalRateTableId /></code></li></ul> This field is returned in the 'Get' calls if a customized international rate table is being applied to the listing, and it is only returned for the seller who listed the item. Note: The capability to create and use multiple domestic and international shipping rate tables (up to 40 per seller account) has rolled out to the US, Australia, Canada (English and French), Italy, UK, and Germany sites. For other sites, only one domestic and one international shipping rate table may be set up per seller. Until the seller's account is updated with the new shipping rate tables in My eBay, the seller will continue to use the DomesticRateTable and InternationalRateTable tags and pass in <code>Default</code> as the value. Once the seller's account is updated with the new shipping rate tables in My eBay, the seller will be required to use the new DomesticRateTableId and InternationalRateTableId tags, and the DomesticRateTable and InternationalRateTable tags will not work. Note that shipping rate tables can also be applied to Shipping business policies that are applied against a listing. The new shipping rate tables have all of the functionality of the old shipping rate tables, plus the seller has access to all domestic regions and not just the special regions (such as Alaska & Hawaii, US Protectorates, and APO/FPO locations in US). 50 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Enumerated type that defines the possible reasons why a listing is being hidden from search on the eBay site. This value indicates that the listing is being hidden from search on the eBay site because the listing has been determined by eBay to be a duplicate listing. This enumeration value is associated with eBay Duplicate Listings Policy, which is applicable on the US, CA, CA-FR, and eBay Motors (Parts and Accessories only) sites. Event Tickets, Real Estate, and Motor Vehicle categories are excluded from this policy. For more information, read <a href="http://pages.ebay.com/help/policies/listing-multi.html">eBay's Duplicate Listings Policy</a> help page. This value indicates that the listing is currently hidden from search because the quantity in the listing is zero. However, the listing is still alive and will reappear in the search results when the quantity is set to something greater than zero. The 'Out-of-stock' option is set by the seller at the account level. This option can be enabled in My eBay Site Preferences, or the seller can use the <a href="https://developer.ebay.com/DevZone/XML/docs/Reference/ebay/SetUserPreferences.html#Request.OutOfStockControlPreference">OutOfStockControlPreference</a> field in the SetUserPreferences call. Type used by the RecoupmentPolicyConsent container that is returned in the GetItem call response to indicate which sites the user (specified in UserID field of call request) has signed a cross-border trade Recoupment Policy Agreement. A unique identifier for an eBay site. Each site where the user (specified in UserID field of call request) has signed a cross-border trade Recoupment Policy Agreement is returned. The enumeration values that represent these eBay sites can be found in SiteCodeType. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This enumerated type contains the possible refund, exchange, or store credit options that a seller may offer the buyer as part of the return policy. Exchange, MerchandiseCredit This value indicates that the seller will refund the buyer the cost of the item, excluding shipping and handling costs. This value is deprecated since receiving money back must always be one of the options in a return policy and not just exchanging the item. If a seller wants to make an exchange one of the options, the <code>MoneyBackOrExchange</code> option should be used. This value is deprecated since receiving money back must always be one of the options in a return policy and not just store credit. Note: This value has been deprecated and US sellers that are willing to refund buyers or offer an identical replacement item should use the <code>MoneyBackOrReplacement</code> value instead. Note: This value is only available on the US site. US sellers should use this value if they are willing to refund buyers or offer an identical replacement item. This value indicates that the seller will refund the buyer the cost of the item (excluding shipping and handling costs) through eBay returns, or the seller will replace the returned item with another identical item if the buyer prefers this. Reserved for internal or future use. Type defining the ReturnPolicyDetails.Refund container that is returned in GeteBayDetails. All of the values (along with descriptions for each value) that can be used as a Refund Option when listing an item is returned under the ReturnPolicyDetails.Refund container. Note: The GeteBayDetails call returns site-default Return Policy settings. For most categories within a given eBay site, the supported Return Policy options/values are the same, but there a few exceptions. To discover what refund options that a particular category supports, call GetCategoryFeatures and include <code>DomesticRefundMethodValues</code> and/or <code>InternationalRefundMethodValues</code> as FeatureID values to see the refund options available for domestic and international returns, respectively. Indicates how the seller will compensate the buyer for a returned item. This value can be passed in the Add/Revise/Relist/VerifyAdd API calls. Currently, on the US site (and many other sites), the seller must offer either a MoneyBack or a MoneyBackOrExchange refund option. Consider using the MoneyBackOrExchange option when you have the depth of inventory to support replacement of the original item. Otherwise, use the MoneyBack option if you have limited inventory. RefundOptionsCodeType GeteBayDetails Conditionally Display string that applications can use to present RefundOption in a more user-friendly format (such as in a drop-down list). Not applicable as input to the AddItem family of calls. (Use RefundOption instead.) GeteBayDetails Conditionally Type defining the Refunds container, which contains an array of zero or more Refund objects, each with detailed refund information. This container consists of detailed information on an item refund. This container is only returned if the merchant is refunding (or providing a store credit) the buyer. A separate Refund container will be returned for each ORDER.RETURNED notification that the merchant sends to eBay through the Inbound Notifications API. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Type defining the Refund container, where the refund could be initiated either from the seller or eBay. This value indicates whether the merchant refunded or provided a store credit to the buyer for the returned In-Store Pickup item. Applicable values are 'REFUND' and 'STORE_CREDIT'. This value is picked up by eBay when the merchant passes in the REFUND_TYPE parameter through the payload of an ORDER.RETURNED notification sent to eBay. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This field is the eBay user ID of the buyer who is receiving the refund or store credit from the merchant. This field is always returned with the Refund container. Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. For GetOrders and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the correct refund recipient is returned to the buyer or seller, but the refund recipient will be masked to all third parties. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This date/time value is the timestamp for the refund transaction. This field is not returned if the refund was not successful (RefundStatus=FAILED). GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This dollar value is the amount of the refund to the buyer for this specific refund transaction. This field is not returned for In-Store Pick or Click and Collect orders where the merchant issued the buyer a store credit instead of a refund (RefundType=STORE_CREDIT). Note: For GetItemTransactions and GetSellerTransactions, the final value fee amount deducted from the seller's payout funds for the sale is not included in this field, which means that the amount in this field may not reflect the buyer's actual refund amount. The logic will remain the same for GetItemTransactions and GetSellerTransactions, but the GetOrders call will be updated to include the the seller's final value fee amount in this field, so the amount in this field should match the buyer's actual refund amount. To pick up this new logic in GetOrders responses, a Trading WSDL version of 1311 or above must be used, or the user can use an older Trading WSDL version but include and set the X-EBAY-API-COMPATIBILITY-LEVEL header value to 1311 or above. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This value is a merchant-defined identifier used to track In-Store Pickup refunds. This value is picked up by eBay when the merchant passes in the REFUND_ID parameter through the payload of an ORDER.RETURNED notification sent to eBay. This field is not returned if the merchant does not set this value through ORDER.RETURNED notification. For GetOrders and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the correct payment identifier is returned to the buyer or seller, but the payment identifier will be masked to all third parties. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This dollar value is the total amount of the refund to the buyer for the In-Store Pickup order. Typically, this dollar value will be the same as the RefundAmount value, unless the merchant is issuing multiple refund transactions to the buyer, in which case, the FeeOrCreditAmount value will be the cumulative amount for multiple refund transactions. This field is not returned if the merchant issued the buyer a store credit instead of a refund (RefundType=STORE_CREDIT). GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Enumerated type defining the refund types that a merchant can offer a buyer who is returning an In-Store Pickup item to the store. This value indicates that the merchant issued a store credit to the buyer for the amount of the returned item(s). This value indicates that the merchant issued a cash refund (or debit card/credit card reversal) to the buyer for the amount of the returned item(s). This value is reserved for internal or future use. This type is no longer used; replaced by ShippingLocationDetails. This field is deprecated. This field is deprecated. This field is deprecated. This field is deprecated. This type is no longer used; replaced by ShippingLocationDetails. String identifier for a continent, a geographic region, or a country. Full name of the continent, geographic region, or country; useful for display purposes. Indicates the status of the Region of Origin value. Only Region of Origin values in the 'Active' state can be used. Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. Indicates category support for listing of Local Market items by sellers subscribed to Local Market for Regular Vehicles. Each of the subscriptions will have following options, which will define "National" vs "Local" ad format listing. "LocalOptional" : This will allow national and local listing. "LocalOnly" : Seller can have Local listings only. "NationalOnly" : Seller can not opt into local only exposure. It has to be national listing. Type defining the regulatory containers that are used at the listing level to provide Energy Efficiency Label information, hazardous material related information, product safety related information, manufacturer and responsible person information, and the repair score. This container provides information about the energy efficiency for certain durable goods. Note: As a part of Digital Services Act (DSA) requirements, all sellers who list products in Germany (DE) must provide Energy Efficiency Label information and Product Information Sheets for listings for certain durable goods. Note: This container can be used to provide European energy efficiency (EEK) information for listings in the Tyres and Appliance categories for sellers in the EU and UK, and Smartphones and Tablets categories for sellers in the US, AU, CA, EU, and UK. If no EEK information is specified through this container, it may be retrieved through a third party vendor. For more information, see <a href = "/api-docs/sell/static/inventory/energy-efficiency.html" target="_blank">Energy efficiency information</a>. Note: Energy efficiency information is not required for all categories. Use the <a href = "/api-docs/sell/metadata/resources/marketplace/methods/getRegulatoryPolicies" target="_blank">getRegulatoryPolicies</a> method of the <a href="https://developer.ebay.com/api-docs/sell/metadata/resources/methods">Metadata API</a> to return metadata on the eBay categories that recommend or require energy efficiency-related fields. Important: When providing energy efficiency information on an appliance or smartphones and tablets listing, the energy efficiency rating and range of the item must be specified through the <a href = "/devzone/xml/docs/reference/ebay/additem.html#Request.Item.ItemSpecifics" target="_blank">ItemSpecifics</a> container. Use the <a href = "/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory" target="_blank">getItemAspectsForCategory</a> method of the Taxonomy API to retrieve applicable rating and range values for a specified category. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem GetItems Conditionally This container is used by the seller to provide hazardous material information for the listing. Only the Statements element is required to complete the Hazmat section of a listing. The Pictograms, SignalWord, and Component elements are optional. For more information, see <a href=" /api-docs/sell/static/metadata/feature-regulatorhazmatcontainer.html" target="_blank">Specifying hazardous material related information</a>. Note: Hazmat information is not required for all categories. Use the <a href = "/api-docs/sell/metadata/resources/marketplace/methods/getRegulatoryPolicies" target="_blank">getRegulatoryPolicies</a> method of the <a href="https://developer.ebay.com/api-docs/sell/metadata/resources/methods">Metadata API</a> to return metadata on the eBay categories that recommend or require Hazmat-related fields. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem GetItems Conditionally This container is used to provide product safety information for the listing. One of the following elements is required to complete the product safety section for a listing: Pictograms or Statements. The Component element is optional. For Revise and Relist calls: To delete all product safety information when you revise or relist, specify Item.Regulatory.ProductSafety in DeletedField, and don't pass ProductSafety in the request. Note: As a part of General Product Safety Regulation (GPSR) requirements effective on December 13th, 2024, sellers operating in, or shipping to, EU-based countries or Northern Ireland are conditionally required to provide product manufacturer information in their eBay listings. Product safety information is not required for all categories. Use the <a href = "/api-docs/sell/metadata/resources/marketplace/methods/getRegulatoryPolicies" target="_blank">getRegulatoryPolicies</a> method of the <a href="https://developer.ebay.com/api-docs/sell/metadata/resources/methods">Metadata API</a> to return metadata on the eBay categories that recommend or require product safety-related fields. For more information on GPSR, see <a href = "https://www.ebay.com/sellercenter/resources/general-product-safety-regulation" target="_blank">General Product Safety Regulation (GPSR)</a>. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem GetItems Conditionally This field represents the repair index for the listing. The repair index identifies the manufacturer's repair score for a product (how easy is it to repair the product). This field is a floating point value between 0 and 10 but may only have one digit beyond the decimal point, for example: <code>7.9</code> Note: <code>0</code> should not be used as a default value, as it implies that the product is not repairable. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally This container provides information about the manufacturer of the item. For Revise and Relist calls: To delete all manufacturer information when you revise or relist, specify Item.Regulatory.Manufacturer in DeletedField, and don't pass Manufacturer in the request. Note: As a part of General Product Safety Regulation (GPSR) requirements effective on December 13th, 2024, sellers operating in, or shipping to, EU-based countries or Northern Ireland are conditionally required to provide product manufacturer information in their eBay listings. Manufacturer information is not required for all categories. Use the <a href = "/api-docs/sell/metadata/resources/marketplace/methods/getRegulatoryPolicies" target="_blank">getRegulatoryPolicies</a> method of the <a href="https://developer.ebay.com/api-docs/sell/metadata/resources/methods">Metadata API</a> to return metadata on the eBay categories that recommend or require manufacturer-related fields. For more information on GPSR, see <a href = "https://www.ebay.com/sellercenter/resources/general-product-safety-regulation" target="_blank">General Product Safety Regulation (GPSR)</a>. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem GetItems Conditionally This container provides information about the EU-based Responsible Persons or entities associated with the listing. For Revise and Relist calls: To delete all Responsible Persons information when you revise or relist, specify Item.Regulatory.ResponsiblePersons in DeletedField, and don't pass ResponsiblePersons in the request. Note: As a part of General Product Safety Regulation (GPSR) requirements effective on December 13th, 2024, sellers operating in, or shipping to, EU-based countries or Northern Ireland are conditionally required to provide Responsible Persons information in their eBay listings if the manufacture is not based in the EU. For more information on GPSR, see <a href = "https://www.ebay.com/sellercenter/resources/general-product-safety-regulation" target="_blank">General Product Safety Regulation (GPSR)</a>. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem GetItems Conditionally This container provides a collection of regulatory documents associated with the listing. For Revise and Relist calls: For information on removing one or more files using a Revise/Relist call, see <a href= "/api-docs/sell/static/inventory/managing-document-media.html#revise" target="_blank">Remove documents from listings.</a> Note: As a part of General Product Safety Regulation (GPSR) requirements effective on December 13th, 2024, sellers operating in, or shipping to, EU-based countries or Northern Ireland are conditionally required to provide regulatory document information in their eBay listings. For more information on GPSR, see <a href = "https://www.ebay.com/sellercenter/resources/general-product-safety-regulation" target="_blank">General Product Safety Regulation (GPSR)</a>. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem GetItems Conditionally This enumerated type defines the type of responsible person associated with a product. Note: Currently, the only supported value is <code>EUResponisblePerson</code>. This value indicates the Responsible person is an EU Responsible Person. An EU Responsible Person is crucial for ensuring that products comply with all relevant regulations and safety standards to protect human health. Reserved for internal or future use. Container for collection of possible responsible person enumerations. The type of Responsible Person associated with the listing. Note: Currently, the only supported value is <code>EUResponsiblePerson</code>. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally Type that provides information, such as name and contact details, for an EU-based Responsible Person or entity, associated with the product. The name of the the Responsible Person or entity. 100 characters for this field AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Yes The first line of the responsible Responsible Person's address. 180 characters for this field AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally The second line of the Responsible Person's address. This field is not always used, but can be used for secondary address information such as 'Suite Number' or 'Apt Number'. 180 characters for this field AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem GetItems Conditionally The city of the Responsible Person's street address. 64 characters for this field AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally The state of province of the Responsible Person's street address. 64 characters for this field AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally The postal code of the Responsible Person's street address. 9 characters for this field AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally The two letter <a href="https://www.iso.org/iso-3166-country-codes.html" target="_blank">ISO 3166-1</a> standard abbreviation of the country of the Responsible Person's address. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally The Responsible Person's business phone number. 64 characters for this field AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally The Responsible Person's email address. 180 characters for this field AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally The Responsible Person's contact URL. 250 characters for this field AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally The type(s) associated with the Responsible Person or entity. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally Type that provides an array of each EU-based Responsible Person or entity associated with the listing. Note: As a part of General Product Safety Regulation (GPSR) requirements effective on December 13th, 2024, sellers operating in, or shipping to, EU-based countries or Northern Ireland are conditionally required to provide Responsible Persons information in their eBay listings if the manufacture is not based in the EU. For more information on GPSR, see <a href = "https://www.ebay.com/sellercenter/resources/general-product-safety-regulation" target="_blank">General Product Safety Regulation (GPSR)</a>. This container consists of the detailed contact information for each Responsible Person or entity associated with the listing. A maximum of 5 EU Responsible Persons are supported. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally GetItem GetItems Conditionally This type is deprecated, as sellers are no longer allowed to set a restocking fee through a listings's return policy. This value indicates that the seller will not charge a restocking fee to the buyer if the item is returned. This value indicates that the seller charges the buyer a restocking fee of 10 percent of the item's purchase price if the item is returned. This value indicates that the seller charges the buyer a restocking fee of 15 percent of the item's purchase price if the item is returned. This value indicates that the seller charges the buyer a restocking fee of up to 20 percent of the item's purchase price if the item is returned. This is no longer a valid value. (out) Reserved for internal or future use. This type is deprecated, as sellers are no longer allowed to set a restocking fee through a listings's return policy. 1061 NoOp 1061 1061 NoOp 1061 In some EU countries, sellers are legally required to describe the return policy they offer. The value returned by this field indicates if sellers can provide such description within the given marketplace and category. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated category, which indicates that items listed in the category must include a return policy. The values returned in this field are valid in AddItem and its related family of calls, and in the return policies you configure for use with the Account API. Type defining the ReturnPolicyDetails container, which is returned in GeteBayDetails, and provides the seller with the Return Policy features (and applicable values) that are supported by the listing site. This container is only returned if ReturnPolicyDetails is included as a DetailName filter in the call request, or if no DetailName filters are used in the request. Note: The GeteBayDetails call returns site-default Return Policy settings. For most categories within a given eBay site, the supported Return Policy options/values are the same, but there a few exceptions. To discover what Return Policy features/settings that a particular category supports, call GetCategoryFeatures and include any or all of the domestic and or international Return Policy-related FeatureID values to see the Return Policy features/settings available for domestic and international returns, respectively. This container consists of the supported refund/exchange/replacement item options that the seller may make available to the buyer in case the buyer wants to return the original item. Enumeration value(s) returned in RefundOption field(s) can be used in the ReturnPolicy.RefundOption field in an Add/Revise/Relist API call. Note: To discover what refund options that a particular category supports, call GetCategoryFeatures and include <code>DomesticRefundMethodValues</code> and/or <code>InternationalRefundMethodValues</code> as FeatureID values to see the refund options available for domestic and international returns, respectively. GeteBayDetails Conditionally This container consists of the supported time periods within which the buyer can return the item, starting from the day they receive the item. Enumeration value(s) returned in ReturnsWithinOption field(s) can be used in the ReturnPolicy.ReturnsWithinOption field in an Add/Revise/Relist API call. Note: To discover what return durations that a particular category supports, call GetCategoryFeatures and include <code>DomesticReturnsDurationValues</code> and/or <code>InternationalReturnsDurationValues</code> as FeatureID values to see the return durations available for domestic and international returns, respectively. GeteBayDetails Conditionally This container consists of the enumeration values that can be passed into the ReturnPolicy.ReturnsAcceptedOption field when using an Add/Revise/Relist API call. This value will indicate whether or not the seller allows the buyer to return the item. Note: To discover the enumeration values that a particular category supports, call GetCategoryFeatures and include <code>DomesticReturnsAcceptedValues</code> and/or <code>InternationalReturnsAcceptedValues</code> as FeatureID values to see the ReturnPolicy.ReturnsAcceptedOption and ReturnPolicy.InternationalReturnsAcceptedOption values supported for domestic and international returns, respectively. GeteBayDetails Conditionally This field is returned with a value of <code>true</code> if the site supports a text description of the seller's Return Policy in listings. If the site does support a text description of the seller's Return Policy, it is set through the ReturnPolicy.Description field in an Add/Revise/Relist API call. Currently, the only eBay sites that support Return Policy descriptions are Germany, Austria, France, Italy, and Spain. Note: To discover if a Return Policy desciption is supported by a particular category, call GetCategoryFeatures and include <code>ReturnPolicyDescriptionEnabled</code> as a FeatureID value to see if the category supports the use of a Return Policy description. GeteBayDetails Conditionally This container consists of the enumeration values that can be passed into the ReturnPolicy.ShippingCostPaidByOption or ReturnPolicy.InternationalShippingCostPaidByOption field when using an Add/Revise/Relist API call. This value will indicate whether the buyer or seller is responsible for return shipping cost. The enumeration value(s) returned in ShippingCostPaidByOption field(s) can be used in the ReturnPolicy.ShippingCostPaidByOption field in an GeteBayDetails Conditionally This type is deprecated, as sellers are no longer allowed to set a restocking fee through a listings's return policy. 1061 NoOp 1061 Returns the latest version number for the Return Policy Details metadata set. The version can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always This timestamp in GMT indicate when the Return Policy Details metadata were last updated. This timestamp can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always Defines the feature that specifies whether a return policy could be enabled on the site. Type used to express the details of the return policy for an item. Historically, the GeteBayDetails call has been used to retrieve site-level return policy metadata. However, the GetCategoryFeatures call is now recommended instead because this call now returns category-level metadata for both domestic and international return policies. Note: If a seller does not add a separate international return policy, the settings in the domestic return policy will be used instead. For more information on setting separate domestic and international return policies, see the <a href="https://pages.ebay.com/seller-center/seller-updates/2018-summer/simplified-returns.html#international-returns-policy" target="_blank">International returns policy</a> help topic. This field indicates how the seller compensates buyers for returns</a>. <code>MoneyBack</code> is the only supported value for all marketplaces except for the US. On the US marketplace, you can set this value to either <code>MoneyBack</code> or <code>MoneyBackOrReplacement</code>. <code>MoneyBackOrReplacement</code> can be used by sellers that have the depth of inventory to support an exchange for an identical item. However, ultimately, it is up to the buyer on whether they want money back or a replacement item. For ReviseItem only: You cannot change the value of this field if the listing has bids or sales, or if the listing ends within 12 hours. For more details, see the ReturnPolicy description. Note: If a seller ships internationally, and wants to define and use a separate international returns policy, the international equivalent of this field is the InternationalRefundOption field. RefundOptionsCodeType AddFixedPriceItem AddItem AddItems ReviseFixedPriceItem ReviseItem RelistFixedPriceItem RelistItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Domestic Refund Methods (in GetCategoryFeatures) supported domestic refund value for each site and category https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetCategoryFeatures.html#Response.Category.DomesticRefundMethodValues Display string that buyer applications can use to present RefundOption in a more user-friendly format to buyers. For example, in GetItem and related calls, this value is usually localized and can contain spaces. If necessary, you can predict the choice of values based on the Refund.Description options returned by GeteBayDetails. This field is applicable to only the US marketplace and is not applicable as input to the Add/Revise/Relist family of calls. (Use RefundOption instead.) GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Specifies the amount of time the buyer has to return an item. The return period begins when the item is marked "delivered" at the buyer's specified ship-to location. Most marketplaces and categories support 30-day and 60-day return periods. eBay sites often set 30-days as the default value for this field and sellers are obligated to honor the values that are set for a listing. This value is required if ReturnsAcceptedOption=ReturnsAccepted. Note: Eligible Parts & Accessories (P&A) listings require sellers to offer buyers free returns with a minimum return period of 30 days. See <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-motors-parts-accessories-easy-returns.html" target="_blank">Support for easy returns in Parts and Accessories</a> for details. Applicable values: Retrieve the values supported by a marketplace and category by calling GetCategoryFeatures with FeatureID set to <code>DomesticReturnsDurationValues</code>, then see the values returned under the Category.DomesticReturnsDurationValues container in the response. For ReviseItem only: You cannot change the value of this field if the listing has bids or sales, or if the listing ends within 12 hours. For more details, see the ReturnPolicy description. Note: If a seller ships internationally, and wants to define and use a separate international returns policy, the international equivalent of this field is the InternationalReturnsWithinOption field. ReturnsWithinOptionsCodeType AddFixedPriceItem AddItem AddItems ReviseFixedPriceItem ReviseItem RelistFixedPriceItem RelistItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Domestic Return Durations (in GetCategoryFeatures) supported domestic return durations for each site and category https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetCategoryFeatures.html#Response.Category.DomesticReturnsDurationValues Display string that buyer applications can use to present ReturnsWithinOption in a more user-friendly format to buyers. For example, in GetItem and related calls, this value is usually localized and can contain spaces. If necessary, you can predict the choice of values based on the ReturnsWithin.Description options returned by GeteBayDetails. Not applicable as input to the AddItem family of calls. (Use ReturnsWithinOption instead.) GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally This required field indicates whether or not the seller accepts returns. Applicable values are <code>ReturnsAccepted</code> or <code>ReturnsNotAccepted</code>. When set to <code>ReturnsAccepted</code>, this option indicates the seller allows items to be returned. Specify ReturnsNotAccepted for a listing if returns are not accepted. On the eBay DE, IE, and UK marketplaces, registered business sellers must accept returns for fixed-price items (including auction items with Buy It Now and any other fixed price formats) when the category requires a return policy. On some European sites, such as eBay Germany (DE), registered business sellers are required to accept returns. Use the Trading call GetUser to determine the status of an eBay business seller in DE, IE, and UK. Review the User.SellerInfo.SellerBusinessType field in the response. Note: In order for Top-Rated sellers to receive a Top-Rated Plus seal for their listings, returns must be accepted for their items (ReturnsAcceptedOption = <code>ReturnsAccepted</code>) and handling time should be set to zero-day (same-day shipping) or one-day shipping. Set the handling time (in days) using the Item.DispatchTimeMax field. For ReviseItem only: You cannot change the value of this field if the listing has bids or sales, or if the listing ends within 12 hours. For more details, see the ReturnPolicy description. Note: If a seller ships internationally, and wants to define and use a separate international returns policy, the international equivalent of this field is the InternationalReturnsAcceptedOption field. ReturnsAcceptedOptionsCodeType AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem Conditionally ReviseFixedPriceItem ReviseItem RelistFixedPriceItem RelistItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Domestic Returns Accepted Values (in GetCategoryFeatures) supported domestic returns accepted values for each site and category https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetCategoryFeatures.html#Response.Category.DomesticReturnsAcceptedValues Display string that buyer applications can use to present ReturnsAcceptedOption in a more user-friendly format to buyers. For example, in GetItem and related calls, this value is usually localized and can contain spaces. If necessary, you can predict the choice of values based on the ReturnsAccepted.Description options returned by GeteBayDetails. Not applicable as input to the AddItem family of calls. (Use ReturnsAcceptedOption instead.) GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally This field contains the seller's detailed explanation for their return policy and is displayed in the Return Policy section of the View Item page. This field is valid in only the following marketplaces (the field is otherwise ignored): <ul> <li>Germany (DE)</li> <li>Austria (AT)</li> <li>France (FR)</li> <li>Italy (IT)</li> <li>Spain (ES)</li> </ul> Where valid, sellers can use this field to add details about their return policies. eBay uses this text string as-is in the additional details section of the View Item page. Avoid HTML and avoid character entity references (such as &pound; or &#163;). If you include special characters in the return policy description, use the literal UTF-8 or ISO-8559-1 character (e.g. £).  For AddItem, VerifyAddItem, and RelistItem: If the seller accepts returns (ReturnsAcceptedOption = <code>ReturnsAccepted</code>) but does not specify this field when listing the item, GetItem returns this as an empty node. For ReviseItem only: You cannot change the value of this field if the listing has bids or sales, or if the listing ends within 12 hours. For more details, see the ReturnPolicy description. 8000 (for DE, AT); 5000 (for FR, IT, ES) AddFixedPriceItem AddItem AddItems ReviseFixedPriceItem ReviseItem RelistFixedPriceItem RelistItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally This option specifies whether the buyer or the seller pays for return shipping charges. Accepted values are <code>Buyer</code> or <code>Seller</code>. eBay sites often set <code>Seller</code> as the default value for this field, and sellers are obligated to honor the values that are set for a listing. This value is required if ReturnsAcceptedOption=ReturnsAccepted. Depending on the seller's return policy and the specifics of a return, either the buyer or the seller can be responsible for the return shipping costs. Note that the seller is always responsible for return shipping costs for SNAD-related issues or for late shipments. Note: Eligible Parts & Accessories (P&A) listings require sellers to offer buyers free returns with a minimum return period of 30 days. See <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-motors-parts-accessories-easy-returns.html" target="_blank">Support for easy returns in Parts and Accessories</a> for details. For ReviseItem only: You cannot change the value of this field if the listing has bids or sales, or if the listing ends within 12 hours. For more details, see the ReturnPolicy description. Note: If a seller ships internationally, and wants to define and use a separate international returns policy, the international equivalent of this field is the InternationalShippingCostPaidByOption field. ShippingCostPaidByOptionsCodeType AddFixedPriceItem AddItem AddItems ReviseFixedPriceItem ReviseItem RelistFixedPriceItem RelistItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Return Shipping Cost Payee Values (in GetCategoryFeatures) supported domestic return shipping cost payee values for each site and category https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetCategoryFeatures.html#Response.Category.DomesticReturnsShipmentPayeeValues This is a display string that buyer applications can use to present ShippingCostPaidByOption in a more user-friendly format to buyers. For example, in GetItem and related calls, this value is usually localized and can contain spaces. If necessary, you can predict the choice of values based on the ShippingCostPaidBy.Description options returned by GeteBayDetails. Not applicable as input to the AddItem family of calls. (Use ShippingCostPaidByOption instead.) GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally This field indicates how the seller compensates international buyers for returns</a>. <code>MoneyBack</code> is the only supported value for all marketplaces except for the US. On the US marketplace, you can set this value to either <code>MoneyBack</code> or <code>MoneyBackOrReplacement</code>. <code>MoneyBackOrReplacement</code> can be used by sellers that have the depth of inventory to support an exchange for an identical item. However, ultimately, it is up to the buyer on whether they want money back or a replacement item. For ReviseItem only: You cannot change the value of this field if the listing has bids or sales, or if the listing ends within 12 hours. For more details, see the ReturnPolicy description. Note: If a seller does not add a separate international return policy, the settings in the domestic return policy will be used instead. So if this field is not used in an add/revise/relist call, the refund option(s) for international returns will default to the value specified in the RefundOption field. RefundOptionsCodeType AddFixedPriceItem AddItem AddItems ReviseFixedPriceItem ReviseItem RelistFixedPriceItem RelistItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally International Refund Methods (in GetCategoryFeatures) supported international refund value for each site and category https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetCategoryFeatures.html#Response.Category.InternationalRefundMethodValues This field is conditionally required if a seller wants to use a separate return policy for international returns. The value in this field indicates whether or not the seller accepts returns from international buyers. Applicable values are <code>ReturnsAccepted</code> or <code>ReturnsNotAccepted</code>. When set to <code>ReturnsAccepted</code>, this option indicates the seller allows international buyers to return items. Specify ReturnsNotAccepted for a listing if returns are not accepted from international buyers. On the eBay DE, IE, and UK, registered business sellers must accept returns for fixed-price items (including auction items with Buy It Now and any other fixed price formats) when the category requires a return policy. On some European sites, such as eBay Germany (DE), registered business sellers are required to accept returns. Use the Trading call GetUser to determine the status of an eBay business seller in DE, IE, and UK. Review the User.SellerInfo.SellerBusinessType field in the response. For ReviseItem only: You cannot change the value of this field if the listing has bids or sales, or if the listing ends within 12 hours. For more details, see the ReturnPolicy description. Note: If a seller does not add a separate international return policy, the settings in the domestic return policy will be used instead. So if this field is not used in an add/revise/relist call, the return accepted value for international returns will default to the value specified in the ReturnsAcceptedOption field. ReturnsAcceptedOptionsCodeType AddFixedPriceItem AddItem AddItems VerifyAddFixedPriceItem VerifyAddItem Conditionally ReviseFixedPriceItem ReviseItem RelistFixedPriceItem RelistItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally International Returns Accepted Values (in GetCategoryFeatures) supported international returns accepted values for each site and category https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetCategoryFeatures.html#Response.Category.InternationalReturnsAcceptedValues This field is conditionally required if a seller is using a separate return policy for international returns, and is accepting international returns. The value in this field indicates the number of days that an international buyer has to return an item. The time period begins on the day that the buyer receives the item. Most marketplaces and categories support 30-day and 60-day return periods. eBay sites often set 30-days as the default value for this field and sellers are obligated to honor the values that are set for a listing. Applicable values: Retrieve the values supported by a marketplace and category by calling GetCategoryFeatures with FeatureID set to <code>InternationalReturnsDurationValues</code>, then see the values returned under the Category.InternationalReturnsDurationValues container in the response. For AddItem, VerifyAddItem, and RelistItem: If the seller accepts international returns (InternationalReturnsAcceptedOption is set to ReturnsAccepted) but does not specify this field for a listing, eBay sets a default value (often Days_30) and the seller is obligated to honor this setting. For ReviseItem only: You cannot change the value of this field if the listing has bids or sales, or if the listing ends within 12 hours. For more details, see the ReturnPolicy description. Note: If a seller does not add a separate international return policy, the settings in the domestic return policy will be used instead. So if this field is not used in an add/revise/relist call, the return period for international returns will default to the value specified in the ReturnsWithinOption field. ReturnsWithinOptionsCodeType AddFixedPriceItem AddItem AddItems ReviseFixedPriceItem ReviseItem RelistFixedPriceItem RelistItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally International Return Durations (in GetCategoryFeatures) supported international return durations for each site and category https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetCategoryFeatures.html#Response.Category.InternationalReturnsDurationValues This field is conditionally required if a seller is using a separate return policy for international returns, and is accepting international returns. The value in this field specifies whether the buyer or the seller pays for international return shipping charges. Accepted values are <code>Buyer</code> or <code>Seller</code>. eBay sites often set <code>Seller</code> as the default value for this field, and sellers are obligated to honor the values that are set for a listing. Depending on the seller's return policy and the specifics of a return, either the buyer or the seller can be responsible for the return shipping costs. Note that the seller is always responsible for return shipping costs for SNAD-related issues or for late shipments. For ReviseItem only: You cannot change the value of this field if the listing has bids or sales, or if the listing ends within 12 hours. For more details, see the ReturnPolicy description. Note: If a seller does not add a separate international return policy, the settings in the domestic return policy will be used instead. So if this field is not used in an add/revise/relist call, return shipping cost payee for international returns will default to the value specified in the ShippingCostPaidByOption field. ShippingCostPaidByOptionsCodeType AddFixedPriceItem AddItem AddItems ReviseFixedPriceItem ReviseItem RelistFixedPriceItem RelistItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList

GranularityLevel: Medium, Fine

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally Return Shipping Cost Payee Values (in GetCategoryFeatures) supported international return shipping cost payee values for each site and category https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GetCategoryFeatures.html#Response.Category.InternationalReturnsShipmentPayeeValues Enumerated type that defines the possible states of an eBay return request. This value indicates that the return request is invalid. This value indicates that the return request is not applicable. This value indicates that the return request has been initiated by the buyer and is pending approval by the seller. This value indicates that the buyer's return request was rejected by the seller or other authorized party. This value indicates that a return request was successfully opened by the buyer. This value indicates that the buyer has return shipped the item(s) in the return request back to the seller. This value indicates that the seller has received the item(s) that the buyer return shipped. This value indicates that a return request was closed with a refund issued to the buyer. This value indicates that a return request was closed after being escalated to an eBay return case. This value indicates that a return request was closed with no refund issued to the buyer. This value indicates that a return request was escalated to an eBay return case, and the case is awaiting a response from the buyer. This value indicates that a return request was escalated to an eBay return case, and the case is awaiting a response from the seller. This value indicates that a return request was escalated to an eBay return case, and the case is awaiting a response from eBay Customer Support. This value indicates that a return request was escalated to an eBay return case, but the case was closed with a refund issued to the buyer. This value indicates that a return request was escalated to an eBay return case, but the case was closed with no refund issued to the buyer. This value indicates that a return request was escalated to an eBay return case. This value indicates that the return request is currently in the pending state. This value indicates that the return request was closed with a refund to the buyer. This value indicates that the return request was closed with no refund to the buyer. Reserved for internal or future use. Specified whether returns are accepted. The seller accepts returns, subject to other details specified in the policy. The seller does not accept returns. (out) Reserved for internal or future use. This enum defines the different options that are available for specifying whether or not the seller accepts returns. <code>ReturnsAccepted</code> indicates the seller does accept returns. <code>ReturnsNotAccepted</code> indicates the seller does not accept returns. Type defining the ReturnPolicyDetails.ReturnsAccepted container that is returned in GeteBayDetails. This container contains the values that may be used in the ReturnPolicy.ReturnsAcceptedOption field of Add/Revise/Relist API calls. Note: The GeteBayDetails call returns site-default Return Policy settings. For most categories within a given eBay site, the supported Return Policy options/values are the same, but there a few exceptions. To discover what returns accepted options that a particular category supports, call GetCategoryFeatures and include <code>DomesticReturnsAcceptedValues</code> and/or <code>InternationalReturnsAcceptedValues</code> as FeatureID values to see the returns accepted options available for domestic and international returns, respectively. Whether the seller allows the buyer to return the item. This value can be passed in the AddItem family of calls. ReturnsAcceptedOptionsCodeType GeteBayDetails Conditionally Display string that applications can use to present ReturnsAcceptedOption in a more user-friendly format (such as in a drop-down list). Not applicable as input to the AddItem family of calls. (Use ReturnsAcceptedOption instead.) GeteBayDetails Conditionally This enum defines the different options that are available for specifying the available return durations. This is the amount of time the seller gives the buyer for initiating a return once they receive the item. <code>Days_14</code> indicates the buyer has 14 days to initiate a return. <code>Days_30</code> indicates the buyer has 30 days to initiate a return. <code>Days_60</code> indicates the buyer has 60 days to initiate a return. This enum defines the different options that are available for specifying the available refund methods. <code>MoneyBack</code> indicates the seller will refund the cost of the item returned. Available on the US marketplace only, <code>MoneyBackorReplacement</code> indicates the seller will refund the cost of the item returned or they will replace the returned item. This enum defines the different options that are available for specifying the return shipment payee. <code>Buyer</code> indicates the buyer is responsible for paying for the return shipping. <code>Seller</code> indicates the seller is responsible for paying for the return shipping. This enumerated type contains the list of values that can be used by the seller in an Add/Revise/Relist call to set the number of days (after the purchase date) that a buyer has to return an item (if the return policy states that items can be returned) for a refund or an exchange. These same values are also returned in the GeteBayDetails call. Note: The GeteBayDetails call returns site-default Return Policy settings. For most categories within a given eBay site, the supported Return Policy options/values are the same, but there a few exceptions. To discover what return durations that a particular category supports, call GetCategoryFeatures and include <code>DomesticReturnsDurationValues</code> and/or <code>InternationalReturnsDurationValues</code> as FeatureID values to see the return durations available for domestic and international returns, respectively. Days_3, Days_7, Days_10, Months_1 This value is deprecated. Listings created or revised with this value will be blocked. This value is deprecated. Listings created or revised with this value will be blocked. This value is deprecated. Listings created or revised with this value will be blocked. The seller specifies this value to enable a 14-day return policy. A buyer must return an item within 14 days after purchase in order to receive a refund or an exchange/replacement item. The seller specifies this value to enable a 30-day return policy. A buyer must return an item within 30 days after purchase in order to receive a refund or an exchange/replacement item. Note: To qualify as a Top-Rated Plus listing, a 30-day (or longer) return period must be set. The seller specifies this value to enable a 60-day return policy. A buyer must return an item within 60 days after purchase in order to receive a refund or an exchange/replacement item. The seller specifies this value to enable a one-month return policy. A buyer must return an item within one month after purchase in order to receive a refund or an exchange. Note: This value, historically only supported on the DE and AT sites, is scheduled to be deprecated, and DE and AT sellers may be blocked if they do use this value. Use <code>Days_30</code> instead. This value is reserved for internal or future use. Type defining the ReturnPolicyDetails.ReturnsWithin container that is returned in GeteBayDetails. This container contains the values that may be used in the ReturnPolicy.ReturnsWithinOption field of Add/Revise/Relist API calls. Note: The GeteBayDetails call returns site-default Return Policy settings. For most categories within a given eBay site, the supported Return Policy options/values are the same, but there a few exceptions. To discover what return durations that a particular category supports, call GetCategoryFeatures and include <code>DomesticReturnsDurationValues</code> and/or <code>InternationalReturnsDurationValues</code> as FeatureID values to see the return durations available for domestic and international returns, respectively. Value indicates the number of days that a buyer has to return an item from the day they receive the item. This value can be passed in the Add/Revise/Relist family of API calls. Supported values can vary by eBay site. ReturnsWithinOptionsCodeType GeteBayDetails Conditionally Display string that applications can use to present ReturnsWithinOption in a more user-friendly format (such as in a drop-down list). Not applicable as input to the AddItem family of calls. (Use ReturnsWithinOption instead.) GeteBayDetails Conditionally If the field is present, the corresponding feature applies to the category. The field is returned as an empty element (i.e., a boolean value is not returned). If the field is present, the corresponding feature applies to the category. The field is returned as an empty element (i.e., a boolean value is not returned). Contains data indicating whether an item has been revised since the listing became active and, if so, which among a subset of properties have been changed by the revision. This field is returned as <code>true</code> if the original listing has been revised. This field is always returned with the ReviseStatus container. GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally This field is returned as <code>true</code> if a Buy It Now price has been added to the auction listing. This field is only returned if the original auction listing did not have a Buy It Now price, but a revision to that original listing included adding a Buy It Now price. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This field is returned as <code>true</code> if the Buy It Now price on the original auction listing was lowered as part of a revision to the original auction listing. This field is only returned if the Buy It Now price on the original auction listing was lowered as part of a revision to the original auction listing. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This field is returned as <code>true</code> if the Reserve price on the original auction listing was lowered as part of a revision to the original auction listing. This field is only returned if the Reserve price on the original auction listing was lowered as part of a revision to the original auction listing. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally This field is returned as <code>true</code> if the Reserve price on the original auction listing was removed as part of a revision to the original auction listing. This field is only returned if the Reserve price on the original auction listing was removed as part of a revision to the original auction listing. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally A list of stock-keeping unit (SKU) identifiers that a seller uses in listings. 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. A seller can specify a SKU when listing an item with AddItem and related calls. 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.) A SKU is not required to be unique. A seller can specify a particular SKU value on one item or on multiple items. Different sellers can use the same SKUs. If the SKU is unique across a seller's active listings, and if the seller listed the item by using AddFixedPriceItem or RelistFixedPriceItem, the seller can also set Item.InventoryTrackingMethod to SKU. This allows the seller to use SKU instead of ItemID as a unique identifier in subsequent calls, such as GetItem and ReviseInventoryStatus. 50 GetSellerTransactions GetSellerList No Primitive type that represents a stock-keeping unit (SKU). The usage of this string may vary in different contexts. For usage information and rules, see the fields that reference this type. Type of SMS subscription error. Aggregator not available. Phone number invalid. Phone number has changed. The carrier has changed. The user has requested to be unregistered. (out) Reserved for internal or future use. The current state of user SMS subscription. (out) Registered. (out) Unregistered. (out) Pending subscription. (out) Subscription failed. (out) Reserved for internal or future use. For the US, Canada and Australia sites, users are required to offer at least one safe payment method. If a seller has a 'SafePaymentExempt' status, they are exempt from the category requirement to offer at least one safe payment method when listing an item on a site that has the safe payment requirement. Note: Although the SafePaymentRequired field is still being returned for now, sellers never need to set the available electronic payments, so this requirement is no longer applicable. This type is used to show sales tax-related details for a tax jurisdiction. The concept of 'sales tax' is only applicable to eBay US and Canada (English and French) sites. This float value is the sales tax percentage rate applicable to the corresponding tax jurisdiction (US state or Canadian province). Sellers are responsible for providing accurate sales tax rates for each jurisdiction. This sales tax rate comes into play when a buyer from that tax jurisdiction makes a purchase from the seller. The value passed in is stored with a precision of 3 digits after the decimal point (##.###). This field is only returned in order management calls if sales tax applies to the order line item, and is only in GetItem (and other 'Get' calls) if sales tax is applicable to the listing or order line item, and the seller is the person making the call. Although this field will be returned at the order level in order management calls for a single line item order, sales tax is applied at the line item level and not order level. For multiple line item orders, this field will not be returned at all at the order level. Note: Buyers in all 50 US states and DC are automatically charged sales tax for eBay purchases, and eBay collects and remits this sales tax to the proper taxing authority on the buyer's behalf. Because of this, if a sales tax percentage rate is applied to a listing by a seller in one of these states, this field will be ignored during the checkout process. Currently, sales tax percentage rates can only be specified by sellers in Canada and 5 US territories, including American Samoa (AS), Guam (GU), Northern Mariana Islands (MP), Palau (PW), and Virgin Islands (VI). AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem SendInvoice VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList GetItemShipping GetTaxTable Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This is the unique, two-digit identifier of the tax jurisdiction (such as 'CA' for California). To retrieve all two-digit identifiers for all states/territories/provinces for a site, a seller can either use a GetTaxTable call with DetailLevel set to <code>ReturnAll</code>, or they can use the GeteBayDetails call with DetailLevel name set to <code>TaxJurisdiction</code>. Please note that both GetTaxTable and GeteBayDetails calls use a JurisdictionID field to express these tax jurisdiction identifiers instead of SalesTaxState, but the values used in these fields are the same. The SalesTaxState field is conditionally required in an Add/Revise/Relist/Verify call if the seller is applying sales tax to a listing for a particular jurisdiction, and is returned with each SalesTax container to identify the tax jurisdiction. AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem SendInvoice VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList GetItemShipping Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally This field is included in an Add/Revise/Relist/Verify call and set to <code>true</code> if the seller wants sales tax for the jurisdiction to apply to the cumulative amount of item cost and shipping charges. This value defaults to <code>false</code> if not specified. This field is always returned with the SalesTax container (whether <code>true</code> or <code>false</code>). Note: Buyers in all 50 US states and DC are automatically charged sales tax for eBay purchases, and eBay collects and remits this sales tax to the proper taxing authority on the buyer's behalf. Because of this, if a sales tax percentage rate is applied to a listing by a seller in one of these states, this field will be ignored during the checkout process. Currently, sales tax percentage rates can only be specified by sellers in Canada and 5 US territories, including American Samoa (AS), Guam (GU), Northern Mariana Islands (MP), Palau (PW), and Virgin Islands (VI). AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem SendInvoice VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No False GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetBidderList GetItemShipping Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The amount of sales tax calculated for an order line item based on the sale price and the sales tax rate for the buyer's tax jurisdiction. For a multiple line item order, the SalesTaxAmount returned at the order level will be the cumulative amount for all line items in the order. GetItemTransactions can return incorrect sales tax if the name of a state is not abbreviated (e.g. if the value is "Illinois" rather than "IL") in TransactionArray.Transaction.Buyer.BuyerInfo.ShippingAddress.StateOrProvince. SendInvoice No GetItemShipping Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Contains information for scheduling limits for the user. Maximum number of minutes that a listing may be scheduled in advance of its going live. GetUser

DetailLevel: none, ReturnAll

Conditionally Minimum number of minutes that a listing may be scheduled in advance of its going live. GetUser

DetailLevel: none, ReturnAll

Conditionally Maximum number of Items that a user may schedule. GetUser

DetailLevel: none, ReturnAll

Conditionally This enumerated type lists the possible values that can be returned under the FavoriteSearch.SearchFlag field of a GetMyeBayBuying response. These values are output only and are controlled by the filter types used in a buyer's Saved Search. NowAndNew, DigitalDelivery, Picture, Gallery, WorldOfGood, GetItFast, Gift This value being returned in the FavoriteSearch.SearchFlag field indicates that the buyer selected the eBay for Charity option in the Saved Search. This value is no longer applicable as Gift Icon and Gift Services are deprecated. This value is no longer applicable as the Now and New feature is deprecated. This value being returned in the FavoriteSearch.SearchFlag field indicates that the buyer selected the Local pickup option in the Saved Search. A buyer would select the Local Pickup filter in a Saved Search to restrict retrieved listings to those that offer 'local pickup' as an option to buyers. This value being returned in the FavoriteSearch.SearchFlag field indicates that the buyer selected the Free shipping option in the Saved Search. A buyer would select the Free shipping filter in a Saved Search to restrict retrieved listings to those that offer a free shipping option to that specific buyer (the availability of free shipping may be dependent on the buyer's location). This value is no longer applicable as there is always a gallery picture by default since all listings must have at least one picture. This value is no longer applicable as there is now a requirement that all listings have at least one picture. This value is no longer applicable as the Get It Fast feature is deprecated. This value being returned in the FavoriteSearch.SearchFlag field indicates that the buyer selected the Items listed as lots option in the Saved Search. A buyer would select the Items listed as lots filter in a Saved Search to restrict retrieved listings to those that are offering a "lot" of items in one listing. Specifically, a "lot" is defined as, "a group of similar or identical items that are sold together to one buyer." This value is only applicable to the German site and if the user is searching for motor vehicle listings. This value being returned in the FavoriteSearch.SearchFlag field indicates that the buyer selected a filter in a Saved Search to restrict retrieved eBay Germany motor vehicle listings that are also being displayed on the mobile.de vehicle marketplace. This value is no longer applicable as the World of Good site no longer exists. This value is no longer applicable. Reserved for internal or future use. This enumerated type contains the list of values that can be used by the seller to set the length of time that a Second Chance Offer will be available to a specific recipient to whom the Second Chance Offer was presented. The recipient must purchase the Second Chance item within this time or the offer will expire. Second Chance Offers are only applicable for closed auction listings. The seller specifies this value to make the Second Chance offer available to the bidder for one day. This value will affect the EndTime value returned in the AddSecondChanceItem response. The seller specifies this value to make the Second Chance offer available to the bidder for three days. This value will affect the EndTime value returned in the AddSecondChanceItem response. The seller specifies this value to make the Second Chance offer available to the bidder for five days. This value will affect the AddSecondChanceItem response. The seller specifies this value to make the Second Chance offer available to the bidder for seven days. This value will affect the EndTime value returned in the AddSecondChanceItem response. This value is reserved for internal or future use. Type of seller account. This value is returned if the user is a business seller with a site ID of 77 (Germany), 3 (UK), 205 (Ireland) or 0 (US Motors). Type of seller account not defined. Private seller account. Commercial seller account. Reserved for internal or future use. Defines the SellerContactDetailsEnabled feature. If the field is present, the category allows retrieval of seller-level contact information. The field is returned as an empty element (e.g., a boolean value is not returned). Type defining the SellerDiscounts container, which consists of one or more SellerDiscount nodes, as well as the original purchase price and shipping cost of the order line item. The original purchase price of the order line item (before any seller discounts are applied). GetItemTransactions GetOrders GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The original shipping cost for the order line item (before any seller discounts are applied). GetItemTransactions GetOrders GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The original shipping service offered by the seller to ship an item to a buyer. ShippingServiceCodeType GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally A container consisting of name and ID of the seller's discount campaign, as well as the discount amount that is being applied to the order line item. GetItemTransactions GetOrders GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Type that defines the SellerDiscount container, which contains the ID, name, and amount of the seller discount. Unique identifier for a seller discount campaign. This ID is automatically created when the seller creates the discount campaign. This field is always returned with the SellerDiscount container. GetItemTransactions GetOrders GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The name of the seller discount campaign. This field will only be returned with the SellerDiscount container if defined for the seller discount campaign. GetItemTransactions GetOrders GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The dollar amount of the order line item discount. The original purchase price (denoted in OriginalItemPrice) will be reduced by this value. The amount of the item discount will depend on the rules defined in the the seller discount campaign. Note: Prior to Version 895, this field worked a little differently. Instead of this field showing the amount of the discount, it was actually showing the final item price after the discount was applied. So, if an item price is 10.0 dollars and the discount is 2.0 dollars, someone using Version 895 (and going forward) will see a value of '2.0' (amount of the discount) in this field, but anyone using Version 893 or lower will see a value of '8.0' (item price after discount) in this field. GetItemTransactions GetOrders GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The dollar amount of the shipping discount applied to the order line item. GetItemTransactions GetOrders GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Type used by the SellerExcludeShipToLocationPreferences container which is returned in the GetUserPreferences response to indicate which geographical regions and/or individual countries the seller has added as excluded ship-to locations. One ExcludeShipToLocation field is returned for each geographical region or country excluded as a possible shipping location in the seller's My eBay Shipping Preferences. Sellers can also exclude Alaska/Hawaii and Army Post Office/Fleet Post Office as possible shipping locations. For excluded countries, <a href="http://www.iso.org/iso/country_codes/iso_3166_code_lists/english_country_names_and_code_elements.htm">ISO 3166</a> country codes are returned. Domestically, the seller can specify Alaska/Hawaii, US Protectorates (including American Samoa, Guam, Mariana Island, Marshall Islands, Micronesia, Palau, Puerto Rico, and U.S. Virgin Islands) as places he/she will not ship to. Internationally, the sellers can exclude entire regions (including Africa, Asia, Central America and Caribbean, Europe, Middle East, North America, Oceania, Southeast Asia, and South America) or specific countries within those regions. If a buyer's primary ship-to location is a location that you have listed as an excluded ship-to location (or if the buyer does not have a primary ship-to location), they will receive an error message if they attempt to buy or place a bid on your item. To see the valid exclude ship-to locations for a specified site, call GeteBayDetails with a DetailName field set to ExcludeShippingLocationDetails. GetUserPreferences Conditionally Contains the data for the seller favorite item preferences, i.e. the manual or automatic selection criteria to display items for buyer's favourite seller opt in email marketing. The keywords in the item title for the automatic item search criteria. GetUserPreferences Conditionally SetUserPreferences No (For eBay Store owners only) The store custom category for the automatic item search criteria. GetUserPreferences Conditionally SetUserPreferences No The listing format (fixed price, auction, etc) for the automatic item search criteria. GetUserPreferences Auction, StoresFixedPrice, LeadGeneration, FixedPriceItem Conditionally SetUserPreferences Auction, StoresFixedPrice, LeadGeneration, FixedPriceItem No The sort order chosen from the standard ebay sorts for the automatic search criteria. GetUserPreferences Conditionally SetUserPreferences No Specifies the lower limit of price range for the automatic search criteria. GetUserPreferences Conditionally SetUserPreferences No Specifies the upper limit of price range for the automatic search criteria. GetUserPreferences Conditionally SetUserPreferences No Specifies the list of favorite items. GetUserPreferences Conditionally SetUserPreferences No This type was deprecated along with the Seller Guarantee feature. (out) Not eligible for Seller Level Guarantee (out) Regular eligibility level (out) Premium eligibility level (out) Ultra eligibility level (out) Reserved for internal or future use. Indicates the user's eBay PowerSeller tier. PowerSellers are distinguished in 5 tiers based on average monthly sales. Benefits and services vary for each tier. eBay calculates eligibility for each tier monthly. Bronze (lowest tier) Silver (between Bronze and Gold) Gold (between Silver and Platinum) Platinum (between Gold and Titanium) Titanium (highest tier) Not a PowerSeller (eBay has not yet evaluated your PowerSeller status, or you have not chosen to be a member of the PowerSeller program, or you lost your PowerSeller status due to a policy violation.) Reserved for internal or future use This enumerated type defines the payment methods that an eBay user can use to pay fees on monthly eBay invoice. This enumeration value indicates that eBay does not currently have a payment method on file for the eBay user. This enumeration value indicates that eBay will use the credit card on file to process the eBay user's monthly invoice. This enumeration value is deprecated. This enumeration value indicates that eBay will debit the bank account on file to process the eBay user's monthly invoice. This enumeration value indicates that eBay will debit the bank account on file to process the eBay user's monthly invoice. A signature will be needed from the eBay user before a payment can be processed. This enumeration value indicates that the eBay user will use eBay Direct Pay to pay the monthly invoice. (out) Reserved for internal or future use This enumeration value indicates that eBay will debit the bank account on file to process the eBay user's monthly invoice. However, the bank account information must be verified before a payment can be processed. Type defining the SellerPaymentPreferences container, which consists of the seller's payment preferences. Payment preferences specified in a SetUserPreferences call override the current corresponding settings in the seller's account. Sellers include this field and set it to <code>true</code> if they want buyers to mail payment to the payment address specified in the SellerPaymentPreferences.SellerPaymentAddress field. A payment address only comes into play if the listing's category allows offline payments, and the seller has allowed the buyer to mail a payment. This payment address will only be displayed to winning bidders and buyers. GetUserPreferences Conditionally SetUserPreferences No This field is deprecated. If it is used in a SetUserPreferences call, it is ignored. GetUserPreferences Conditionally SetUserPreferences No This field is deprecated. If it is used in a SetUserPreferences call, it is ignored. GetUserPreferences Conditionally SetUserPreferences No This field is deprecated. If it is used in a SetUserPreferences call, it is ignored. GetUserPreferences Conditionally SetUserPreferences No This field is deprecated. If it is used in a SetUserPreferences call, it is ignored. GetUserPreferences Conditionally SetUserPreferences No This container consists of the seller's mailing address where the buyer will send payment for an order. A seller's payment address only comes into play if the listing's category allows offline payments, and the seller has allowed the buyer to mail a payment. This payment address will only be displayed to winning bidders and buyers. GetUserPreferences Conditionally SetUserPreferences No This enumeration value indicates the category/level of UPS shipping rates that are available to the seller. GetUserPreferences Conditionally SetUserPreferences No This enumeration value indicates the category/level of Federal Express shipping rates that are available to the seller. GetUserPreferences Conditionally SetUserPreferences No This enumeration value indicates the category/level of US Postal Service shipping rates that are available to the seller. GetUserPreferences Conditionally SetUserPreferences No Type defining the SellerPaymentProfile container, which is used in an Add/Revise/Relist/Verify Trading API call to reference and use a payment business policy. The unique identifier of a payment business policy. A PaymentProfileID and/or a PaymentProfileName value is used in the Add/Revise/Relist/Verify call to reference and use the payment settings/values of a payment business policy. If both fields are provided and their values don't match, the PaymentProfileID takes precedence. Payment profile IDs can be retrieved with the getPaymentPolicies call of the Account API or with the getSellerProfiles call of the Business Policies Management API. Business policy IDs can also be retrieved through the Business policies section of My eBay. In the 'Get' calls, the PaymentProfileID value will always be returned if business policies are set for the listing, and the person making the API call is the seller of the listing. The PaymentProfileName value will be returned if a name is assigned to the payment business policy. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem AddItems ReviseItem RelistItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents GetMyeBaySelling Conditionally The name of a payment business policy. A PaymentProfileID and/or a PaymentProfileName value is used in the Add/Revise/Relist/Verify call to reference and use the payment settings/values of a payment business policy. If both fields are provided and their values don't match, the PaymentProfileID takes precedence. In the 'Get' calls, the PaymentProfileID value will always be returned if business policies are set for the listing, and the person making the API call is the seller of the listing. The PaymentProfileName value will be returned if a name is assigned to the payment business policy. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem AddItems ReviseItem RelistItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents GetMyeBaySelling Conditionally Type defining the SellerProfilePreferences container. This container consists of a flag that indicates whether or not the seller has opted into Business Policies, as well as a list of Business Policies profiles that have been set up for the seller's account. Boolean flag indicating whether or not a seller has opted in to Business Policies. Sellers must opt in to Business Policies to create and manage payment, return policy, and shipping profiles. GetUserPreferences Conditionally SetUserPreferences No Container consisting of one or more Business Policies profiles active for a seller's account. This container is only returned if SellerProfileOptedIn = SellerProfilePreferences and the seller has one or more Business Policies profiles active on the account. GetUserPreferences Conditionally SetUserPreferences No Type defining the SellerProfiles container, which consists of references to a seller's payment, shipping, and return policy profiles. The SellerShippingProfile container is used in an Add/Revise/Relist/Verify Trading API call to reference and use the settings/values of a specific shipping business policy. Shipping business policies contain detailed information on domestic and international shipping, including shipping service options and costs, handling time, shipping discount information, and excluded ship-to locations. Multiple shipping business policies can be created and saved at the account level by sellers. Note: Any shipping inclusions specified through this container can be overridden by the eBay International Shipping exclusions toggle located under Shipping Preferences in My eBay. For more information on eBay International Shipping, see <a href="https://www.ebay.com/help/selling/shipping-items/setting-shipping-options/ebay-international-shipping-program?id=5348">eBay International Shipping program</a>. This container is only returned in 'Get' calls if Business Policies are set for the listing, and the person making the API call is the seller of the listing. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem AddItems ReviseItem RelistItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents GetMyeBaySelling Conditionally The SellerReturnProfile container is used in an Add/Revise/Relist/Verify Trading API call to reference and use the settings/values of a return business policy. Return business policies contain detailed information on the seller's return policy for domestic and international buyers (if the seller ships internationally), including whether or not the seller accepts returns from domestic and international buyers, how many days the buyer has to return the item for a refund, and who pays the return shipping costs. Multiple return policy business policies can be created and saved at the account level by sellers. Note: As a part of Digital Services Act (DSA) requirements, as of April 3, 2023, buyers in the EU must be allowed to return an item within 14 days or more, unless the item is exempt. Where applicable, sellers should update their return policies to reflect this requirement of accepting returns from EU buyers. This update can be made through the ReturnPolicy container or through a return business policy that is referenced through the SellerProfiles.SellerReturnProfile container. This container is only returned in 'Get' calls if Business Policies are set for the listing and the person making the API call is the seller of the listing. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem AddItems ReviseItem RelistItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents GetMyeBaySelling Conditionally The SellerPaymentProfile container is used in an Add/Revise/Relist/Verify API call to reference and use the settings/values of a payment business policy. Payment business policies contain a setting to control whether immediate payment is required, settings to specify due dates for the deposit and full payment of a motor vehicle listing (Motors policy only), and settings to specify which offline payment methods are avaiable to buyers for sales transactions that happen off of eBay's platform. Multiple payment business policies can be created and saved at the account level by sellers. This container is only returned in 'Get' calls if Business Policies are set for the listing, and the person making the API call is the seller of the listing. Note: Sellers will never have to specify electronic payment methods, but offline payment methods are required for listings where offline payment is required or supported. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem AddItems ReviseItem RelistItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents GetMyeBaySelling Conditionally If present, the site defines category settings for whether the seller can provide their own title for a US or CA eBay Motors listing. Type defining the SellerRatingSummaryArray container that is returned in the GetFeedback response. The SellerRatingSummaryArray container consists of an array of AverageRatingSummary containers, which provide details on Detailed Seller Ratings (DSRs), including the type of rating (Communication, Item As Described, Shipping and Handling Charges, or Shipping Time), the seller's average rating for that DSR type, the total number of DSR ratings, and the period in which those ratings were received (the last year or the last 30 days). Container consisting of a seller's Detailed Seller Rating (DSR) for each type of rating (Communication, Item As Described, Shipping and Handling Charges, or Shipping Time), the seller's average rating for each DSR type, the total number of DSR ratings for each DSR type, and the period in which those ratings were received (the last year or the last 30 days). GetFeedback Conditionally

DetailLevel: none, ReturnAll

Details the recoupment policy on this site. There are two sites involved in recoupment - the listing site and the user registration site, each of which must agree before eBay enforces recoupment for a seller and listing. Indicates whether recoupment policy is enforced on the site on which the item is listed. GeteBayDetails Always Indicates whether recoupment policy is enforced on the registration site for which the call is made. GeteBayDetails Always Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. GeteBayDetails Always Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. GeteBayDetails Always Type defining the SellerReturnPreferences container, which consists of the OptedIn flag that indicates whether or not the seller has opted in to eBay Managed Returns. This flag indicates whether or not an eligible seller has opted in to eBay Managed Returns through the Return Preferences of My eBay. GetUserPreferences Conditionally Type defining the SellerReturnProfile container, which is used in an Add/Revise/Relist/Verify Trading API call to reference a return policy business policy. Return policy business policies contain detailed information on the seller's return policy for domestic and international buyers (if the seller ships internationally), including whether or not the seller accepts returns from domestic and international buyers, how many days the buyer has to return the item for a refund, and who pays the return shipping costs. The unique identifier of a return policy business policy. A ReturnProfileID and/or a ReturnProfileName value is used in the Add/Revise/Relist/Verify call to reference and use the return policy settings/values of a return policy business policy. If both fields are provided and their values don't match, the ReturnProfileID takes precedence. Return policy profile IDs can be retrieved with the getReturnPolicies call of the Account API or with the getSellerProfiles call of the Business Policies Management API. Business policy IDs can also be retrieved through the Business policies section of My eBay. In the 'Get' calls, the ReturnProfileID value will always be returned if business policies are set for the listing, and the person making the API call is the seller of the listing. The ReturnProfileName value will be returned if a name is assigned to the return policy business policy. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem AddItems ReviseItem RelistItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents GetMyeBaySelling Conditionally The name of a return policy business policy. A ReturnProfileID and/or a ReturnProfileName value is used in the Add/Revise/Relist/Verify call to reference and use the return policy settings/values of a return policy business policy. If both fields are provided and their values don't match, the ReturnProfileID takes precedence. In the 'Get' calls, the ReturnProfileID value will always be returned if business policies are set for the listing, and the person making the API call is the seller of the listing. The ReturnProfileName value will be returned if a name is assigned to the return policy business policy. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem AddItems ReviseItem RelistItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents GetMyeBaySelling Conditionally Specifies 1 year feedback metrics for a seller. Count of positive feedback entries given as a seller. GetFeedback

DetailLevel: none, ReturnAll

Conditionally Count of negative feedback entries given as a seller. GetFeedback

DetailLevel: none, ReturnAll

Conditionally Count of neutral feedback entries given as a seller. GetFeedback

DetailLevel: none, ReturnAll

Conditionally Percentage of leaving feedback as a seller. GetFeedback

DetailLevel: none, ReturnAll

Conditionally Number of buyers who bought more than once from this seller. GetFeedback

DetailLevel: none, ReturnAll

Conditionally Percentage of repeat buyers. GetFeedback

DetailLevel: none, ReturnAll

Conditionally Count of unique buyers from this seller. GetFeedback

DetailLevel: none, ReturnAll

Conditionally Percentage of number of times a member has sold successfully vs. the number of times a member has bought an item in the preceding 365 days. GetFeedback

DetailLevel: none, ReturnAll

Conditionally The count of Cross-Border Trade order line items. GetFeedback

DetailLevel: none, ReturnAll

Conditionally The percentage of order line items that are Cross-Border Trade order line items. GetFeedback

DetailLevel: none, ReturnAll

Conditionally Type defining the SellerShippingProfile container, which is used in an Add/Revise/Relist Trading API call to reference a shipping business policy. Shipping business policies contain detailed information on domestic and international shipping, including shipping service options and costs, handling time, shipping discount inormation, and excluded ship-to locations. The unique identifier of a shipping business policy. A ShippingProfileID and/or a ShipppingProfileName value is used in the Add/Revise/Relist/Verify call to reference and use the shippping-related settings/values of a shipping business policy. If both fields are provided and their values don't match, the ShipppingProfileID takes precedence. Shipping profile IDs can be retrieved with the getFulfillmentPolicies call of the Account API or with the getSellerProfiles call of the Business Policies Management API. Business policy IDs can also be retrieved through the Business policies section of My eBay. In the 'Get' calls, the ShipppingProfileID value will always be returned if business policies are set for the listing, and the person making the API call is the seller of the listing. The ShipppingProfileName value will be returned if a name is assigned to the shipping business policy. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem AddItems ReviseItem RelistItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents GetMyeBaySelling Conditionally The name of a shipping business policy. A ShippingProfileID and/or a ShippingProfileName value is used in the Add/Revise/Relist/Verify call to reference and use the shipping-related settings/values of a shipping business policy. If both fields are provided and their values don't match, the ShippingProfileID takes precedence. In the 'Get' calls, the ShippingProfileID value will always be returned if business policies are set for the listing, and the person making the API call is the seller of the listing. The ShippingProfileName value will be returned if a name is assigned to the shipping business policy. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally AddItem AddItems ReviseItem RelistItem VerifyAddItem VerifyRelistItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents GetMyeBaySelling Conditionally Information about a user returned in the context of an item's seller. Indicates whether the seller allows buyers to edit the total cost of an item during checkout. Note: The SellerInfo container and its child fields will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList SellerInfo

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always Currency type in which the user is billed seller fees. GetItem Conditionally This flag indicates whether or not the seller's Checkout Enabled preference is turned on. Note: The SellerInfo container and its child fields will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList SellerInfo

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always This boolean field indicates whether or not the seller has stored bank account information on file with eBay. Note: The SellerInfo container and its child fields will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetSellerList SellerInfo

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This boolean field indicates whether or not the seller is in good standing with eBay. Note: The SellerInfo container and its child fields will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList SellerInfo

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always This field is deprecated. Indicates whether the user is subject to VAT. Users who have registered with eBay as VAT-exempt are not subject to VAT. Note: The SellerInfo container and its child fields will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList SellerInfo

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always This field is deprecated. 773 Avoid 889 This enumeration value indicates the user's eBay PowerSeller tier. Note: The SellerInfo container and its child fields will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetBidderList Always GetSellerList SellerInfo

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Address used by eBay for purposes of billing the user for seller fees. GetUser

DetailLevel: ReturnAll

Conditionally Container for scheduling limits for the user. Conveys the minimum and maximum minutes the user may schedule listings in advance, as well as the maximum number of items the user may schedule at any given time. GetUser

DetailLevel: none, ReturnAll

Conditionally Boolean value indicates whether or not the seller is an eBay Store owner. Note: The SellerInfo container and its child fields will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetBidderList Always GetSellerList SellerInfo

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

The URL for the seller's eBay Store. This field is only returned if the seller is a store owner (look for a value of <code>true</code> in the SellerInfo.StoreOwner field). Note: The SellerInfo container and its child fields will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList SellerInfo

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This enumeration value indicates the type of eBay account used by the seller. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally If true, the user is registered as a vehicle dealer on the eBay Motors site. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This enumeration value indicates the eBay marketplace hosting the seller's eBay Store. GetUser Conditionally This enumeration value indicates the default payment method that the seller is using to pay eBay fees. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Indicates whether or not the seller is a registered charity seller. If CharityRegistered is <code>false</code>, the user must register their nonprofit organization with the PayPal Giving Fund to list eBay for Charity items. eBay for Charity https://pages.ebay.com/help/sell/nonprofit.html GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Always If this field is <code>true</code>, the user is exempt from the requirement to offer at least one safe payment method when listing items. Note: The SellerInfo container and its child fields will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. false GetBidderList Always Seller

DetailLevel: none, ReturnAll

GetItem Always Seller

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription,ReturnAll

GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Always GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always This container consists of one or more of nonprofit organizations associated with the seller's account. This container will not be returned if the user is not affiliated with any nonprofit organizations. A seller must be registered with the PayPal Giving Fund to be affiliated with an eBay for Charity nonprofit organization. eBay for Charity https://pages.ebay.com/help/sell/nonprofit.html GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Percentage of the number of times a member has sold successfully vs. the number of times a member has bought an item in the preceding 365 days. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Contains eligibility details about seller- or platform-based features. This is returned only if the IncludeFeatureEligibility field is included and set to <code>true</code> in the request. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally This boolean field indicates if the seller is certified as a Top Rated Seller. Only Top Rated Sellers can qualify for Top Rated Plus listings, which receive the Top Rated Plus seal and other benefits. This field is only returned for the following sites: US, Germany, Austria, Switzerland, UK, Ireland, and Australia. The Top Rated Seller and Top Rated Plus listing requirements will differ by site. Below are some links to Help pages that discuss these requirements: <ul> <li>eBay US: <a href="https://www.ebay.com/help/policies/selling-policies/seller-standards-policy?id=4347&#section3">Requirements to become Top Rated</a></li> <li>eBay UK/IE: <a href="https://www.ebay.co.uk/help/policies/selling-policies/seller-standards-policy?id=4347&#section3">Requirements to become Top Rated and the eBay Premium Service</a></li> <li>eBay DE/AT/CH: <a href="https://pages.ebay.de/help/sell/top-rated/2.html"> Anforderungen fur den Verkaufer mit Top-Bewertung</a></li> <li>eBay AU: <a href="https://www.ebay.com.au/help/policies/selling-policies/seller-standards-policy?id=4347&#section3"> Requirements to become Top Rated</a></li> </ul> Top Rated Sellers, registered in the US, can qualify for Top Rated Seller programs in other countries as long as they meet the selling requirements in those countries. However, even if US sellers qualify for programs in other countries, they will not receive the Final Value Fee discount on sales in those countries. Note: The SellerInfo container and its child fields will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetBidderList Conditionally GetSellerList SellerInfo

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Conditionally Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Contains Top Rated Seller program details for the seller. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally The list of the sites where a seller has agreed to the cross-border recoupment terms. 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. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Always A returned value of <code>true</code> indicates that the seller has configured a default, domestic shipping rate table in their My eBay shipping preferences. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally A returned value of <code>true</code> indicates that the seller has configured a default, international shipping rate table in their My eBay shipping preferences. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Contains various details about the current status of a listing. These values are computed by eBay and cannot be specified at listing time. Number of bids placed so far against the auction item. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Variation Conditionally GetMyeBayBuying BidList LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList UnsoldList DeleteFromUnsoldList BidList Variations

DetailLevel: none, ReturnAll

Conditionally GetBidderList Always GetItemTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Item.SellingStatus Conditionally GetSellerTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Always GetSellerEvents

DetailLevel: none, ReturnAll

Item Conditionally The minimum amount a progressive bid must be above the current high bid to be accepted. This field is only applicable to auction listings. The value of this field will always be '0.00' for Classified Ad and fixed-price listings. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Variation Conditionally GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Always Converted value of the CurrentPrice in the currency of the site that returned this response. For active items, refresh the listing's data every 24 hours to pick up the current conversion rates. Only returned when the item's CurrentPrice on the listing site is in different currency than the currency of the host site for the user/application making the API call. ConvertedCurrentPrice is not returned for Classified listings (Classified listings are not available on all sites). In multi-variation listings, this value matches the lowest-priced variation that is still available for sale. GetBidderList PlaceOffer Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Conditionally GetItemTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Item.SellingStatus Conditionally GetSellerTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Variation Conditionally GetMyeBayBuying BestOfferList BidList LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList Variations

DetailLevel: none, ReturnAll

Conditionally The current price of the item in the original listing currency. For auction listings, this price is the starting minimum price (if the listing has no bids) or the current highest bid (if bids have been placed) for the item. This does not reflect the BuyItNow price. For fixed-price and ad format listings, this is the current listing price. In multi-variation, fixed-price listings, this value matches the lowest-priced variation that is still available for sale. GetBidderList PlaceOffer Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Always GetItemTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Item.SellingStatus Always GetSellerTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Variation Conditionally GetMemberMessages Conditionally GetMyeBayBuying BestOfferList BidList LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling BidList ActiveList ScheduledList SoldList UnsoldList Variations

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Item Conditionally For ended auction listings that have a winning bidder, this field is a container for the high bidder's user ID. For ended, single-item, fixed-price listings, this field is a container for the user ID of the purchaser. This field isn't returned for auctions with no bids, or for active fixed-price listings. In the case of PlaceOffer, for auction listings, this field is a container for the high bidder's user ID. In the PlaceOffer response, the following applies: For multiple-quantity, fixed-price listings, the high bidder is only returned if there is just one order line item (or only for the first order line item that is created). PlaceOffer Conditionally GetBidderList

DetailLevel: ReturnAll

GranularityLevel: Medium

Variation Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Variation Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Conditionally GetMyeBayBuying BidList LostList WatchList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling BidList ActiveList Variations

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: ReturnAll

Item Conditionally Applicable to Ad type listings only. Indicates how many leads to potential buyers are associated with this item. Returns 0 (zero) for listings in other formats. You must be the seller of the item to retrieve the lead count. GetSellerList

DetailLevel: ReturnAll

Variation Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Conditionally Smallest amount the next bid on the item can be. Returns same value as Item.StartPrice (if no bids have yet been placed) or CurrentPrice plus BidIncrement (if at least one bid has been placed). Only applicable to auction listings. Returns null for fixed-price and Ad type listings. In multi-variation listings, this value matches the lowest-priced variation that is still available for sale. PlaceOffer Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Variation Conditionally GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Always The total number of items purchased so far (in the listing's lifetime). Subtract this from Quantity to determine the quantity available. If the listing has Item Variations, then in GetItem (and related calls) and GetItemTransactions, Item.SellingStatus.QuantitySold contains the sum of all quantities sold across all variations in the listing, and Variation.SellingStatus.QuantitySold contains the number of items sold for that variation. In GetSellerTransactions, Transaction.Item.SellingStatus.QuantitySold contains the number of items sold in that order line item. For order line item calls, also see Transaction.QuantityPurchased for the number of items purchased in the order line item. In multi-variation listings, this value matches total quantity sold across all variations. GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Always GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Item Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Variation Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList SoldList UnsoldList ScheduledList

DetailLevel: none, ReturnAll

Conditionally Indicates whether the reserve price has been met for the listing. Returns true if the reserve price was met or no reserve price was specified. PlaceOffer Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Variation Conditionally GetMyeBayBuying BidList

DetailLevel: none, ReturnAll

Conditionally GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Always GetMyeBaySelling ActiveList BidList ScheduledList SoldList UnsoldList Variations

DetailLevel: none, ReturnAll

Conditionally Part of the Second Chance Offer feature, indicates whether the seller can extend a second chance offer for the item. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Variation Conditionally GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Always Number of bidders for an item. Only applicable to auction listings. Only returned for the seller of the item. GetMyeBaySelling ActiveList UnsoldList Variations

DetailLevel: none, ReturnAll

Conditionally Specifies an active or ended listing's status in eBay's processing workflow. <ul> <li>If a listing ends with a sale (or sales), eBay needs to update the sale details (e.g., total price and buyer/high bidder) and the transaction fees. This processing can take several minutes.</li> <li>If you retrieve a sold item and no details about the buyer/high bidder are returned or no transaction fees are available, use this listing status information to determine whether eBay has finished processing the listing.</li> </ul> GetAllBidders GetBidderList Always GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Always GetItemTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Item.SellingStatus Always GetSellerTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Variation Conditionally GetSellerEvents Item

DetailLevel: none, ReturnAll

Conditionally A seller is changed a Final Value Fee (FVF) when the item is sold, ends with a winning bid, or is purchased. This fee applies whether or not the sale is completed with the buyer and is generated before the buyer makes a payment. The FVF is calculated using a percentage. This percentage is based on whether the seller has a Store subscription or not. If a seller does have a Store subscription, the FVF is calculated based on the level of that plan. For complete information about selling fees and eBay Store subscription plans, see the <a href="http://www.feectr.ebay.com/feecenter/home">Fee Center Home Page</a>. The Final Value Fee for each order line item is returned by GetSellerTransactions, GetItemTransactions, and GetOrders, regardless of the checkout status. If a seller requests a Final Value Fee credit, the value of Transaction.FinalValueFee will not change if a credit is issued. The credit only appears in the seller's account data. See the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/selling-fees?id=4822" target="_blank">Selling fees</a> help page for more information about how Final Value Fees are calculated. GetBidderList Conditionally GetItemTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Item.SellingStatus Conditionally GetSellerTransactions

DetailLevel: none, ReturnAll, ItemReturnDescription

Conditionally If a seller has reduced the price of a listed item with the Promotional Price Display feature, this field contains the original price of the discounted item, along with the start-time and end-time of the discount. GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Variation Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Variation Conditionally GetMyeBayBuying WatchList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList Variations

DetailLevel: none, ReturnAll

Conditionally If included in the response as <code>true</code>, indicates that the listing was administratively canceled due to a violation of eBay's listing policies and that the item can be relisted using RelistItem. Note: GetItem returns an error (invalid item ID) in the response if Item.SellingStatus.AdminEnded = <code>true</code> and the requesting user is not the seller of the item. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Variation Conditionally GetItem Variation Conditionally If this flag appears in the GetItem response, the auction has ended due to the item being sold to a seller using the Buy It Now option. This flag is not relevant for fixed-priced listings. GetItem Conditionally Indicates the total quantity of items sold and picked up by buyers using the In-Store Pickup option. This value is the total number of items purchased by one or more buyers using the In-Store Pickup option, and is not the total number of In-Store Pickup orders. So, if two buyers selected the In-Store Pickup option, but each of these buyers bought a quantity of five of these items (in same purchase), the Item.SellingStatus.QuantitySoldByPickupInStore value would be '10' and not '2'. In the case of multi-variation, fixed-price listings, each Item.Variations.Variation.SellingStatus.QuantitySoldByPickupInStore value indicates the total quantity of that corresponding item variation (for example, large blue shirts) sold and picked up by buyers using the In-Store Pickup option, and the Item.SellingStatus.QuantitySoldByPickupInStore value would be the total quantity of all item variations sold for the listing. This field is returned only if the listing is eligible for In-Store Pickup (EligibleForPickupInStore is returned as <code>true</code>). Note: At this time, the In-Store Pickup feature is generally only available to large retail merchants, and can only be applied to multi-quantity, fixed-price listings. GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always This container is only returned if the buyer is attempting to bid on an auction item. To bid on an auction item, the buyer sets the value of the Offer.Action field to <code>Bid</code>, and sets the maximum bid amount in the Offer.MaxBid field. The SuggestedBidValues container consists of an array of incremental bid values (up to the dollar value in the Offer.MaxBid field) that eBay will bid on behalf of the buyer each time that buyer is outbid for the auction item. PlaceOffer Conditionally Indicates if a listing is on hold due to an eBay policy violation. If a listing is put on hold, users are unable to view the listing details, the listing is hidden from search, and all attempted purchases, offers, and bids for the listing are blocked. eBay, however, gives sellers the opportunity to address violations and get listings fully reinstated. A listing will be ended if a seller does not address a violation, or if the violation can not be rectified. If a listing is fixable, the seller should be able to view the listing details and this boolean will be returned as <code>true</code>. Once a listing is fixed, this boolean will no longer be returned. GetItem GetItems Conditionally Contains summary information about the items the seller is selling. The number of currently active auctions that will sell. That is, there is at least one bidder, and any reserve price has been met. Equivalent to the "Will Sell" value in My eBay. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally The total number of currently active auctions for a given seller. Equivalent to the "Auction Quantity" value in My eBay. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally The total value of all items the seller has for sale in all listings. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally The total number of items the seller has sold. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally https://developer.ebay.com/support/kb-article?KBid=1111 Discrepancies Between Results of GetMyeBaySelling and GetSellerTransactions The total monetary value of the items the seller has sold. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally https://developer.ebay.com/support/kb-article?KBid=1111 Discrepancies Between Results of GetMyeBaySelling and GetSellerTransactions The average duration, in days, of all items sold. GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally Type used by the ServiceCost container to display any service cost to the buyer for an item that will go through the Authenticity Guarantee process. The amount charged to the buyer for any service cost related to an item going through the Authenticity Guarantee process. This amount is given in the currency of the listing site. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The amount (in the buyer's currency) charged to the buyer for any service cost related to an item going through the Authenticity Guarantee process. This amount is only applicable if the buyer resides in another country that uses a different currency than the currency of the listing site. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Specifies the action to take for an item's My eBay notes. Creates or replaces an item's My eBay notes. Note that if the specified item already has notes in My eBay, the new notes will completely replace the existing notes. They will not be appended. Deletes any existing My eBay notes for the specified item. Specifying Delete when no notes exist does nothing, but does not return an error. Reserved for internal or future use. Details pertinent to one or more items for which calculated shipping (or flat rate shipping using shipping rate tables with weight surcharges) has been offered by the seller, such as package dimension and weight and packaging/handling costs. Also returned with the data for an item's transaction. Note: The ShippingPackageDetails container should now be used instead of the CalculatedShippingRate container to specify values for the MeasurementUnit, PackageDepth, PackageWidth, PackageLength, ShippingIrregular, ShippingPackage, WeightMajor, and/or WeightMinor fields. The CalculatedShippingRate container should only be used to specify values for the InternationalPackagingHandlingCosts, and/or PackagingHandlingCosts fields. Specifies the unit type of the weight and dimensions of a shipping package. If MeasurementUnit is used, it overrides the system specified by measurementSystem. If MeasurementUnit and measurementSystem are not specified, the following defaults will be used: English: US Metric: CA, CAFR, AU CA and CAFR supports both English and Metric, while other sites only support the site's default. Use MeasurementUnit with weight and package dimensions. For example, to represent a 5 lbs 2 oz package: <code> <MeasurementUnit>English</MeasurementUnit> <WeightMajor>5</WeightMajor> <WeightMinor>2</WeightMinor> </code> AddItem AddItems RelistItem ReviseItem VerifyAddItem AddFixedPriceItem VerifyAddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem VerifyRelistItem Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-package-size.html Package dimensions and weight Depth of the package, in whole number of inches, needed to ship the item. This is validated against the selected shipping service. Upon mismatch, a message is returned, such as, "Package dimensions exceeds maximum allowable limit for service XXXXX," where XXXXX is the name of the shipping service. For calculated shipping only. Only returned if the seller specified the value for the item. (In many cases, the seller only specifies the weight fields.) Developer impact: UPS requires dimensions for any Ground packages that are 3 cubic feet or larger and for all air packages, if they are to provide correct shipping cost. If package dimensions are not included for an item listed with calculated shipping, the shipping cost returned will be an estimate based on standard dimensions for the defined package type. eBay enforces a dimensions requirement on listings so that buyers receive accurate calculated shipping costs. Note: The unit and measurementSystem attributes associated with this field will be returned by the GetItem call and are automatically derived based on the MeasurementUnit value specified during listing creation or revision. These attributes will be ignored if passed into the request of the AddItem family of calls. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList GetItemShipping Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-package-size.html Package dimensions and weight Length of the package, in whole number of inches, needed to ship the item. Upon mismatch, a message is returned, such as, "Package dimensions exceeds maximum allowable limit for service XXXXX," where XXXXX is the name of the shipping service. For calculated shipping only. Only returned if the seller specified the value for the item. (In many cases, the seller only specifies the weight fields.) Note: The unit and measurementSystem attributes associated with this field will be returned by the GetItem call and are automatically derived based on the MeasurementUnit value specified during listing creation or revision. These attributes will be ignored if passed into the request of the AddItem family of calls. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList GetItemShipping Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-package-size.html Package dimensions and weight Width of the package, in whole number of inches, needed to ship the item. Upon mismatch, a message is returned, such as, "Package dimensions exceeds maximum allowable limit for service XXXXX," where XXXXX is the name of the shipping service. For calculated shipping only. Only returned if the seller specified the value for the item. (In many cases, the seller only specifies the weight fields.) Note: The unit and measurementSystem attributes associated with this field will be returned by the GetItem call and are automatically derived based on the MeasurementUnit value specified during listing creation or revision. These attributes will be ignored if passed into the request of the AddItem family of calls. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList GetItemShipping Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-package-size.html Package dimensions and weight Whether a package is irregular and therefore cannot go through the stamping machine at the shipping service office and thus requires special or fragile handling. For calculated shipping only. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The nature of the package used to ship the item(s). Required for calculated shipping only. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally WeightMajor and WeightMinor are used to specify the weight of a shipping package. WeightMajor is used to specify the weight of the package in pounds (in US) or kilograms (all countries that use metric system). Although MeasureType is of decimal type, decimal values should not be used in WeightMajor and WeightMinor. If a shipping package was 5 pounds and 1.8 ounces, the 1.8 ounces should be rounded up to an even 2 ounces. The same is for kilograms. If the package is 2.267 kilgram, you would round up the grams. Below shows you how to represent a package weight of 5 lbs 2 oz and and 2 kg 3 gr: <code> <WeightMajor unit="lbs">5</WeightMajor> <WeightMinor unit="oz">2</WeightMinor> <WeightMajor unit="kg">2</WeightMajor> <WeightMinor unit="gr">3</WeightMinor> </code> If a package weighed 14 oz or 324 gr, below is how you would represent this weight: <code> <WeightMajor unit="lbs">0</WeightMajor> <WeightMinor unit="oz">14</WeightMinor> <WeightMajor unit="kg">0</WeightMajor> <WeightMinor unit="gr">324</WeightMinor> </code> If a package weighed exactly 2 lbs or 105 kg, below is how you would represent this weight: <code> <WeightMajor unit="lbs">2</WeightMajor> <WeightMinor unit="oz">0</WeightMinor> <WeightMajor unit="kg">105</WeightMajor> <WeightMinor unit="gr">0</WeightMinor> </code> In all cases, both the WeightMajor and WeightMinor should be specified in an Add/Revise/Relist/Verify call, even if either's value is '0'. The WeightMajor and WeightMinor are applicable for calculated shipping or for flat-rate shipping if shipping rate tables are specified and the shipping rate table uses weight surcharges. Note: The unit and measurementSystem attributes associated with this field will be returned by the GetItem call and are automatically derived based on the MeasurementUnit value specified during listing creation or revision. These attributes will be ignored if passed into the request of the AddItem family of calls. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally WeightMajor and WeightMinor are used to specify the weight of a shipping package. WeightMinor is used to specify the weight of the package in ounces (in US) or grams (all countries that use metric system). Although MeasureType is of decimal type, decimal values should not be used in WeightMajor and WeightMinor. If a shipping package was 5 pounds and 1.8 ounces, the 1.8 ounces should be rounded up to an even 2 ounces. The same is for kilograms. If the package is 2.267 kilgram, you would round up the grams. Below shows you how to represent a package weight of 5 lbs 2 oz and and 2 kg 3 gr: <code> <WeightMajor unit="lbs">5</WeightMajor> <WeightMinor unit="oz">2</WeightMinor> <WeightMajor unit="kg">2</WeightMajor> <WeightMinor unit="gr">3</WeightMinor> </code> If a package weighed 14 oz or 324 gr, below is how you would represent this weight: <code> <WeightMajor unit="lbs">0</WeightMajor> <WeightMinor unit="oz">14</WeightMinor> <WeightMajor unit="kg">0</WeightMajor> <WeightMinor unit="gr">324</WeightMinor> </code> If a package weighed exactly 2 lbs or 105 kg, below is how you would represent this weight: <code> <WeightMajor unit="lbs">2</WeightMajor> <WeightMinor unit="oz">0</WeightMinor> <WeightMajor unit="kg">105</WeightMajor> <WeightMinor unit="gr">0</WeightMinor> </code> In all cases, both the WeightMajor and WeightMinor should be specified in an Add/Revise/Relist/Verify call, even if either's value is '0'. The WeightMajor and WeightMinor are applicable for calculated shipping or for flat-rate shipping if shipping rate tables are specified and the shipping rate table uses weight surcharges. Note: The unit and measurementSystem attributes associated with this field will be returned by the GetItem call and are automatically derived based on the MeasurementUnit value specified during listing creation or revision. These attributes will be ignored if passed into the request of the AddItem family of calls. 0 15 for ounces; 999 for grams AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList GetItemShipping Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This type provides information about one or more order line items in a package. Contains information about one order line item in a package. The package can contain multiple units of a given order line item, and multiple order line items. CompleteSale SetShipmentTrackingInfo No This type details the shipping carrier and shipment tracking number associated with a package shipment. It also contains information about the line items shipped through the Global Shipping program. The name of the shipping carrier used to ship the item. This field and the ShipmentTrackingNumber field are mutually dependent. When you submit ShippingCarrierUsed, you must also supply a value for ShipmentTrackingNumber. When you submit ShipmentTrackingNumber, you must also supply a value for ShippingCarrierUsed. When the site ID is Austria, Poland, or UK, ShippingCarrierUsed can be any value, because it is not checked by eBay. For all other sites, only the following characters are allowed: letters (<code>a-z</code>, <code>A-Z</code>), numbers (<code>0-9</code>), space, and dash (<code>-</code>). The site ID is specified in the CompleteSale request header. Note: Commonly used shipping carriers can be found by calling GeteBayDetails with DetailName set to <code>ShippingCarrierDetails</code> and examining the returned ShippingCarrierDetails.ShippingCarrier field. <a href="https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/types/ShippingCarrierCodeType.html">ShippingCarrierCodeType</a> also has a list of valid shipping carriers, but eBay cannot guarantee that this enumerated type contains a full, updated list of shipping carriers. For the CompleteSale call: <ul> <li>This field is not case sensitive in the CompleteSale request.</li> <li>When using UPS Mail Innovations, supply the value <code>UPS-MI</code>. Buyers will subsequently be sent to the UPS Mail Innovations website for tracking status. </li> <li>When using FedEx SmartPost, supply the value <code>FedEx</code>. Buyers will subsequently be sent to the FedEx web site for tracking status. </li> </ul> For the Get calls: When using the Global Shipping Program, this field returns a value of <code>PBI</code>. ShippingCarrierCodeType CompleteSale SetShipmentTrackingInfo Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally The tracking number assigned by the shipping carrier to the item shipment. This field and the ShippingCarrierUsed field are mutually dependent. When you submit ShipmentTrackingNumber, you must also supply a value for ShippingCarrierUsed. When you submit ShippingCarrierUsed, you must also supply a value for ShipmentTrackingNumber. 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. For order management calls, For GetOrders, GetSellerTransactions, and GetItemTransactions only: This field is only returned if a valid tracking number is set. With the exception of the GetSellerTransactions (where it is only returned to the seller and not buyer), the tracking number will only be returned to the seller or buyer. If a user is using a Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, this field is returned to third parties, but the string value returned in the field will be <code>Unavailable</code>. Note: The Trading API only supports alphanumeric characters for shipment tracking numbers, and any other characters are not supported, including spaces, hyphens, and all other special characters. Users should not enter spaces even if spaces are shown for the tracking number on the shipping label. CompleteSale SetShipmentTrackingInfo Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally Contains information about one or more order line items in a Global Shipping Program package. Required or returned if the value of ShippingCarrierUsed is <code>PBI</code>. CompleteSale SetShipmentTrackingInfo No Type defining the Shipment container, which is used by the seller in CompleteSale to provide shipping information. The date and time that the seller handed off the package(s) to the shipping carrier. If this field is not included in the request, the timestamp of the call execution is used as the shipped time. Note that sellers have the ability to set this value up to 3 calendar days in the future. SetShipmentTrackingInfo No CompleteSale No Container consisting of the tracking number and shipping carrier associated with the shipment of one item (package). Because an order can have multiple line items and/or packages, there can be multiple ShipmentTrackingDetails containers under the Shipment container. CompleteSale SetShipmentTrackingInfo No GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally Identifies a shipping carrier used to ship an order, and the countries served by that carrier. Note: Commonly used shipping carriers can also be found by calling GeteBayDetails with DetailName set to ShippingCarrierDetails and examining the returned ShippingCarrierDetails.ShippingCarrier field. United Parcel Service In CompleteSale call requests, the value <code>UPS</code> also represents UPS Mail Innovations. Available in US, IE, UK, FR, IT, DE, CH, ES, AT, CN, BE, PL, NL. U.S. Postal Service   Available in US, CN, UK, DE. FedEx   In CompleteSale call requests, the value <code>FedEx</code> also represents FedEx SmartPost. Available in US, IE, UK, FR, IT, DE, CH, AU, ES, AT, CN, BE, PL, NL. Deutsche Post   Available in US, UK, DE. DHL Express   Available in IE, US, ID, MX, MY, CA, UK, FR, IT, HK, TW, DE, CH, KR, AU, ES, AT, CN, SG, BE, TH, NL. Hermes Group   Available in US, AT, UK, DE. iloxx eService   Available in US, UK, DE. Use this code for any carrier not listed here. Coliposte Domestic   Available in US, UK, DE. Coliposte International   Available in US, UK, DE. Chronopost   Available in US, FR, UK, DE. Correos   Available in ES, US, UK, DE. Seur (reserved for future use). Nacex   Available in ES, US, UK, DE. 4PX   Available in US. 4PX China   Available in US, CN, UK. 4PX Express   Available in UK, DE. 4PX Express Co. Ltd   Available in US, UK, DE. n/a   Not currently supported. A-1 Courier   Available in US. ABF Freight   Available in US. AeroPost   Available in JM, GT, CR, PA, TT, SV, CO, HN, CL, DO. Allied Express   Available in AU. AMWST   Available in US. An Post   Available in IE. APC Postal Logistics   Available in UK. Aramex   Available in US, BH, IL, AE, IN, UA, KW, SA, QA. Arvato   Available in US, CA, UK, FR, IT, GR, DE, CH, AT, BE, NL, SI, LT, SK. ASM   Available in ES. Australia Post   Available in US, UK, DE, AU. Australian Air Express   Available in AU. Averitt Express   Available in US. bpost   Also coded as <code>BELGIANPOST</code>. Available in US, UK, DE, MO, BE. BRT Bartolini   Available in IT. Belgian Post Group   Also coded as <code>BPost</code>. Available in US, UK, DE MO, BE. BKNS   Available in US. Blue Package Delivery   Available in US. BusinessPost   Available in UK. Canpar Courier   Available in US, CA, IT, UK, DE, AU Central Freight Lines   Available in US. CEVA Logistics   Available in US, IT. China Post   Available in US, UK, DE. Chronoexpres   Available in ES. Chukou1   Available in US. Chunghwa Post   Available in US, UK, DE. CitiPost   Available in US, IE, CA, UK, FR, IT, HK, DE, AU, ES, CN, BE, UZ, PL, NL. Citylink   Available in IE. Click & Quick   Available in IT. XPO Logistics (formerly Con-way Freight)   Con-way Freight is now part of XPO Logistics. Available in US. Colissimo   Available in FR. CollectPlus   Available in UK. CPC Logistics   Available in US, CA, UK, DE. DAI Post   Available in UK, AU. Day & Ross   Available in US, CA, UK, AU. DB Schenker   Available in US. DHL Express   Available in IT, DE. DHL Global Mail   Formerly coded as <code>DHLG</code>. Available in US, UK, DE. DHL EKB   Available in US. n/a   Use <code>DHLGlobalMail</code> instead. Die Schweizerische Post   Available in CH. DPD (Dynamic Parcel Distribution)   Available in IE, BG, AT, UK, HR, BE, HU, PL, CZ, DE, NL, CH. DPX Thailand   Available in US, TH. n/a   Not currently supported. E-go   Available in AU. n/a   Not currently supported. DPD France (formerly Exapaq)   Exapaq is now part of DPD France. Available in FR. Fastway   Available in IE. Fastway Couriers   Available in AU. FedEx SmartPost   In CompleteSale call requests only, specify FedEx SmartPost with the value <code>FedEx</code>. Available in US, UK, DE. Flyt   Available in US. Flyt Express   Available in UK, DE. Flyt Express US Direct line   Available in US, UK, DE. n/a   Not currently supported. FulfilExpress-AccStation   Available in US, UK, DE. FulfilExpress-eForCity   Available in US, UK, DE. FulfilExpress-EverydaySource   Available in US, UK, DE. FulfilExpress-iTrimming   Available in US, UK, DE. GLS (General Logistics Systems)   Available in IE, ES, AT, IT, FR, BE, DE, NL. MXD Group (formerly Home Direct USA)   Home Direct USA is now part of MXD Group. Available in US. n/a Use <code>Yodel</code> instead. Hong Kong Post   Available in US, UK, DE, AU. Hunter Express   Available in AU. India Post   Available in US, UK, DE. Indonesia Post   Available in US, UK, DE. Interlink Express   Available in UK. InterPost   Available in IE, US, CA, UK, FR, IT, HK, DE, RO, AU, ES, AT, CN, CY, BE, PL, NL. IoInvio   Available in IT. UPS i-parcel   Available in US, MX, MY, SG, HK, ZA, TR, CH, JP, BR. Israel Post   Available in US. Japan Post   Available in US, UK, DE. Kiala (UPS Access Point)   Available in ES, US, FR, UK, BE, DE, NL. Korea Post   Available in US, UK, DE. La Poste   Available in US, FR, UK, DE. Landmark Global   Available in US, NZ, NO. n/a   Not currently supported. n/a   Not currently supported. Malaysia Post   Available in US, UK, DE. Manna Distribution Services   Available in US. Metapack   Available in UK. MNG Kargo   Available in US, UK, TR. Mondial Relay   Available in FR. MRW   Available in ES. MSI Transportation   Available in US. New England Motor Freight   Available in US. Old Dominion Freight Line   Available in US. n/a   Not currently supported. OnTrac Shipping   Available in US. Osterreichische Post   Available in AT. UPS Freight (formerly Overnite)   Overnite is now part of UPS Freight. Available in US. International Bridge Domestic delivery   Available in US. Parcelforce   Available in US, UK, DE. PHLPost (Philippine Postal Corporation)   Available in US, UK, DE. Pilot Freight Services   Available in US. PITT OHIO   Available in US. Poczta Polska   Available in PL. Pocztex   Available in PL. Post Italiano   Available in US, UK, DE. PostNL   Available in NL. PostNord   Available in UK, NO. Poste Italiane   Available in IT. LaserShip (formerly Prestige Expedite)   Prestige Expedite is now part of LaserShip. Available in US. Quantium Solutions   Available in US, UK, DE, AU. Reddaway   Available in US. Royal Mail   Available in US, UK, DE. n/a   Not currently supported. Saia LTL Freight   Available in US. SDA Express Courier   Available in IT. n/a   Not currently supported. n/a   Not currently supported. Singapore Post   Available in US, UK, DE. Siodemka (DPD Poland)   Available in PL. Sioli & Fontana   Available in US, CA, IT. Skynet (Malaysia)   Available in US, MY. Smart Send Courier Service   Available in AU. SGT Corriere Espresso   Available in IT. Spediamo   Available in IT. Spee-Dee Delivery Service   Available in US. StarTrack   Available in AU. Suntek Express LTD   Available in US, UK, DE. Swiss Post   Available in US, UK, CH. TELE   Available in US. Temando (shipping broker)   Available in AU. Thailand Post   Available in US, UK, DE. n/a   Not currently supported. n/a   Not currently supported. n/a   Not currently supported. Toll (Japan Post)   Available in AU. TPG Logistics   Available in US, UK, DE. n/a   Not currently supported. UBI Smart Parcel   Available in US. UK Mail   Available in UK. UPS Mail Innovations   In CompleteSale call requests only, specify UPS Mail Innovations with the value <code>UPS</code>. Available in US, UK, DE. n/a   Not currently supported. n/a   Not currently supported. USPS Commercial ePacket   Available in US, CA. USPS Priority Mail International   Available in US, CA. Vietnam Post   Available in US, UK, DE. Vitran Express   Available in US. n/a   Not currently supported. WIN.IT America   Available in US, UK, DE, AU. n/a   Not currently supported. wnDirect   Available in US, CA, IT, FR, UK, RU, AU. WPX Delivery Solutions   Available in US. YANWEN Express   Available in US, UK, DE. Yodel   Available in UK. YRC Freight   Available in US. Reserved for internal or future use Details about type of Carrier used to ship an item. Numeric identifier. Some applications use this ID to look up shipping Carriers more efficiently. GeteBayDetails Conditionally Display string that applications can use to present a list of shipping carriers in a more user-friendly format (such as in a drop-down list). GeteBayDetails Conditionally The code for the shipping carrier. Note: Commonly used shipping carriers can also be found by calling GeteBayDetails with DetailName set to <code>ShippingCarrierDetails</code> and examining the returned ShippingCarrierDetails.ShippingCarrier field. GeteBayDetails Conditionally Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always This type defines the ShippingCategoryDetails container. When the DetailName field is set to ShippingCategoryDetails in a GeteBayDetails request, one ShippingCategoryDetails container is returned for each valid shipping category used on the eBay site. Besides being useful to view the list of valid shipping categories, this container is also useful to discover when the last update to shipping categories was made by eBay. Indicates the shipping category. Shipping categories include the following: ECONOMY, STANDARD, EXPEDITED, ONE_DAY, PICKUP, OTHER, and NONE. International shipping services are generally grouped into the NONE category. For more information on these shipping categories, and which services fall into which category, see the <a href="http://pages.ebay.com/sellerinformation/shipping/chooseservice.html">Shipping Basics</a> page on the eBay Shipping Center site. Note: This field is returned only for those sites that support shipping categories: US (0), CA (2), CAFR (210), UK (3), AU (15), FR (71), DE (77), IT (101) and ES (186). GeteBayDetails Conditionally Display string that applications can use to present a list of shipping categories in a more user-friendly format (such as in a drop-down list). This field is localized per site. GeteBayDetails Conditionally The current version number for shipping categories. Sellers can compare this version number to their version number to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always Indicates the time of the last version update. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always This enumerated type contains the values that specify the party (seller/buyer) who will be responsible for paying the return shipping cost if an item is returned. One of these values is set by the seller when establishing/setting a return policy for an item. Note: The GeteBayDetails call returns site-default Return Policy settings. For most categories within a given eBay site, the supported Return Policy options/values are the same, but there a few exceptions. To discover what return shipping 'payee' values that a particular category supports, call GetCategoryFeatures and include <code>DomesticReturnsShipmentPayeeValues</code> and/or <code>InternationalReturnsShipmentPayeeValues</code> as FeatureID values to see the return shipping 'payee' values available for domestic and international returns, respectively. EUBuyer_CancelRightsUnder40, EUSeller_CancelRights, EUSeller_ReturnRights This value indicates that the buyer is responsible for paying the return shipping cost. Note that the buyer will not be responsible for return shipping cost if the the buyer's reason for the return is related to the received item not being as described in the listing, or if the item has arrived damaged or with missing parts. This value indicates that the seller is responsible for paying the return shipping cost. (out) Reserved for internal or future use. This value is no longer applicable. This value is no longer applicable. This value is no longer applicable. This type defines the ShippingCostPaidBy container that is returned in GeteBayDetails if ReturnPolicyDetails is set as a DetailName value (or if no value is included in the request). Note: The GeteBayDetails call returns site-default Return Policy settings. For most categories within a given eBay site, the supported Return Policy options/values are the same, but there a few exceptions. To discover what return shipping 'payee' values that a particular category supports, call GetCategoryFeatures and include <code>DomesticReturnsShipmentPayeeValues</code> and/or <code>InternationalReturnsShipmentPayeeValues</code> as FeatureID values to see the return shipping 'payee' values available for domestic and international returns, respectively. The party who pays the shipping cost for a returned item. This value can be passed in the Add/Revise/Relist calls. ShippingCostPaidByOptionsCodeType GeteBayDetails Conditionally Display string that applications can use to present ShippingCostPaidByOption in a more user-friendly format (such as in a drop-down list). Not applicable as input to the Add/Revise/Relist calls. (Use ShippingCostPaidBy instead.) GeteBayDetails Conditionally Type defining the ShippingDetails container, which contains the shipping-related details for an order line item (pre-checkout) or order (post-checkout). IMPORTANT: To avoid loss of shipping details when revising a listing, you must include all ShippingDetails fields that were originally provided. Do not omit any tag, even if its value does not change. Omitting a shipping field when revising an item will remove that detail from the listing. This field is deprecated and has been replaced by the ShippingDetails.PaymentEdited field. This field is deprecated. 663 NoOp 759 Note: The Global Shipping Program (GSP) is only available on the UK marketplace. On the US marketplace, the Global Shipping Program was replaced by the intermediated international shipping program called eBay International Shipping. eBay International Shipping is an account level setting, and no field will need to be set in a add/revise call to enable this setting. As long as the US seller's account is opted in to eBay International Shipping, this shipping option will be automatically enabled for all listings where international shipping is available. Even if the US seller is opted into eBay International Shipping, that same seller can still also specify individual international shipping service options through the ShippingDetails.InternationalShippingServiceOption container. In an Add/Revise/Relist call, this boolean field can be included and set to <code>True</code> if the seller would like to use eBay's Global Shipping Program for orders that are shipped internationally. In 'Get' calls, if this field is returned as <code>True</code>, it indicates that international shipping through the Global Shipping Program is available for the listing. If this field is returned as <code>False</code>, the seller is responsible for shipping the item internationally using one of the specified international shipping service options set for the listing. When calling RelistFixedPriceItem, RelistItem, ReviseFixedPriceItem or ReviseItem, you can omit this field if its value doesn't need to change. AddFixedPriceItem VerifyAddFixedPriceItem AddItem VerifyAddItem AddItems RelistFixedPriceItem RelistItem VerifyRelistItem ReviseFixedPriceItem ReviseItem Conditionally GetItem GetSellerList GetMyeBaySelling

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally Details pertinent to one or more items for which calculated shipping has been offered by the seller, such as package dimension and weight and packaging/handling costs. If your call specifies a large-dimension item listed with UPS, see <a href= "https://developer.ebay.com/support/kb-article?KBid=1159" >Dimensional Weight limit on UPS shipping services results in failure of shipping calculator</a>. Note: The CalculatedShippingRate container should only be used to specify values for the InternationalPackagingHandlingCosts and/or PackagingHandlingCosts fields. The rest of the fields in the CalculatedShippingRate container are used to specify package dimensions and package weight, and these values should now be specified in the ShippingPackageDetails container instead. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemShipping Conditionally GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Indicates whether the seller specified payment and shipping instructions during checkout. Note: This field is deprecated and will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetItemShipping Conditionally Whether the seller allows the buyer to edit the payment amount for the order. (Sellers enable this property in their My eBay user preferences on the eBay site.) GetItemShipping Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This container shows sales tax information for an item in a specific tax jurisdiction. The concept of 'sales tax' is only applicable to eBay US and Canada (English and French) sites. This container can be used in an Add/Revise/Relist/Verify call to set sales tax settings for a specific tax jurisdiction, but it is actually a better practice if a user sets up sales tax rates through the Sales Tax Table tool in My eBay (or by using the SetTaxTable call). A seller's Sales Tax Table is applied to the listing by including the UseTaxTable field in the request and setting its value to <code>true</code>. The GetTaxTable call can be used to retrieve the current sales tax rates for different tax jurisdictions. This container is only returned in order management 'Get' calls if sales tax is applicable to the order line item. For eBay Collect and Remit states, the sales tax information is displayed in the Transaction.Taxes container instead. Note: Buyers in all 50 US states and DC are automatically charged sales tax for eBay purchases, and eBay collects and remits this sales tax to the proper taxing authority on the buyer's behalf. Because of this, if a sales tax percentage rate is applied to a listing by a seller in one of these states, this field will be ignored during the checkout process. Currently, sales tax percentage rates can only be specified by sellers in Canada and 5 US territories, including American Samoa (AS), Guam (GU), Northern Mariana Islands (MP), Palau (PW), and Virgin Islands (VI). AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetBidderList GetItemShipping Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Multi-jurisdiction sales tax https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/taxes.html For most applicable calls, returns the words No Error or returns an error message related to an attempt to calculate shipping rates. For calculated shipping only. The message text explains that a postal code is needed to calculate shipping. Only returned when ItemDetails is set to <code>Fine</code>. GetItemShipping Conditionally A shipping rate scale for shipping through USPS that affects the shipping cost calculated for USPS (lower if ShippingRateType is <code>DailyPickup</code>). ShippingRateType is returned only if the value of ShippingService is one of the USPS shipping services. For calculated shipping only. GetItemShipping Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-ups.html UPS rate scales This container is used to provide details on a specific domestic shipping service option, including the unique identifier of the shipping service option and the costs related to domestic shipping service. A separate ShippingServiceOptions container is needed for each domestic shipping service option that is available to ship the item. Unless a fulfillment business policy is being used, at least one ShippingServiceOptions or InternationalShippingServiceOption container will be required. If you specify multiple ShippingServiceOptions nodes, the repeating nodes must be contiguous. For example, you can insert InternationalShippingServiceOption nodes after a list of repeating ShippingServiceOptions nodes, but not between them: <code> <ShippingServiceOptions>...</ShippingServiceOptions> <ShippingServiceOptions>...</ShippingServiceOptions> <ShippingServiceOptions>...</ShippingServiceOptions> <InternationalShippingServiceOption>...</InternationalShippingServiceOption> <InternationalShippingServiceOption>...</InternationalShippingServiceOption> </code> If you specify ShippingDetails when you revise or relist an item but you omit ShippingServiceOptions, eBay will drop the domestic shipping services from the listing. This may also have unintended side effects, as other fields that depend on this data may be dropped as well. To retain the shipping services and dependent fields when you modify other shipping details, it may be simplest to specify all ShippingDetails that you still want to include in the listing. A seller can offer up to four domestic shipping services and up to five international shipping services. However, if the seller is opted in to the Global Shipping Program or eBay International Shipping, only four other international shipping services may be offered (regardless of whether or not Global Shipping shipment or eBay International Shipping is offered for the listing). All specified domestic and international shipping services must be the same shipping type (for example, Flat versus Calculated). Note: If the seller has set the shipping cost model to 'Flat' or 'Calculated' (ShippingDetails.ShippingType field), at least one actual shipping service option must be specified through a ShippingServiceOptions container. In the past, eBay allowed users to set the shipping cost model to 'Flat' or 'Calculated', and then just pass in one ShippingServiceOptions container with the ShippingServiceOptions.ShipppingService value set to a 'Local Pickup' option. Now, sellers must pass in at least one actual domestic shipping service option in addition to any 'Local Pickup' option, or the listing will be blocked with the following error: 17510 - You must specify at least one domestic shipping service, other than or in addition to Local Pickup. For GetItemShipping, results are filtered: if any service is not available in the buyer's region, it is removed. If no services remain after this filtering, a warning is returned. GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Always AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetMyeBayBuying BestOfferList BidList DeletedFromWonList WonList WatchList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemShipping

DetailLevel: none

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally AddOrder No https://developer.ebay.com/api-docs/user-guides/static/make-a-call/tapi-validation.html#unbounded Repeating (unbounded) fields rules regarding repeating instances of a nodes (nodes for which maxOccurs is "unbounded" or is greater than 1) Shipping costs and options related to an international shipping service. Unless a fulfillment business policy is being used, at least one ShippingServiceOptions or InternationalShippingServiceOption container will be required. If you specify multiple InternationalShippingServiceOption nodes, the repeating nodes must be contiguous. That is, you cannot insert other nodes between InternationalShippingServiceOption nodes. All specified domestic and international shipping services must be the same shipping type (for example, Flat versus Calculated). A seller can offer up to four domestic shipping services and up to five international shipping services. However, if the seller is opted in to the Global Shipping Program or eBay International Shipping, only four other international shipping services may be offered (regardless of whether or not Global Shipping or eBay International Shipping is offered for the listing). If you specify ShippingDetails when you revise or relist an item but you omit InternationalShippingServiceOption, eBay will drop the international shipping services (except the Global Shipping Program or eBay International Shipping) from the listing. This may also have unintended side effects, as other fields that depend on this data may be dropped as well. To retain the shipping services and dependent fields when you modify other shipping details, it may be simplest to specify all ShippingDetails that you still want to include in the listing. For GetItemShipping, results are filtered: if any service is not available in the buyer's region, it is removed. If no services remain after this filtering, a warning is returned. AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList GetItemShipping

DetailLevel: none

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally GetMyeBayBuying BestOfferList BidList DeletedFromWonList WonList WatchList

DetailLevel: none, ReturnAll

Conditionally https://developer.ebay.com/api-docs/user-guides/static/make-a-call/tapi-validation.html#unbounded Repeating (unbounded) fields rules regarding repeating instances of a nodes (nodes for which maxOccurs is "unbounded" or is greater than 1) The shipping cost model offered by the seller. This is not returned for various calls since shipping type can be deduced: if a CalculatedShippingRate structure is returned by the call, the shipping type is Calculated. Otherwise, it is one of the other non-Calculated shipping types. GetItemShipping and GetItemTransactions: If the type was a mix of flat and calculated services, this is set simply to Flat or Calculated because it is the buyer's selection that results in one of these. GetMyeBayBuying: If the seller has set the ShipToLocation to <code>Worldwide</code> for an item, but has not specified any international shipping service options, <code>NotSpecified</code> is returned as the ShippingType value. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Free, Freight No GetItemShipping Always Free, Freight GetBidderList Free Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Free, Freight Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ReturnAll

Free, Freight Conditionally GetMyeBayBuying GetMyeBaySelling Free, Freight Conditionally The sale record ID. Applicable to Selling Manager users. When an item is sold, Selling Manager generates a sale record. A sale record contains buyer information, shipping, and other information. A sale record is displayed in the Sold view in Selling Manager. Each sale record has a sale record ID. In the following calls, the value for the sale record ID is in the SellingManagerSalesRecordNumber field: GetItemTransactions, GetSellerTransactions, and GetOrders. For GetOrders and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the real record number is only returned to the buyer or seller, and a dummy value of <code>0</code> will be returned to all third parties. The sale record ID can be for a single or a multiple line item order. Note: For the GetItemTransactions and GetOrderscalls, this field is only returned to the seller of the order; this field is not returned for the buyer or third party. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Note: This field is deprecated and will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. AddOrder No GetItem

DetailLevel: none,ItemReturnAttributes, ItemReturnDescription, ReturnAll

Always GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetBidderList GetItemShipping Conditionally Tax details for a jurisdiction, such as a state or province. If no tax table is associated with the item, a tax table is not returned. For GetItem, a tax table is returned if it exists when: <ul> <li>DetailLevel is set to <code>ReturnAll</code> or ItemReturnDescription (in this case, the value of IncludeTaxTable does not matter)</li> <li>IncludeTaxTable is set to <code>true</code> and DetailLevel is not set or it is set to <code>ItemReturnAttributes</code></li> </ul> GetItem

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Note: This field is deprecated and will stop being returned in order management calls on January 31, 2024. GetBidderList GetItemShipping Conditionally GetItem Always

DetailLevel: none,ItemReturnAttributes, ItemReturnDescription, ReturnAll

The shipping service actually used by the seller to ship the item(s) to the buyer. ShippingServiceCodeType GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The field is deprecated. On input, this is the ID of the shipping discount to offer for the domestic shipping services (where the shipping discount is either of type FlatShippingDiscount or CalculatedShippingDiscount). On output, this is the ID of the shipping discount offered and corresponds to whichever is returned: FlatShippingDiscount or CalculatedShippingDiscount. Only returned if the calling user is the seller. If the user created a shipping discount profile, use the ShippingDiscountProfileID. In the RelistItem and ReviseItem family of calls, you can remove the existing ShippingDiscountProfileID associated with the item by supplying a value of 0 (zero). Only returned if the calling user is the seller. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-discount-profiles.html Shipping discount profiles If a flat rate shipping discount was offered for the domestic shipping services, this contains the details of the flat rate shipping discount. Otherwise, it is not returned. Only returned if the calling user is the seller. GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-discount-profiles.html Shipping discount profiles If a calculated shipping discount was offered for the domestic shipping services, this contains the details of the calculated shipping discount. Otherwise, it is not returned. Only returned if the calling user is the seller. GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-discount-profiles.html Shipping discount profiles On input, this specifies whether to offer the promotional shipping discount for the domestic shipping services of this listing (only applicable if the seller has a promotional shipping discount in effect at the moment). Returned on output only if the seller is making the call. This indicates whether the promotional shipping discount is being offered for the domestic shipping services of this listing (if the listing is still active—this is only possible if the seller has a promotional shipping discount in effect at the moment) or whether the discount was offered at the time the listing ended. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-discount-profiles.html Shipping discount profiles On input, this is the ID of the shipping discount to offer for the international shipping services (where the shipping discount is either of type FlatShippingDiscount or CalculatedShippingDiscount). In the RelistItem and ReviseItem family of calls, you can remove the existing InternationalShippingDiscountProfileID associated with the item by supplying a value of 0 (zero). Returned on output only if the seller is making the call. The value is the ID of the shipping discount offered and corresponds to whichever is returned: FlatShippingDiscount or CalculatedShippingDiscount. If the user created a shipping discount profile, use InternationalShippingDiscountProfileID. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-discount-profiles.html Shipping discount profiles This value is returned only if the seller is making the call. If a flat rate shipping discount was offered for the international shipping services, this contains the details of the flat rate shipping discount. Otherwise, it is not returned. GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-discount-profiles.html Shipping discount profiles This value is returned only if the seller is making the call. If a calculated shipping discount was offered for the international shipping services, this contains the details of the calculated shipping discount. Otherwise, it is not returned. GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-discount-profiles.html Shipping discount profiles On input, this specifies whether to offer the promotional shipping discount for the listing's international shipping services (only applicable if the seller has a promotional shipping discount in effect at the moment). Returned on output only if the seller is making the call. This value indicates whether the promotional shipping discount is being offered for the international shipping services of this listing (if the listing is still active—this is only possible if the seller has a promotional shipping discount in effect at the moment) or whether the discount was offered at the time the listing ended. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-discount-profiles.html Shipping discount profiles This value is returned only if the seller is making the call. Contains details of the promotional shipping discount, if such is being offered while the listing is active or if it was offered at the time the listing ended. GetShippingDiscountProfiles Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-discount-profiles.html Shipping discount profiles Use this field in an Add/Revise/Relist call to specify an international country or region, or a special domestic location, such as 'PO Box' (in US) or 'Packstation' (in DE), to where you will not ship the associated item. Repeat this element in the call request for each location that you want to exclude as a shipping destination for your item. The exclude ship-to location values are eBay regions and countries. To see the valid exclude ship-to locations for a specified site, call GeteBayDetails with DetailName set to ExcludeShippingLocationDetails, and then look for the ExcludeShippingLocationDetails.Location fields in the response. Repeat GeteBayDetails for each site on which you list. This field works in conjunction with Item.ShipToLocations to create a set of international countries and regions to where you will, and will not, ship. You can list a region in the ShipToLocations field, then exclude specific countries within that region with this field (for example, you can specify Africa in ShipToLocations, yet exclude Chad with a ExcludeShipToLocation setting). In addition, if your ShipToLocations is <code>Worldwide</code>, you can use this field to specify both regions and countries that you want to exclude from your shipping destinations. Note: The ShipToLocations and ShippingDetails.ExcludeShipToLocation containers are not applicable for motor vehicle listings on the US, CA, or UK marketplaces. If these containers are sent in the request, they are ignored and a warning is returned. Note: Any shipping exclusions specified by this field can be overridden by the eBay International Shipping exclusions toggle located under Shipping Preferences in My eBay. For more information on eBay International Shipping, see <a href="https://www.ebay.com/help/selling/shipping-items/setting-shipping-options/ebay-international-shipping-program?id=5348">eBay International Shipping program</a>. You can specify a default set of locations to where you will not ship in My eBay. If you create an Exclude Ship-To List, it is, by default, in effect when you list items. However, if you specify any value in this field on input, it nullifies the default settings in your Exclude Ship-To List. (If you use ExcludeShipToLocation when you list an item, you will need to list all the locations to where you will not ship the associated item, regardless of the default settings in your Exclude Ship-To List.) Specify <code>none</code> in this field to override the default Exclude Ship-To List you might have set up in My eBay and indicate that you do not want to exclude any shipping locations from the respective item listing. Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions responses on January 31, 2024. ShippingRegionCodeType, CountryCodeType GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

GetItemShipping Conditionally AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally This dollar value indicates the cost to buy the shipping label from eBay. Presently, this field is only returned for orders that will go through eBay shipping and its value will be <code>0.0</code>. With eBay shipping, a free shipping label by eBay is downloadable by the seller via the eBay website. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally Sellers can set up a global Exclude Ship-To List through their My eBay account. The Exclude Ship-To List defines the countries to where the seller does not ship, by default. This flag returns true if the Exclude Ship-To List is enabled by the seller for the associated item. If <code>false</code>, the seller's Exclude Ship-To List is either not set up, or it has been overridden by the seller when they listed the item with ExcludeShipToLocation fields. In the response, ExcludeShipToLocation fields detail the locations to where the seller will not ship the item, regardless of the value returned in this field. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

VerifyRelistItem Conditionally Container for the shipping carrier and tracking information associated with the shipment of an order. As each package has a unique tracking number, this container should be repeated for each package in the order. 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 eBay's Top-rated seller program, 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> page. Note: Shipment tracking information does not appear in Merchant Data API's OrderReport responses, because once shipment tracking information is provided to the buyer, the order/order line item is considered acknowledged, and acknowledged orders do not show up in OrderReport responses. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally This container is used to reference and apply a seller's domestic and/or international shipping rate tables to a listing. Shipping rate tables allow sellers to configure specific shipping costs based on the shipping destinations and level of service (e.g. economy, standard, expedited, and one-day). Generally speaking, sellers want to use these shipping rate tables so they can charge a higher shipping cost to the buyer whenever shipping costs are higher for them as well. For example, shipping to Alaska or Hawaii is generally more expensive than shipping to any other of the 48 US states, or in regards to international shipping, shipping to some regions and countries are more expensive than others. Sellers configure domestic and international shipping rate tables in My eBay Shipping Preferences. To apply shipping rate tables to a listing, the shipping cost type must be flat-rate. For domestic shipping rate tables, the three supported domestic regions are Alaska & Hawaii, US Protectorates (e.g. Puerto Rico and Guam), and APO/FPO destinations, which are US military bases/locations outside of the continental US. In addition to setting one flat rate based on the destination and service level, the seller also has the option of adding an extra charge based on the weight of the shipping package, or they can add a surcharge instead. To determine if a domestic shipping rate table is set up for the seller's account, the GetUser call can be used, and then the seller will look for a value of <code>true</code> in the User.SellerInfo.DomesticRateTable field. Although the GetUser call can be used to see if a domestic shipping rate table exists for the seller's account, details of the shipping rate table, including all specified costs for the different regions, can only be viewed and modified in My eBay Shipping Preferences. This functionality is not yet available in any public APIs. For international shipping rate tables, specific rates may be set up for any and all of the nine geographical regions and individual countries within those regions. Similar to domestic shipping rate tables, the seller has the option of adding an extra charge based on the weight of the shipping package. Sellers cannot add a surcharge for international shipping. To determine if a international shipping rate table is set up for the seller's account, the GetUser call can be used, and then the seller will look for a value of <code>true</code> in the User.SellerInfo.InternationalRateTable field. Although the GetUser call can be used to see if an international shipping rate table exists for the seller's account, details of the shipping rate table, including all specified costs for the different regions/countries, can only be viewed and modified in My eBay Shipping Preferences. This functionality is not yet available in any public APIs. If you are applying a domestic or international shipping rate table that specifies a surcharge by weight, you must specify the item weight in the ShippingPackageDetails container's WeightMajor and WeightMinor fields, even though the listing is using flat-rate shipping. Do not use any other fields in the ShippingPackageDetails container because none of those fields are applicable in this use case. This container is only returned in the 'Get' calls if one or more shipping rate tables have been applied to the listing, and if the call is being made by the seller who listed the item. Note: The capability to create and use multiple domestic and international shipping rate tables (up to 40 per seller account) has rolled out to the US, Australia, Canada (English and French), Italy, UK, and Germany sites. For other sites, only one domestic and one international shipping rate table may be set up per seller. Whether a seller is using the old default domestic and international shipping rate tables or the new shipping rate tables, these shipping rate tables are set up in My eBay Shipping Preferences or as part of a Shipping Business Policy. If using the Trading API to create a listing that will use the new shipping rate tables, the DomesticRateTableId and InternationalRateTableId fields are used to reference and apply these new shipping rate tables to the listing. If desired, sellers can still use the old default shipping rate tables, but they are not allowed to mix and match old and new shipping rate tables, meaning that they will get an error if they pass in both the old fields (DomesticRateTable and InternationalRateTable) and the new fields (DomesticRateTableId and InternationalRateTableId). The new shipping rate tables have all of the functionality of the old shipping rate tables, plus the seller has access to all domestic regions and not just the special regions (such as Alaska & Hawaii, US Protectorates, and APO/FPO locations in US). AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally Shipping rate tables https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-rate-tables.html more information on using shipping rate tables. Details about a region or location to which the seller is willing to ship. Short name or abbreviation for a region (e.g., Asia) or location (e.g. Japan). ShippingDetails.InternationalShippingServiceOption in AddItem AddItem.html#Request.Item.ShippingDetails.InternationalShippingServiceOption GeteBayDetails Conditionally Display string that applications can use to present a list of shipping locations in a more user-friendly format (such as in a drop-down list). This field is localized in the language of the site. GeteBayDetails Conditionally Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always The nature of the package used to ship the item(s). Required for calculated shipping only. Not all package types are supported by a specific shipping service (ShippingServiceCodeType). None Letter LargeEnvelope USPS Large Package/Oversize 1 Very Large Package/Oversize 2 Extra Large Package/Oversize 3 UPS Letter USPS Flat Rate Envelope Package/thick envelope Roll Europallet Onewaypallet Bulky goods Furniture Cars Motorbikes Caravan Industry vehicles Parcel or padded Envelope Small Canada Post Box Medium Canada Post Box Large Canada Post Box Small Canada Post Bubble Mailer Medium Canada Post Bubble Mailer Large Canada Post Bubble Mailer Padded Bags Tough Bags Expandable Tough Bags Mailing Boxes Winepak Reserved for internal or future use. Details about type of package used to ship an item. Numeric identifier. Some applications use this ID to look up shipping packages more efficiently. GeteBayDetails Conditionally Display string that applications can use to present a list of shipping package options in a more user-friendly format (such as in a drop-down list). GeteBayDetails Conditionally A supported value for the site that can be used in the Item.ShippingPackageDetails.ShippingPackage or Item.ShippingDetails.CalculatedShippingRate.ShippingPackage fields of an Add/Revise/Relist API call. GeteBayDetails Conditionally Indicates if the package type is the default for the specified site. GeteBayDetails Conditionally This field is returned as 'true' if the shipping package supports the use of package dimensions. false GeteBayDetails Conditionally Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always Type defining the ShippingPackageInfoType container, which is returned in order management calls. The ShippingPackageInfoType container provides information on delivery times and tracking information for a shipping package. The unique identifier of the store from where the order will be delivered. This field is only applicable to 'In-Store Pickup' and 'Click and Collect' orders. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This enumeration value indicates whether or not the order has been picked up from the store indicated by the StoreID value. This field is only applicable to 'In-Store Pickup' and 'Click and Collect' orders. ShippingTrackingEventCodeType GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The ScheduledDeliveryTimeMin and ScheduledDeliveryTimeMax timestamps indicate the delivery window for which the buyer can expect to receive the order. The ScheduledDeliveryTimeMin value indicates the earliest time that the buyer can expect to receive the order. The ScheduledDeliveryTimeMin and ScheduledDeliveryTimeMax fields will start being returned once the seller marks the order as shipped/provides tracking information. Until then, the EstimatedDeliveryTimeMin and EstimatedDeliveryTimeMax dates are returned instead. Note: This field does not appear in the Sell Feed API's <code>LMS_ORDER_REPORT</code> responses, because once shipment tracking information is provided to the buyer, the order/order line item is considered acknowledged, and acknowledged orders do not show up in the <code>LMS_ORDER_REPORT</code> responses. GetOrders

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The ScheduledDeliveryTimeMin and ScheduledDeliveryTimeMax timestamps indicate the delivery window for which the buyer can expect to receive the order. The ScheduledDeliveryTimeMax value indicates the latest time that the buyer can expect to receive the order. The ScheduledDeliveryTimeMin and ScheduledDeliveryTimeMax fields will start being returned once the seller marks the order as shipped/provides tracking information. Until then, the EstimatedDeliveryTimeMin and EstimatedDeliveryTimeMax dates are returned instead. Note: This field does not appear in the Sell Feed API's <code>LMS_ORDER_REPORT</code> responses, because once shipment tracking information is provided to the buyer, the order/order line item is considered acknowledged, and acknowledged orders do not show up in the <code>LMS_ORDER_REPORT</code> responses. GetOrders

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This timestamp indicates when the order was actually delivered to the buyer. This field is only returned after the order has been delivered to the buyer. Note: This field does not appear in the Sell Feed API's <code>LMS_ORDER_REPORT</code> responses, because once shipment tracking information is provided to the buyer (or marked as shipped), the order/order line item is considered acknowledged, and acknowledged orders do not show up in the <code>LMS_ORDER_REPORT</code> responses. GetOrders

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The EstimatedDeliveryTimeMin and EstimatedDeliveryTimeMax timestamps indicate the window during which the buyer can expect delivery. The EstimatedDeliveryTimeMin value indicates the earliest date and time that the buyer can expect to receive the order. The EstimatedDeliveryTimeMin and EstimatedDeliveryTimeMax dates are only estimates made by eBay, and their accuracy will depend on the seller meeting the handling time deadline. Once the seller ships the order, and marks it as shipped/provides tracking information, the more accurate delivery dates can be found in the the ScheduledDeliveryTimeMin and ScheduledDeliveryTimeMax fields. GetOrders ShippingServiceSelected

DetailLevel: none, ReturnAll

Conditionally OrderReport ShippingServiceSelected Conditionally GetItemTransactions GetSellerTransactions ShippingServiceSelected

DetailLevel: none, ReturnAll

Conditionally The EstimatedDeliveryTimeMin and EstimatedDeliveryTimeMax timestamps indicate the window during which the buyer can expect delivery. The EstimatedDeliveryTimeMax value indicates the latest date and time that the buyer can expect to receive the order. The EstimatedDeliveryTimeMin and EstimatedDeliveryTimeMax dates are only estimates made by eBay, and their accuracy will depend on the seller meeting the handling time deadline. Once the seller ships the order, and marks it as shipped/provides tracking information, the more accurate delivery dates can be found in the the ScheduledDeliveryTimeMin and ScheduledDeliveryTimeMax fields. GetOrders ShippingServiceSelected

DetailLevel: none, ReturnAll

Conditionally OrderReport ShippingServiceSelected Conditionally GetItemTransactions GetSellerTransactions ShippingServiceSelected

DetailLevel: none, ReturnAll

Conditionally This timestamp indicates the latest date/time that the seller should ship the package to ensure that the package arrives to the buyer within the estimated delivery window. This date/time is calculated by adding the handling time (in days) to the purchase time. This field is applicable for domestic shipping services, and for Click and Collect orders in the UK and Australia. GetOrders

DetailLevel: none, ReturnAll

ShippingServiceSelected Conditionally OrderReport ShippingServiceSelected Conditionally GetItemTransactions GetSellerTransactions ShippingServiceSelected

DetailLevel: none, ReturnAll

Conditionally The MinNativeEstimatedDeliveryTime and MaxNativeEstimatedDeliveryTime timestamps indicate the window during which the buyer can expect delivery based on the seller's handling time and selected shipping service. The MinNativeEstimatedDeliveryTime value indicates the earliest date and time that the buyer can expect to receive the order. This field is applicable for domestic shipping services, and for Click and Collect orders in the UK and Australia. GetOrders ShippingServiceSelected

DetailLevel: none, ReturnAll

Conditionally OrderReport ShippingServiceSelected Conditionally GetItemTransactions GetSellerTransactions ShippingServiceSelected

DetailLevel: none, ReturnAll

Conditionally The MinNativeEstimatedDeliveryTime and MaxNativeEstimatedDeliveryTime timestamps indicate the window during which the buyer can expect delivery based on the seller's handling time and selected shipping service. The MaxNativeEstimatedDeliveryTime value indicates the latest date and time that the buyer can expect to receive the order. This field is applicable for domestic shipping services, and for Click and Collect orders in the UK and Australia. GetOrders ShippingServiceSelected

DetailLevel: none, ReturnAll

Conditionally OrderReport ShippingServiceSelected Conditionally GetItemTransactions GetSellerTransactions ShippingServiceSelected

DetailLevel: none, ReturnAll

Conditionally A shipping rate scale for shipping through UPS that affects the shipping cost calculated for UPS (lower if ShippingRateType is <code>DailyPickup</code>). For calculated shipping only. "On-demand" shipping rate scale. "Daily pickup" shipping rate scale. "Standard List" shipping rate scale. "Counter" shipping rate scale. "Discounted" shipping rate scale. "Commercial Plus" shipping rate scale. "Commercial Plus Discounted Rate1" shipping rate scale. "Commercial Plus Discounted Rate2" shipping rate scale. (out) Reserved for internal or future use. A shipping service used to ship an item. Applications should not depend on the completeness of ShippingServiceCodeType. Instead, applications should call GeteBayDetails, with a DetailName value of <code>ShippingServiceDetails</code>, to return the complete list of shipping services. To check for the shipping services available for a specific site, specify the site ID in the header. Note: It is possible that some of the returned shipping services can no longer be used in the AddItem family of calls. To distinguish between the valid and invalid shipping services, look for the ValidForSellingFlow flag in the ShippingServiceDetails node. If this flag is not returned for a specific shipping service, that shipping service can no longer be used in the AddItem family of calls. CA_PostExpeditedFlatRateBox, CA_PostExpeditedFlatRateBoxUSA, FreightOtherShipping, SameDayShipping, UK_RoyalMailStandardParcel, CAFR_StandardDelivery, CAFR_ExpeditedDelivery, CAFR_PostLettermail, CAFR_PostRegularParcel, CAFR_PostExpeditedParcel, CAFR_PostXpresspost, CAFR_PostPriorityCourier, CAFR_StandardInternational, CAFR_ExpeditedInternational, CAFR_OtherInternational, CAFR_PostExpeditedParcelUSA, CAFR_PostSmallPacketsUSA, CAFR_PostXpresspostUSA, CAFR_PostXpresspostInternational, CAFR_PostInternationalParcelSurface, CAFR_PostInternationalParcelAir, CAFR_SmallPacketsInternational, CAFR_PurolatorInternational, CAFR_PostSmallPacketsUSAGround, CAFR_PostSmallPacketsUSAAir, CAFR_SmallPacketsInternationalGround, CAFR_SmallPacketsInternationalAir, CAFR_PostUSALetterPost, CAFR_PostInternationalLetterPost, CAFR_UPSExpressCanada, CAFR_UPSExpressSaverCanada, CAFR_UPSExpeditedCanada, CAFR_UPSStandardCanada, CAFR_UPSExpressUnitedStates, CAFR_UPSExpeditedUnitedStates, CAFR_UPS3DaySelectUnitedStates, CAFR_UPSStandardUnitedStates, CAFR_UPSWorldWideExpress, CAFR_UPSWorldWideExpedited UPS Ground UPS 3rd Day UPS 2nd Day UPS Next Day USPS Priority USPS Parcel Select Non-Presort USPS Standard Post USPS Media USPS First Class Standard shipping method Reserved for internal or future use USPS Priority Mail Express UPS Next Day Air UPS Next Day Air USPS Priority Mail Express Flat Rate Envelope To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. The seller must also specify a package size of Package/Thick Envelope when using a calculated shipping service. USPS Priority Mail Express Padded Flat Rate Envelope To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. The seller must also specify a package size of Package/Thick Envelope when using a calculated shipping service. USPS Priority Mail Flat Rate Envelope To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. The seller must also specify a package size of Package/Thick Envelope when using a calculated shipping service. USPS Priority Mail Small Flat Rate Box To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. The seller must also specify a package size of Package/Thick Envelope when using a calculated shipping service. USPS Priority Mail Flat Rate Box To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. The seller must also specify a package size of Package/Thick Envelope when using a calculated shipping service. USPS Priority Mail Large Flat Rate Box To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. USPS Priority Mail Padded Flat Rate Envelope To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. USPS Priority Mail Legal Flat Rate Envelope To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. USPS Priority Mail Express Legal Flat Rate Envelope To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. USPS Priority Mail Regional Box A To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. USPS Priority Mail Regional Box B To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. USPS Priority Mail Regional Box C To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. USPS Priority Mail Express Flat Rate Box To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. Other (see description) Local Delivery/Pickup Not Selected International Not Selected Standard International Flat Rate Shipping Expedited International Flat Rate Shipping USPS Global Express Mail USPS Global Priority Mail USPS Economy Parcel Post USPS Economy Letter Post USPS Airmail Letter Post USPS Airmail Parcel Post UPS Worldwide Express Plus UPS Worldwide Express UPS Worldwide Expedited UPS Worldwide Saver UPS Standard To Canada USPS Priority Mail Express International Flat Rate Envelope To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. The seller must also specify a package size of Package/Thick Envelope when using a calculated shipping service. USPS Priority Mail Express International Padded Flat Rate Envelope To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. The seller must also specify a package size of Package/Thick Envelope when using a calculated shipping service. USPS Priority Mail International Flat Rate Envelope To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. The seller must also specify a package size of Package/Thick Envelope when using a calculated shipping service. USPS Priority Mail International Small Flat Rate Box To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. The seller must also specify a package size of Package/Thick Envelope when using a calculated shipping service. USPS Priority Mail International Flat Rate Box To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. The seller must also specify a package size of Package/Thick Envelope when using a calculated shipping service. USPS Priority Mail International Large Flat Rate Box To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. USPS Priority Mail International Padded Flat Rate Envelope To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. USPS Priority Mail International Legal Flat Rate Envelope To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. USPS Priority Mail Express International Legal Flat Rate Envelope To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. USPS Priority Mail Express International Flat Rate Box To use this service, a seller must specify the package weight so that eBay can validate the weight against the maximum weight limit for the service. Other International Shipping (see description) Standardversand (unversichert) Versicherter Versand Einschreiben (Versand inkl. Einschreibengebuhr) Nachnahme (Versand inkl. Nachnahmegebuhr) Express- oder Kurierversand Versicherter Express- oder Kurierversand Sonder-/Speditionsversand (z.B. Mobel, KFZ) Versicherter Sonder-/Speditionsversand (z.B. Mobel, KFZ) Sonstige (Siehe Artikelbeschreibung) Unversicherter Versand International Versicherter Versand International Sonstiger Versand International Unversicherter Express Versand International Versicherter Express Versand International Sparversand aus dem Ausland Standardversand aus dem Ausland Expressversand aus dem Ausland Versand mit Nachverfolgung aus dem Ausland Regular Express Registered Courier Other EMS International Courier - Parcels EMS International Courier - Documents Express Post International - Documents Air Mail Economy Air Sea Mail Standard International Flat Rate Postage Expedited international flat rate postage Other international postage Australia Post Registered Post International Padded Bag 1 kg Australia Post Registered Post International Padded Bag 500 g Australia Post Registered Post International Parcel Expedited delivery from outside Australia Economy delivery from outside Australia Standard Delivery From Outside AU Australian Air Express Metro 15 kg Australian Air Express Flat Rate 5 kg Australian Air Express Flat Rate 3 kg Australian Air Express Flat Rate 1 kg Express delivery (1-3 business days) in Australia Standard delivery (1-6 business days) in Australia eBay/Australian Post 3 kg Flat Rate Satchel eBay/Australian Post 500 g Flat Rate Satchel Freight delivery in Australia. Used for heavy and bulky items. Livraison standard a partir de l'etranger Livraison express Colis Courrier en recommande Autre service de livraison De Post UPS FedEx DHL TPG Post/TNT (Netherlands) Frais de livraison internationale fixes Frais fixes pour livraison internationale express Autres livraisons internationales (voir description) La Poste (France) La Poste - livraison standard (1 a 2 jours ouvrables) La Poste - envoi recommande (1 jour ouvrable) La Poste - Taxipost LLS (2 jours ouvrables) La Poste - Taxipost 24h (1 jour ouvrable) Autres livraisons La Poste - livraison standard La Poste - envoi recommande TNT Livraison economique a partir de l'etranger Livraison standard a partir de l'etranger Livraison express a partir de l'etranger Livraison a partir de l'etranger avec suivi de commande Standard Delivery Priority Delivery Parcel Post Registered Mail Other Shipping Service De Post UPS FedEx DHL TPG Post/TNT (Netherlands) Standard International Expedited International Other International Shipping Services La Poste (France) De Post - standaardverzending (1 tot 2 werkdagen) De Post - aangetekende zending (1 werkdag) De Post - Taxipost LLS (2 werkdagen) De Post - Taxipost 24u (1 werkdag) De Post - Taxipost Secur (1 werkdag) Andere verzending De Post - standaardverzending De Post - aangetekende zending TNT Voordelige verzending uit het buitenland Standaardverzending uit het buitenland Express verzending uit het buitenland Verzending uit het buitenland met internationale tracking Standard Delivery Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Expedited delivery Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Canada Post Lettermail Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Canada Post Regular Parcel Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Canada Post Expedited Parcel Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Canada Post Xpresspost - International Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Canada Post Priority Courier Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Canada Post Expedited Flat Rate Box (This value is no longer used.) Standard International Flat Rate Shipping Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Expedited International Flat Rate Shipping Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Other International Shipping (see description) Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Canada Post Expedited Parcel - USA Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Canada Post Small Packets - USA Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Canada Post Xpresspost - USA Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Canada Post Xpresspost - International Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Canada Post International Parcel - Surface Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Canada Post International Parcel - Air Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Small Packets - International Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Purolator International Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Canada Post Small Packets - USA - Ground Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Canada Post Small Packets - USA - Air Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Small Packets - International - Ground Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Small Packets - International - Air Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Canada Post USA Letter-post Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Canada Post International Letter-post Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. (This value is no longer used.) UPS Express Canada Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. UPS Express Saver Canada Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. UPS Expedited Canada Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. UPS Standard Canada Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. UPS Express United States Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. UPS Expedited United States Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. UPS 3 Day Select United States Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. UPS Standard United States Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. UPS Worldwide Express Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. UPS Worldwide Expedited Note: This shipping service is valid for both the English and French versions of the eBay Canada Marketplace. Canada Post Priority Worldwide Canada Post Expedited Flat Rate Box USA Canada Post Tracked Packet - USA Canada Post Tracked Packet - International Freight Standardversand (A-Post/Priority) Standardversand (B-Post/Economy) Versicherter Versand (z.B. Assurance/Fragile) Einschreiben (Versand inkl. Einschreibengebuhr) Nachnahme (Versand inkl. Nachnahmegebuhr) Express- oder Kurierversand Versicherter Express- oder Kurierversand Sonder-/Speditionsversand (z.B. Mobel, KFZ) Versicherter Sonder-/Speditionsversand (z.B. Mobel, KFZ) Sonstige (Siehe Artikelbeschreibung) Sonstiger Versand (Siehe Artikelbeschreibung) ECONOMY Sendungen PRIORITY Sendungen URGENT Sendungen Sparversand aus dem Ausland Standardversand aus dem Ausland Expressversand aus dem Ausland Versand mit Nachverfolgung aus dem Ausland Seller door delivery (limited to the city) China Post Post Office Logistics company express EMS Express Other (see item description) China Post Express Mail City Express Off-site delivery International Standard Fixed Freight International courier fixed freight Other international shipping charges (see note) COD (same city only) Standard Mailing Regular logistics EMS Others (see description) Unversicherter Versand Versicherter Versand Einschreiben (Versand inkl. Einschreibengebuhr) Nachnahme (Versand inkl. Nachnahmegebuhr) Express- oder Kurierversand Versicherter Express- oder Kurierversand Sonderversand (z.B. Mobel, KFZ)DE_DHLPackchen Versicherter Sonderversand (z.B. Mobel, KFZ) Unversicherter Versand Deutsche Post Brief eBay DHL Paket 24/7 (Abgabe und Lieferung an Packstation) DHL Postpaket DHL Packchen International Deutsche Post Warensendung Deutsche Post Buchersendung Hermes Paket (unversichert) Hermes Paket (versichert) iloxx Transport XXL iloxx Express iloxx Standard Sonstige (Siehe Artikelbeschreibung) Unversicherter Versand Versicherter Versand DHL Postpaket International DHL Packchen International Sonstiger Versand (Siehe Artikelbeschreibung) Unversicherter Express - Versand Versicherter Express - Versand Deutsche Post Brief (Land) Deutsche Post Brief (Luft) iloxx Europa iloxx World Wide Paketversand Expressversand DHL Paket Deutsche Post Buecher-/Warensendung Hermes Paket iloxx Transport Sonstige Einschreiben (inkl. aller Gebuehren) Nachnahme (inkl. aller Gebuehren) Sonderversand UPS DPD GLS Paketversand DHL Paket International DHL Paket International Express Sonstige Expressversand Deutsche Post Brief iloxx Transport International Hermes Paket International UPS International DPD International GLS International eBay Hermes Paket Shop2Shop (Kaeufer erhaelt E-Mail von Hermes bei Zustellung) Hermes Paket Shop2Shop (Kaeufer erhaelt E-Mail von Hermes bei Zustellung) eBay Hermes Paket Shop2Shop Hermes Paket Shop2Shop Hermes Paket Sperrgut eBay Hermes Paket Sperrgut Shop2Shop (Abgabe und Zustellung im Paketshop) DHL Paeckchen Packstation DHL Paket Packstation eBay DHL Paeckchen DHL Star-Paeckchen Versand mit Nachverfolgung aus dem Ausland Cartas nacionales hasta 20 gr Correos: cartas ordinarias Cartas internacionales hasta 20 gr Cartas internacionales de mas de 20 gr Paquete Azul (nacional) hasta 2 kg Correos: Postal Expres Paquete Internacional Economico Otro courier 24 horas Otros (ver descripcion) Envio internacional estandar Envio internacional urgente Envio internacional economico Cartas y tarjetas postales internacionales Ems postal expres internacional Paquete internacional economico Envio economico desde el extranjero Envio estandar desde el extranjero Envio urgente desde el extranjero Envio desde el extranjero con seguimiento Entrega a un Kiala point hasta 8 kg Chronoposte International Classic Coliposte Colissimo Direct DHL Express Europack UPS Standard Lettre Lettre avec suivi Lettre recommandee Colissimo Colissimo Recommande Contre remboursement Autre mode d'envoi de courrier Ecopli Colieco Autre mode d'envoi de colis Remise en main propre Autre livraison internationale standard Autre livraison internationale express Autre livraison internationale economique La Poste - Courrier International Prioritaire La Poste - Courrier International Economique La Poste - Colissimo International La Poste - Colis Economique International La Poste - Colissimo Emballage International Chronopost Classic International Chronopost Premium International UPS Standard UPS Express DHL La Poste Lettre Max Livraison en Relais Kiala Livraison a partir de l'etranger avec suivi de commande National - Regular National - Express National - COD Local - Courier Local - COD International - Standard International - Expedited International - other Flat Rate COD Buyer picks up and pays Posta ordinaria Posta prioritaria Posta raccomandata Posta raccomandata con contrassegno Posta assicurata Posta celere Pacco ordinario Pacco celere 1 Pacco celere 3 Corriere espresso Paccocelere Maxi Spedizione internazionale standard a prezzo fisso Spedizione internazionale celere a prezzo fisso Altre spedizioni internazionali (vedi descrizione) Spedizione tracciata dall estero Standaardverzending Pakketpost Verzending met ontvangstbevestiging Andere verzendservice TPG Post/TNT UPS FedEx DHL DPD (Germany) GLS (Business only) Vaste kosten standaard internationale verzending Vaste kosten versnelde internationale verzending Andere internationale verzending (zie beschrijving) Voordelige verzending uit het buitenland Standaardverzending uit het buitenland Verzending per expresse uit het buitenland Verzending met internationale tracering uit het buitenland Post office plus registration Post office without registration Post office cash on delivery Home delivery Home delivery cash on delivery Face to face Freight delivery Express delivery Other Post Office Airbag Post office air parcel Post office aviation registered packet Post office aviation registration package Post Office International Express EMS Post office international land and water package FedEx International Priority FedEx International Economy UPS Worldwide Expedited UPS Worldwide Express UPS Worldwide Express Plus Other international shipping charges (see description) Royal Mail 1st Class Royal Mail 2nd Class Royal Mail 1st Class Signed For Royal Mail 2nd Class Signed For Royal Mail Special Delivery (This value is no longer used.) Parcelforce 24 Parcelforce 48 Other Courier Hermes Tracked Collect+ : drop at store-delivery to door Seller's Standard Rate Collection in Person Sellers Standard International Rate Royal Mail Airmail Royal Mail Airsure Royal Mail Surface Mail Royal Mail International Signed-for Royal Mail HM Forces Mail Parcelforce International Datapost Parcelforce Ireland 24 Parcelforce Euro 48 Parcelforce International Scheduled Other courier or delivery service Collect in person Parcelforce Global Express Parcelforce Global Value Parcelforce Global Economy (Not available for destinations in Europe) Tracked delivery from outside abroad International tracked postage Seller's standard rate First Class Letter Service SwiftPost National Registered Post EMS SDS Courier Economy SDS Courier Other courier Collection in person Seller's Standard International Rate International Economy Service International Priority Service SwiftPost Express SwiftPost International EMS SDS Courier Economy SDS Courier Other courier or delivery service International collection in person Economy delivery from abroad Standard delivery from abroad Express delivery from abroad Tracked delivery from abroad Domestic Regular shipping Domestic Special shipping Przesylka z zagranicy - ekonomiczna Przesylka z zagranicy - standardowa Przesylka z zagranicy - ekspresowa Przesylka z zagranicy - ze sledzeniem Service associated with FreightQuote.com (This value is no longer used.) Service associated with any freight service other than FreightQuote.com Note: Sellers offering freight shipping on the following marketplaces should use the Shipping service code value listed below and not use the <code>Freight</code> value that is used for freight shipping on other marketplaces. For example, sellers offering freight shipping on the Australia (AU) marketplace should use the <code>AU_Freight</code> value for ShippingServiceCodeType and not use the <code>Freight</code> value. <table> <tr> <th>SiteID</th> <th>Site name</th> <th>Shipping service code value</th> </tr> <tr><td><code>0</code></td> <td>US</td> <td><code>Freight</code></code></td> </tr> <tr><td><code>3</code></td> <td>UK</td> <td><code>Courier</code></code></td> </tr> <tr><td><code>2</code></td> <td>CA</td> <td><code>CA_Freight</code></code></td> </tr> <tr><td><code>15</code></td> <td>AU</td> <td><code>AU_Freight</code></code></td> </tr> <tr><td><code>210</code></td> <td>CA_FR</td> <td><code>CA_Freight</code></code></td> </tr> </table> Freight Shipping International US Postal Service Ground Overnight flat rate shipping service (domestic only) Reserved for internal or future use USPS Priority Flat Rate Envelope USPS Priority Flat Rate Box USPS Global Priority Mail Small Envelope USPS Global Priority Mail Large Envelope USPS Priority Mail Express Flat Rate Envelope UPS Worldwide Express Box 10 Kg UPS Worldwide Express Box 25 Kg UPS Worldwide Express Plus Box 10 Kg UPS Worldwide Express Plus box 25 Kg Local pick up only Local courier Domestic regular shipping Domestic special shipping International regular shipping International special shipping Local pick up only Local courier Domestic standard mail Domestic non standard mail Domestic Speedpost Islandwide International standard mail International Express Mail Service (EMS) International courier (DHL, FedEx, UPS) De Post zending - NON PRIOR (2 werkdagen) De Post zending - PRIOR (1 werkdag) De Post zending - aangetekend (1 werkdag) Kilopost pakje (2 werkdagen) Taxipost (express) Kiala afhaalpunt (1 tot 4 werkdagen) Vaste kosten standaard verzending Vaste kosten versnelde verzending Verzekerde verzending La Poste envoi NON PRIOR (2 jours ouvrables) La Poste envoi PRIOR (1 jour ouvrable) La Poste envoi recommande (1 jour ouvrable) Paquet Kilopost (2 jours ouvrables) Taxipost (express) Point retrait Kiala (1 a 4 jours ouvrables) Livraison standard - prix forfaitaire Livraison express - prix forfaitaire Livraison securisee De Post zending - PRIOR De Post zending - NON PRIOR De Post zending - aangetekend Kilopost pakje Internationaal Taxipost expressverzending Verzekerde verzending La Poste envoie PRIOR La Poste envoie NON PRIOR La Poste envoie recommande Paquet Kilopost Internationale BEFR_Express Taxipost Livraison standard internationale - prix forfaitaire Livraison express internationale - prix forfaitaire Livraison securisee Chronopost Royal Mail Special Delivery; 1:00 pm Canada Post Light Packet International Canada Post Light Packet USA DHL Przesylka zagraniczna - zwykla Przesylka zagraniczna - priorytetowa UPS Note: This value is not supported. <code>CA_StandardDelivery</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Normes de livraison postale Note: This value is not supported. <code>CA_ExpeditedDelivery</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Expedition acceleree Note: This value is not supported. <code>CA_PostLettermail</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Postes Canada, Poste-lettres Note: This value is not supported. <code>CA_PostRegularParcel</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Postes Canada, Colis standard Note: This value is not supported. <code>CA_PostExpeditedParcel</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Postes Canada, Colis acceleres Note: This value is not supported. <code>CA_PostXpresspost</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Postes Canada, Xpresspost Note: This value is not supported. <code>CA_PostPriorityCourier</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Postes Canada, Messageries prioritaires Note: This value is not supported. <code>CA_StandardInternational</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Expedition standard - International, tarif fixe Note: This value is not supported. <code>CA_ExpeditedInternational</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Expedition acceleree - International, tarif fixe Note: This value is not supported. <code>CA_OtherInternational</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Autres services d'expedition internationale (voir description) Note: This value is not supported. <code>CA_PostExpeditedParcelUSA</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Postes Canada, Colis acceleres - E.U. Note: This value is not supported. <code>CA_PostSmallPacketsUSA</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Postes Canada, Petits paquets - E.U. Note: This value is not supported. <code>CA_PostXpresspostUSA</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Postes Canada, Xpresspost - E.U. Note: This value is not supported. <code>CA_PostXpresspostInternational</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Postes Canada, Xpresspost - International Note: This value is not supported. <code>CA_PostInternationalParcelSurface</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Postes Canada, Colis international de surface Note: This value is not supported. <code>CA_PostInternationalParcelAir</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Postes Canada, Colis-avion - International Note: This value is not supported. <code>CA_SmallPacketsInternational</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Petits paquets - International Note: This value is not supported. <code>CA_PurolatorInternational</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Purolator International Note: This value is not supported. <code>CA_PostSmallPacketsUSAGround</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Postes Canada, Petits paquets - E.U. service de surface Note: This value is not supported. <code>CA_PostSmallPacketsUSAAir</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Postes Canada, Petits paquets - E.U. par avion Note: This value is not supported. <code>CA_SmallPacketsInternationalGround</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Petits paquets - International, courrier-surface Note: This value is not supported. <code>CA_SmallPacketsInternationalAir</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Petits paquets - International, courrier-avion Note: This value is not supported. <code>CA_PostUSALetterPost</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Postes Canada, Poste aux lettres - E.U. Note: This value is not supported. <code>CA_PostInternationalLetterPost</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. Postes Canada, Poste aux lettres - International Note: This value is not supported. <code>CA_UPSExpressCanada</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. UPS Express Saver Note: This value is not supported. <code>CA_UPSExpressSaverCanada</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. UPS Express Saver Canada Note: This value is not supported. <code>CA_UPSExpeditedCanada</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. UPS Expedited Canada Note: This value is not supported. <code>CA_UPSStandardCanada</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. UPS Standard au Canada Note: This value is not supported. <code>CA_UPSExpressUnitedStates</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. UPS Express Etats-Unis Note: This value is not supported. <code>CA_UPSExpeditedUnitedStates</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. UPS Expedited Etats-Unis Note: This value is not supported. <code>CA_UPS3DaySelectUnitedStates</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. 3Day Select aux Etats-Unis Note: This value is not supported. <code>CA_UPSStandardUnitedStates</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. UPS Standard aux Etats-Unis Note: This value is not supported. <code>CA_UPSWorldWideExpress</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. UPS Worlwide Express Note: This value is not supported. <code>CA_UPSWorldWideExpedited</code> should be used instead, as this shipping service value is valid for both the English and French versions of the eBay Canada Marketplace. UPS Worldwide Expedited Royal Mail Special Delivery 9:00 am USPS First Class Mail Intl / First Class Package Intl Service USPS Priority Mail International USPS Priority Mail Express International Standardpauschale fur internationalen Versand Expresspauschale fur internationalen Versand Sonstiger Versand (Siehe Artikelbeschreibung) International Standard Fixed Rate for Taiwan International Express Fixed Rate for Taiwan USPS Global Express Guaranteed Regular with Insurance Express with Insurance Deutsche Post Warensendung Deutsche Post Byendung Hermes Paket (unversichert) Hermes Paket (versichert) iloxx Transport XXL iloxx Ubernacht Express iloxx Standard Standardpauschale fur internationalen Versand Expresspauschale fur internationalen Versand Deutsche Post Presse & Bucher Economy Deutsche Post Presse & Bucher Priority AT_BITTE_TREFFEN_SIE_EINE_AUSWAHL Einschreiben (Versand inkl. Einschreibengebuhr) Nachnahme (Versand inkl. Nachnahmegebuhr) Express- oder Kurierversand Versicherter Express- oder Kurierversand Sonderversand (z.B. Sperrgut, KFZ) Versicherter Sonderversand (z.B. Sperrgut, KFZ) Standardpauschale fur internationalen Versand Expresspauschale fur internationalen Versand Sonstiger Versand (Siehe Artikelbeschreibung) CH_BITTE_TREFFEN_SIE_EINE_AUSWAHL Unversicherter Versand Versicherter Versand Einschreiben (Versand inkl. Einschreibengebuhr) Nachnahme (Versand inkl. Nachnahmegebuhr) Express- oder Kurierversand Versicherter Express- oder Kurierversand Sonderversand (z.B. Sperrgut, KFZ) Versicherter Sonderversand (z.B. Sperrgut, KFZ) Standardversand (A-Post/Priority) Standardversand (B-Post/Economy) DE_BITTE_TREFFEN_SIE_EINE_AUSWAHL Einschreiben (Versand inkl. Einschreibengebuhr) Nachnahme (Versand inkl. Nachnahmegebuhr) Express- oder Kurierversand Versicherter Express- oder Kurierversand Sonderversand (z.B. Mobel, KFZ) Versicherter Sonderversand (z.B. Mobel, KFZ) Deutsche Post Brief Standard Int'l Flat Rate Postage Expedited Int'l Flat Rate Postage Other Int'l Postage (see description) Standard Int'l Flat Rate Postage Expedited Int'l Flat Rate Postage Other Int'l Postage (see description) Chronopost - Chrono Relais Chrono 10 Chrono 13 Chrono 18 Chronopost Express International PickUp Only Service Delivery Pickup Only Service Abholung Pickup Small Parcels Small Parcel With Tracking Small Parcel With Tracking And Signature Regular Parcel With Tracking Regular Parcel With Tracking And Signature PrePaid Express Post Satchel 5kg PrePaid Parcel Post Satchels 500g PrePaid Parcel Post Satchels 3kg PrePaid Parcel Post Satchels 5kg PrePaid Express Post Satchel 500g PrePaid Express Post Satchel 3kg PrePaid Express Post Platinum 500g PrePaid Express Post Platinum 3kg Express Courier International Express Post International PrePaid Express Post International Envelope C5 PrePaid Express Post International Envelope B4 PrePaid Express Post International Satchels 2kg PrePaid Express Post International Satchels 3kg PrePaid Express Post International Box 5kg PrePaid Express Post International Box 10kg PrePaid Express Post International Box 20kg Registered Parcel Post Registered Small Parcel Registered Parcel Post Prepaid Satchel 500g Registered Parcel Post Prepaid Satchel 3kg Registered Parcel Post Prepaid Satchel 5kg eBay Australia Post Express Post 500g Satchel eBay Australia Post Express Post 3kg Satchel Enlevement Pickup Afhalen Pickup Pickup Pickup Pickup Pickup Pickup Pickup Other 24 Hour Courier Other 48 Hour Courier Other Courier 3 days Other Courier 5 days Courier Shipping FedEx Priority Overnight FedEx Standard Overnight FedEx 2Day FedEx Ground FedEx Home Delivery FedEx Express Saver Reserved for internal or future use Reserved for internal or future use FedEx International First FedEx International Priority FedEx International Economy FedEx International Ground Economy shipping from outside US Expedited shipping from outside US Standard shipping from outside US Economy postage from outside UK Express postage from outside UK Standard postage from outside UK Economy postage from outside DE Standard postage from outside DE Express postage from outside DE DHL 2kg Paket (nur fuer kurze Zeit) Global Shipping Program This shipping service must be selected for the international leg of the shipment. Reserved for future use. Royal Mail Tracked 24 Royal Mail Tracked 48 This value indicates that the order will be delivered by an eBay On Demand valet through the eBay On Demand Delivery program. Type defining the ShippingServiceCostOverrideList container, which is used when the seller wants to override flat-rate shipping costs for one or more domestic and/or international shipping service options defined in the Business Policies shipping profile referenced in the SellerProfiles.SellerShippingProfile.ShippingProfileID field of an Add/Revise/Relist call. Shipping service cost overrides are a listing-level concept, and the shipping costs specified through each ShippingServiceCostOverrideList.ShippingServiceCostOverride container will not change the shipping costs defined for the same shipping services in the Business Policies shipping profile. A ShippingServiceCostOverride container is required for each domestic and/or international shipping service option, defined in the domesticShippingPolicyInfoService and intlShippingPolicyInfoService containers of the Business Policies shipping profile, that the seller wishes to override the shipping costs. Shipping costs include the cost to ship one item, the cost to ship each additional identical item, and any shipping surcharges applicable to domestic shipping services. Shipping service cost overrides are a listing-level concept, and the shipping costs specified through each ShippingServiceCostOverride container will not change the shipping costs defined for the same shipping service options in the Business Policies shipping profile. To override the shipping costs for any domestic shipping service option in the Business Policies shipping profile, the ShippingServiceType field should be set to 'Domestic', and to override the shipping costs for any international shipping service option, the ShippingServiceType field should be set to 'International'. For both domestic and international shipping services, the ShippingServicePriority value should match the sortOrderId value for the matching shipping service in the shipping profile. If any of the domestic and/or international shipping service priorities and shipping service options in the Add/Revise/Relist call and Business Policies shipping profile do not match, an error occurs. If shipping service cost overrides are used in a listing, the ShippingServiceCostOverride container will be returned in the GetItem, and GetSellerList calls. AddFixedPriceItem AddItem AddItems VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem No GetItem GetSellerList Conditionally Type defining the ShippingServiceCostOverride container, which is used to override the flat shipping costs for a domestic and/or international shipping service option that is defined in the domesticShippingPolicyInfoService and intlShippingPolicyInfoService containers of the Business Policies shipping profile. Shipping costs include the cost to ship one item, the cost to ship each additional identical item, and any shipping surcharges applicable to domestic shipping services. A ShippingServiceCostOverride container is required for each domestic and/or international shipping service option whose costs the seller wishes to override. This integer value maps the particular instance of the ShippingServiceCostOverride container to the domesticShippingPolicyInfoService or intlShippingPolicyInfoService container of the Business Policies shipping profile. The ShippingServicePriority value should match the sortOrderId value for the matching shipping service in the Business Policies shipping profile. If overriding the shipping costs for a domestic shipping service, the ShippingServiceType field should be set to 'Domestic', and to override the shipping costs for an international shipping service, the ShippingServiceType field should be set to 'International'. If any of the domestic and/or international shipping service priorities and shipping service options in the Add/Revise/Relist call and Business Policies shipping profile do not match, an error occurs. AddFixedPriceItem AddItem AddItems VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem No GetItem GetSellerList Conditionally This enumerated value indicates whether the shipping costs of a domestic or an international shipping costs are being overridden. To override the shipping costs for any domestic shipping service in the Business Policies shipping profile, this field should be set to 'Domestic', and to override the shipping costs for any international shipping service, this field should be set to 'International'. AddFixedPriceItem AddItem AddItems VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem No GetItem GetSellerList Conditionally This dollar value indicates the shipping service cost to ship one item to the buyer. If the shipping service costs override operation is successful, this value will override the corresponding shippingServiceCost value set in the domesticShippingPolicyInfoService (domestic shipping service) or intlShippingPolicyInfoService (international shipping service) containers in the Business Policies shipping profile. AddFixedPriceItem AddItem AddItems VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem No GetItem GetSellerList Conditionally This dollar value indicates the cost to ship each additional identical item to the buyer. If the shipping service costs override operation is successful, this value will override the corresponding shippingServiceAdditionalCost value set in the domesticShippingPolicyInfoService (domestic shipping service) or intlShippingPolicyInfoService (international shipping service) containers in the Business Policies shipping profile. This field is only applicable to multi-quantity, fixed-price listings. AddFixedPriceItem AddItem AddItems VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem No GetItem GetSellerList Conditionally Type used by the ShippingServiceDetails containers that are returned in the GeteBayDetails response. Each ShippingServiceDetails container consists of detailed information about each shipping service option available for the specified country. These details include the shipping service enumeration value to use when specifying shipping service options in an Add/Revise/Relist call, the shipping carrier, the shipping category (e.g. expedited, economy, etc.), the shipping packages that can be used, and the shipping delivery window. ShippingServiceDetails containers are returned if a DetailName field is included in the call request and set to <code>ShippingServiceDetails</code>, or if no DetailName field is included in the call request. Display string that applications can use to present a list of shipping service options in a more user-friendly format (such as in a drop-down list). GeteBayDetails Always Indicates whether a domestic shipping service option is an expedited shipping service. This field is only returned under a ShippingServiceDetails if <code>true</code>. Expedited generally means that the shipment of the order can arrive at the buyer's location within one or two business days. GeteBayDetails Conditionally Indicates whether the shipping service is an international shipping service. An international shipping service option is required if an item is being shipped from one country (origin) to another (destination). Item.ShippingDetails.InternationalShippingServiceOption in AddItem AddItem.html#Request.Item.ShippingDetails.InternationalShippingDiscountProfileID GeteBayDetails Conditionally The name of shipping service option. The ShippingServiceDetails.ValidForSellingFlow flag must also be present and <code>true</code>. Otherwise, that particular shipping service option is no longer valid and cannot be offered to buyers through a listing. This token value is the text that a seller will provide in the ShippingDetails.ShippingServiceOptions.ShippingService field when creating a listing. GeteBayDetails Conditionally Numeric identifier. A value greater than 50000 represents an international shipping service (confirmed by InternationalShippingService being true). Some applications use this ID to look up shipping services more efficiently. GeteBayDetails Conditionally The integer value returned here indicates the maximum number of business days that the shipping carrier (indicated in the corresponding ShippingCarrier field) will take to ship an item using the corresponding shipping service option (indicated in the ShippingService field). This maximum shipping time does not include the seller's handling time, and the clock starts on the shipping time only after the seller has delivered the item to the shipping carrier for shipment to the buyer. 'Business days' can vary by shipping carrier and by country, but 'business days' are generally Monday through Friday, excluding holidays. This field is returned if defined for that particular shipping service option. For sellers opted into and using eBay Guaranteed Delivery, they should be looking at this value, and this value plus their handling time stated in the listing cannot be greater than 4 business days in order for that listing to be eligible for eBay Guaranteed Delivery. GeteBayDetails Conditionally The integer value returned here indicates the minimum number of business days that the shipping carrier (indicated in the corresponding ShippingCarrier field) will take to ship an item using the corresponding shipping service option (indicated in the ShippingService field). This minimum shipping time does not include the seller's handling time, and the clock starts on the shipping time only after the seller has delivered the item to the shipping carrier for shipment to the buyer. 'Business days' can vary by shipping carrier and by country, but 'business days' are generally Monday through Friday, excluding holidays. This field is returned if defined for that particular shipping service option. GeteBayDetails Conditionally The shipping cost types that this shipping service option supports, such as flat-rate or calculated. A ServiceType field is returned for each shipping cost type supported by the shipping service option. GeteBayDetails Conditionally Flat, Calculated The shipping packages that can be used for this shipping service option. A ShippingPackage field is returned for each shipping package supported by the shipping service option. GeteBayDetails Conditionally This field is only returned if the shipping service option requires that package dimensions are provided by the seller. This field is only returned if 'true'. GeteBayDetails Conditionally If this field is returned as 'true', the shipping service option can be used in a Add/Revise/Relist API call. If this field is returned as 'false', the shipping service option is not currently supported and cannot be used in a Add/Revise/Relist API call. GeteBayDetails Conditionally This field is only returned if 'true', and indicates that a shipping surcharge is applicable for this shipping service option. GeteBayDetails Conditionally The enumeration value for the shipping carrier associated with the shipping service option. Note: Commonly used shipping carriers can also be found by calling GeteBayDetails with DetailName set to <code>ShippingCarrierDetails</code> and examining the returned ShippingCarrierDetails.ShippingCarrier field. GeteBayDetails Conditionally This field is deprecated, as there are longer any shipping services that support cash on delivery. A mechanism by which details about deprecation of a shipping service is announced. See also MappedToShippingServiceID. If this container is empty, it means that there is no mapping for this shipping service and that the shipping service will be dropped from the listing without an accompanying warning message from the eBay API. GeteBayDetails Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-deprecated.html Deprecated services The ID of another shipping service that will be used when a shipping service is deprecated. See also DeprecationDetails. GeteBayDetails Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-deprecated.html Deprecated services If returned, this is the shipping service group to which the shipping service belongs. Valid values are found in CostGroupFlatCodeType. CostGroupFlatCodeType GeteBayDetails Conditionally Shipping Package level details for the enclosing shipping service, this complex type replaces the existing ShippingPackage type. GeteBayDetails Conditionally If true, a seller who selects this package type for the listing and then offers this shipping service must specify WeightMajor and WeightMinor in the item definition. If not returned, WeightRequired is false. false GeteBayDetails Conditionally Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always Indicates the shipping category. Shipping categories include the following: <code>ECONOMY</code>, <code>STANDARD</code>, <code>EXPEDITED</code>, <code>ONE_DAY</code>, <code>PICKUP</code>, <code>OTHER</code>, and <code>NONE</code>. International shipping services are generally grouped into the <code>NONE</code> category. For more information about these shipping categories, see the <a href="http://pages.ebay.com/sellerinformation/shipping/chooseservice.html">Shipping Basics</a> page on the eBay Shipping Center site. Note: This field is returned only for those sites that support shipping categories: US (0), CA (2), CAFR (210), UK (3), AU (15), FR (71), DE (77), IT (101) and ES (186). GeteBayDetails Conditionally Container consisting of shipping costs and other details related to a domestic shipping service. A ShippingServiceOptions container is required for each domestic shipping service option that the seller will make available to buyers in an Add/Revise/Relist call. Up to four domestic shipping service options can be offered per listing. This enumeration value indicates a specific domestic shipping service option being offered by the seller to ship an item to a buyer who is located within the same country as the item. This field is required to identify each domestic shipping service option that is specified with a ShippingServiceOptions container. For a list of valid ShippingService values, call GeteBayDetails with DetailName set to <code>ShippingServiceDetails</code>. 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. To view the full list of domestic shipping service options in the response, look for the ShippingServiceDetails.ShippingService fields. Domestic shipping service options will not have a InternationalService = <code>true</code> field, as this indicates that the ShippingService value is an International shipping service option. Note: The eBay standard envelope (eSE) is a domestic envelope service with tracking through eBay. This service applies to specific sub-categories of Trading Cards, and to coins & paper money, postcards, stamps, patches, and similar <a href="https://www.ebay.com/sellercenter/shipping/choosing-a-carrier-and-service/ebay-standard-envelope#eligible-categories" target="_blank">eligible categories</a>, and is only available on the US marketplace. See <a href="https://pages.ebay.com/seller-center/shipping/ebay-standard-envelope.html#lower-cost-way" target="_blank">eBay standard envelope</a> for details, restrictions, and an <a href="https://ir.ebaystatic.com/pictures/sc/Shipping/ebay_standard_envelope_template.pdf" target="_blank">envelope size template</a>. To use this service, send envelopes using the USPS mail and set the ShippingService field to <code>US_eBayStandardEnvelope</code>. For the REST equivalent, see <a href="https://developer.ebay.com/api-docs/sell/static/seller-accounts/using-the-ebay-standard-envelope-service.html" target=/"_blank/">Using the eBay standard envelope (eSE) service</a>. ShippingServiceCodeType SendInvoice No AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemShipping GetMyeBayBuying Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GeteBayDetails https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/GeteBayDetails.html The base cost of shipping one unit of the item using the shipping service specified in the corresponding ShippingService field. In the case of a multiple-quantity, fixed-price listing, the ShippingServiceAdditionalCost field also becomes applicable, and shows the cost to ship each additional unit of the item if the buyer purchases multiple quantity of the same line item. Note: If the corresponding shipping service option is set as a 'free shipping' option (FreeShipping set to <code>true</code>) and flat-rate shipping is being used domestically (ShippingType is set to <code>Flat</code> or <code>FlatDomesticCalculatedInternational</code>), the seller must still include this ShippingServiceCost field and set its value to <code>0.0</code>, as eBay will not do this automatically. Do not include ShippingServiceCost when the domestic shipping service option is set to represent domestic calculated shipping (ShippingType is set to <code>Calculated</code> or <code>CalculatedDomesticFlatInternational</code>), as error 10019 occurs. When returned by GetItemShipping, it includes the packaging and handling cost. Note that if ShippingService is set to <code>LocalPickup</code>, ShippingServiceCost must be set to <code>0.0</code>. Also, if a shipping service has been specified (even LocalPickup), GetItem returns the shipping service cost, even if the cost is zero. If this is for calculated shipping for a listing that has not yet ended, note that the cost cannot be determined until the listing has ended and the buyer has specified a postal code. SendInvoice No AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping GetMyeBayBuying Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GetMyeBayBuying BidList WonList WatchList DeletedFromWonList BestOfferList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally The cost of shipping each additional item if the same buyer purchases multiple quantity of the same line item. This field is required when creating a multiple-quantity, fixed-price listing. Generally, the seller will give the buyer a shipping discount if that buyer purchases multiple quantity of the item, so this value should usually be less than the value set for ShippingServiceCost. The value of this field can even be set to <code>0</code> if the seller wants to encourage buyers to buy multiple quantity of the item, or it could be that the seller can fit multiple quantities of the line item in a single shipping package, so the seller is just passing this shipping savings onto the buyer. This field is not applicable for single-quantity listings. SendInvoice No AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping GetMyeBayBuying Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Controls the order (relative to other shipping services) in which the corresponding ShippingService will appear in the View Item and Checkout page. Sellers can specify up to four domestic shipping services (with four ShippingServiceOptions containers), so valid values are 1, 2, 3, and 4. A shipping service with a ShippingServicePriority value of 1 appears at the top. Conversely, a shipping service with a ShippingServicePriority value of 4 appears at the bottom of a list of four shipping service options. If this field is omitted from domestic shipping service options, the order of the shipping service options in View Item and Checkout pages will be determined by the order that these shipping service options are presented in the request payload of an Add/Revise/Relist call. SendInvoice No AddFixedPriceItem AddItem AddItems AddOrder RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList GetItemShipping GetMyeBayBuying Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This field is returned as <code>true</code> if the domestic shipping service is considered an expedited shipping service. An expedited service is typically a shipping service that can ship an order that will arrive at the buyer's location within one to two business days. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemShipping GetMyeBayBuying Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The integer value returned here indicates the minimum number of business days that the shipping service (indicated in the corresponding ShippingService field) will take to be delivered to the buyer. This minimum shipping time does not include the seller's handling time, and the clock starts on the shipping time only after the seller has delivered the item to the shipping carrier for shipment to the buyer. 'Business days' can vary by shipping carrier and by country, but 'business days' are generally Monday through Friday, excluding holidays. This field is returned if defined for that particular shipping service option. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemShipping GetMyeBayBuying Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The integer value returned here indicates the maximum number of business days that the shipping service (indicated in the corresponding ShippingService field) will take to be delivered to the buyer. This maximum shipping time does not include the seller's handling time, and the clock starts on the shipping time only after the seller has delivered the item to the shipping carrier for shipment to the buyer. 'Business days' can vary by shipping carrier and by country, but 'business days' are generally Monday through Friday, excluding holidays. This field is returned if defined for that particular shipping service option. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemShipping GetMyeBayBuying Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This boolean field indicates whether or not the corresponding domestic shipping service option is free to the buyer. In an Add/Revise/Relist call, free shipping can only be offered for the first specified shipping service (so, the corresponding ShippingServicePriority value should be <code>1</code> or included first in the call request). If 'free shipping' is for any other shipping service, this field is ignored. For 'Get' calls, including GetItem, this field is only returned if <code>1</code>. Note: If a seller is specifying a shipping service option as 'free shipping', in addition to this FreeShipping boolean field, the seller will also need to include the corresponding ShippingServiceCost field and set its value to <code>0.0</code>, as eBay will not do this automatically. Note: If the condition is certified refurbished (ConditionID set to <code>2000</code>, 'Certified - Refurbished'), you must offer a free shipping option. Set FreeShipping as <code>true</code> (or <code>1</code>) along with the ShippingServiceCost as <code>0.0</code> for the first domestic shipping service. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemShipping

DetailLevel: none, ReturnAll

Conditionally GetMyeBayBuying Conditionally https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-costs.html#free Free shipping The LocalPickup flag is used by the GetMyEbayBuying and GetMyEbaySelling calls to indicate whether the buyer has selected local pickup as the shipping option or the seller has specified local pickup as the first shipping option. The LocalPickup flag can also be used with other fields to indicate if there is no fee for local pickup. For example, if the LocalPickup flag is used with the ShippingServiceOptions and ShippingServiceCost fields, the seller can indicate that local pickup is an available option and that no is fee charged. This is the equivalent of free shipping. GetMyeBayBuying GetMyeBaySelling Conditionally For orders using eBay International Shipping, when using the GetOrders call, the OrderArray.Order.ShippingServiceSelected.ImportCharge field contains only customs charges. For the Global Shipping Program, which is only supported in the UK, this field contains the total cost of customs and taxes for the international leg of an order shipped using the Global Shipping Program. This amount is calculated and supplied for each item by the international shipping provider when a buyer views the item properties. GetItemShipping Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GetMyeBayBuying Conditionally This container is no longer applicable, and it was only applicable to eBay Now and 'eBay On Demand Delivery' orders, and neither of these features are available any longer. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The last time of day that an order using the specified shipping service will be accepted by the seller for the current listing. The cut off time applies and is returned only when the ShippingService field contains the name of a qualifying time-sensitive shipping service, such as <code>eBayNowImmediateDelivery</code>. The cut off time is set by eBay and determined in part by the policies and locations of the seller and the shipping carrier. GetItemShipping Conditionally Reserved for internal or future use. Packages supported by the enclosing shipping service. The name of the package type. GeteBayDetails Conditionally This field is only returned if package dimensions are required for the corresponding package type (ShippingServicePackageDetails.Name value) supported by the corresponding shipping service option (ShippingServiceDetails.ShippingService value). GeteBayDetails Conditionally This enumerated type defines the possible values that can be used in the ShippingServiceType field of the ShippingServiceCostOverride container. This value should be used if the seller is overriding shipping costs for all domestic shipping services defined in the Business Policies shipping profile. This value should be used if the seller is overriding shipping costs for all international shipping services defined in the Business Policies shipping profile. If the field is present, the corresponding feature applies to the category. The field is returned as an empty element (i.e., a boolean value is not returned). This type is no longer applicable as it only pertained to eBay Now orders, and eBay Now has been discontinued. This value indicates that the eBay Now order is ready for pickup by the eBay Now valet at the store. This value indicates that the eBay Now order was picked up by the eBay Now valet. This value is reserved for internal or future use. The shipping cost model offered by the seller. Flat shipping model: the seller establishes the cost of shipping and cost of shipping insurance, regardless of what any buyer-selected shipping service might charge the seller. Note: This shipping type includes an option for a Flat Rate Freight shipping service. For details about freight shipping, see <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-types-rates.html#SpecifyingFreightShipping">Specifying Freight Shipping</a> in the eBay Features Guide. Calculated shipping model: the cost of shipping is determined in large part by the seller-offered and buyer-selected shipping service. The seller might assess an additional fee via PackagingHandlingCosts. Freight shipping model. Available only for US domestic shipping. The cost of shipping is automatically determined by an affiliated third party, FreightQuote.com, based on the item location (postal code). Note: This shipping type cannot be set via API, but it is automatically set by eBay when a buyer selects the FreightQuote.com option on the US eBay website. For details about types of freight shipping that you can specify via API, see <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-freight.html" target="_blank"> Freight shipping</a> in the Trading API User Guide. Free shipping. This field is output-only so if you want to use AddItem to specify a free Shipping Cost, specify 0 in Item.ShippingDetails.ShippingServiceOptions.ShippingServiceCost. The seller did not specify the shipping type. The seller specified one or more flat domestic shipping services and one or more calculated international shipping services. The seller specified one or more calculated domestic shipping services and one or more flat international shipping services. Freight shipping model. Available only for the US, UK, AU, CA and CAFR sites, and only for domestic shipping. <code>FreightFlat</code> applies to shipping with carriers that are not affiliated with eBay. It is negotiated freight, not a flat rate. Sellers negotiate the shipping cost with their chosen carrier and the buyer before completing the sale. FreightFlat shipping may be used when calculated shipping cannot be used due to the greater weight of the item. For details about freight shipping, see <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-freight.html" target="_blank">Freight shipping</a> in the Trading API User Guide. Reserved for future use. This enumerated type defines the sort values that can be used in the FavoriteSearch.ItemSort filter in a GetMyeBayBuying request. Sorts items by Best Match, and no sort order applies. If specified, then Best Match sort also applies to CategoryHistogram. This value is reserved for future or internal use. Sorts by the end time of the listing, in ascending or descending order according to the SortOrder value. Sorts by number of bids on the item, in ascending or descending order according to the SortOrder value. Sorts by country; no sort order can be specified. Sorts by current bid; descending order only. Sorts by distance; ascending order only. Sorts by the start time of the listing; recently-listed first. Sorts by BestMatchCategoryGroup, so results are grouped by Best Match within a category. Sorts by total cost, which is item cost plus shipping cost. If SortOrder is included and set to 'Ascending', items are sorted in the following order: Lowest total cost (for items where shipping was properly specified); then freight-shipping items (lowest to highest); and finally, items for which shipping was not specified (lowest to highest). Type defining the BuyerRequirementDetails container, which is returned in GeteBayDetails, and provides the seller with the buyer requirement features (and applicable values) that are supported by the listing site. Note: This container is only returned if BuyerRequirementDetails is included as a DetailName filter in the call request, or if no DetailName filters are used in the request. This field is deprecated. GeteBayDetails Conditionally Note: This field is no longer applicable, as sellers can no longer set the Buyer Requirement that buyers must have only a certain amount of buyer policy violations within a specified amount of time in order to purchase an item. GeteBayDetails Conditionally This container shows the supported values that can be set as the MaximumItemCount and MinimumFeedbackScore to help control inexperienced or low Feedback bidders/buyers from bidding on or buying an item in a listing. GeteBayDetails Conditionally This container shows the supported values that can be set as the Maximum Unpaid Item count and period (number of days) to block buyers who have recent Unpaid Item Strikes from bidding on or buying an item in a listing. GeteBayDetails Conditionally Note: This field is no longer applicable, as sellers can no longer set a buyer's Minimum Feedback Score threshold Buyer Requirement at the listing-level in Add/Revise/Relist calls. GeteBayDetails Conditionally A <code>true</code> value returned in this field indicates that the ShipToRegistrationCountry Buyer Requirement is supported for the specified site. GeteBayDetails Conditionally Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always Gives the time in GMT when the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always eBay sites (by the country in which each resides) on which a user is registered and on which items can be listed through the Trading API. China, Sweden, Taiwan USA, site ID 0, abbreviation US, currency USD. (<a href="http://www.ebay.com" target="_blank">http://www.ebay.com</a>) Canada, site ID 2, abbreviation CA, currencies CAD and USD. (<a href="http://www.ebay.ca" target="_blank">http://www.ebay.ca</a>) United Kingdom, site ID 3, abbreviation UK, currency GBP. (<a href="http://www.ebay.co.uk" target="_blank">http://www.ebay.co.uk</a>) Australia, site ID 15, abbreviation AU, currency AUD. (<a href="http://www.ebay.com.au" target="_blank">http://www.ebay.com.au</a>) Austria, site ID 16, abbreviation AT, currency EUR. (<a href="http://www.ebay.at" target="_blank">http://www.ebay.at</a>) Belgium (French), site ID 23, abbreviation BEFR, currency EUR. (<a href="http://www.ebay.be" target="_blank">http://www.ebay.be</a>) France, site ID 71, abbreviation FR, currency EUR. (<a href="http://www.ebay.fr" target="_blank">http://www.ebay.fr</a>) Germany, site ID 77, abbreviation DE, currency EUR. (<a href="http://www.ebay.de" target="_blank">http://www.ebay.de</a>) Italy, site ID 101, abbreviation IT, currency EUR. (<a href="http://www.ebay.it" target="_blank">http://www.ebay.it</a>) Belgium (Dutch), site ID 123, abbreviation BENL, currency EUR. (<a href="http://www.ebay.be" target="_blank">http://www.ebay.be</a>) Netherlands, site ID 146, abbreviation NL, currency EUR. (<a href="http://www.ebay.nl" target="_blank">http://www.ebay.nl</a>) Spain, site ID 186, abbreviation ES, currency EUR. (<a href="http://www.ebay.es" target="_blank">http://www.ebay.es</a>) Switzerland, site ID 193, abbreviation CH, currency CHF. (<a href="http://www.ebay.ch" target="_blank">http://www.ebay.ch</a>) Taiwan, currency TWD. Note that the old eBay Taiwan site is no longer in operation, and the new site does not use this API. Although Site ID 100 is still valid in APIs, eBay Motors US is no longer its own site, but just a vertical within the eBay US site. Hong Kong, site ID 201, abbreviation HK, currency HKD. (<a href="http://www.ebay.com.hk" target="_blank">http://www.ebay.com.hk</a>) Singapore, site ID 216, abbreviation SG, currency SGD. (<a href="http://www.ebay.com.sg" target="_blank">http://www.ebay.com.sg</a>) India, site ID 203, abbreviation IN, currency INR. (<a href="http://www.ebay.in" target="_blank">http://www.ebay.in</a>) Ireland, site ID 205, abbreviation IE, currency EUR. (<a href="http://www.ebay.ie" target="_blank">http://www.ebay.ie</a>) Malaysia, site ID 207, abbreviation MY, currency MYR. (<a href="http://www.ebay.com.my" target="_blank">http://www.ebay.com.my</a>) Philippines, site ID 211, abbreviation PH, currency PHP. (<a href="http://www.ebay.ph" target="_blank">http://www.ebay.ph</a>) Poland, site ID 212, abbreviation PL, currency PLN. (<a href="http://www.ebay.pl" target="_blank">http://www.ebay.pl</a>) Reserved for internal or future use. Canada French, site ID 210, abbreviation CAFR, currencies CAD and USD. Russia, site ID 215, abbreviation RU, currency RUB. Sellers must use Merchant Integration Platform (MIP) to create and revise listings on the Russia site. Russian listings cannot be created or revised through the Trading API's add and revise calls, so 'Russia' would not be a valid value to pass in through Item.Site field of an Add or Revise Trading API call. Czechia, site ID 197, abbreviation CZ, currency CZK. This site cannot be set in the X-EBAY-API-SITEID header, nor in the Site field of a request payload. This enumeration value will only be returned in output fields if applicable. Cyprus, abbreviation CY, currency CYP. This site cannot be set in the X-EBAY-API-SITEID header, nor in the Site field of a request payload. This enumeration value will only be returned in output fields if applicable. This type is used by the SiteDefaults container to display the features/settings that are default for most categories on the eBay marketplace. ProductCreationEnabled A ListingDuration field will be returned for each different listing type that is supported on the eBay marketplace. Each field will show the listing type and the identifier associated with this listing type. These IDs will be used to match the default listing duration values that are displayed in the FeatureDefinitions.ListingDurations containers. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether sellers are required to specify a domestic shipping service and its associated cost when listing items. True means the shipping terms are required unless a specific category overrides this setting. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether categories allow Best Offers. A value of <code>true</code> means Best Offers are allowed site-wide, unless a specific category overrides the setting. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is no longer applicable as Dutch auctions are no longer available on eBay sites. Specifies the default site setting for whether a bidder must consent to the bid by confirming that he or she read and agrees to the terms in eBay's privacy policy. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether categories allow the ProPack feature (a feature pack). True means ProPack is allowed site-wide, unless a specific category overrides the setting. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether categories allow the BasicUpgradePack feature (a feature pack). No longer allowed on any sites. Formerly, Australia site (site ID 15, abbreviation AU) only. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether categories allow the ValuePack feature (a feature pack). A value of <code>true</code> means it is allowed site-wide, unless a specific category overrides the setting. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether categories allow the ProPackPlus feature (a feature pack). A value of <code>true</code> means it is allowed site-wide, unless a specific category overrides the setting. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether categories allow Classified Ad format listings. A value of <code>true</code> means the feature is allowed site-wide, unless a specific category overrides the setting. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether categories allow counter offers for Best Offers. A value of <code>true</code> means counter offers are allowed site-wide, unless a specific category overrides the setting. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether categories allow auto decline for Best Offers. A value of <code>true</code> means auto decline is allowed site-wide, unless a specific category overrides the setting. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether LocalMarketSpecialitySubscription feature is supported for most categories. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether LocalMarketRegularSubscription feature is supported for most categories. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether LocalMarketPremiumSubscription feature is supported for most categories. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether LocalMarketNonSubscription feature is supported for most categories. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is deprecated. 579 681 NoOp This field is deprecated. 579 681 NoOp This field is deprecated. 579 681 NoOp Specifies the default site setting for whether the Minimum Reserve Price feature is supported for most categories. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether most categories allow seller-level contact information for Classified Ad listings. A value of <code>true</code> means seller-level contact information is available for Classified Ad format listings site-wide, unless a specific category overrides the setting. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether the Transaction Confirmation Request feature is supported for most categories. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is is no longer applicable. This feature is no longer applicable. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This feature is no longer applicable. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the supported local listing distances of regular vehicles for most categories. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the supported local listing distances of specialty vehicles for most categories. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the supported local listing distances for most categories, for users who have not subscribed to either Regular or Specialty vehicles. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates if the payment method should be displayed to the user for most categories. Even if enabled, checkout may or may not be enabled. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates if shipping options are available for most categories. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates if Best Offer is enabled for Classified Ad listings in most categories. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether counter offers are allowed on Best Offers for most categories. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether automatic decline for Best Offers is allowed for most categories. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether most categories support including a phone number in the seller's contact information. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether most categories support including an email address in the seller's contact information. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally eBay controls all forms of electronic payment methods that are avaialable to buyers, so this field is no longer applicable. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether the pay-per-lead feature is supported for most categories. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally The value returned in this field indicates whether most categories on the specified eBay site support listings with Item Specifics. Item Specifics enable sellers to present descriptive details of an item in a structured manner. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether the category is enabled for the BrandMPN field for a specific item. If <code>true</code>, sellers can add BrandMPN for that item. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether categories allow auto-accept for Best Offers for Classified Ads. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether categories allow auto-accept for Best Offers. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether categories allow you to specify that listings be displayed in the default search results of the respective sites. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether categories allow you to specify that listings be displayed in the default search results of the respective site. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether categories allow you to specify that listings be displayed in the default search results of the respective site. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally For the Australia site, if the BuyerGuaranteeEnabled is returned, then the default site setting is that categories allow buyer protection. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is deprecated. Specifies the default site setting that enables durations for "Gallery Featured". GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is deprecated. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether categories allow Classified Ad listings. A value of <code>true</code> means the feature is allowed site-wide, unless a specific category overrides the setting. This element is for eBay Motors Pro users. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether most categories support including a phone number in the seller's contact information. This element is for eBay Motors Pro users. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates which telephone option is enabled to contact the seller. This element is for eBay Motors Pro users. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether most categories support including an address in the seller's contact information. This element is for eBay Motors Pro users. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates which address option is enabled to contact the seller. This element is for eBay Motors Pro users. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether most categories support including a company name in the seller's contact information. This element is for eBay Motors Pro users. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether most categories support including an email address in the seller's contact information. This element is for eBay Motors Pro users. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates if Best Offer is enabled for Classified Ad listings in most categories. This element is for eBay Motors Pro users. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether categories allow auto-accept for Best Offers for Classified Ads. This element is for eBay Motors Pro users. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether categories allow auto-decline for Best Offers for Classified Ads. This element is for eBay Motors Pro users. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates if the payment method should be displayed to the user for most categories. Even if enabled, checkout may or may not be enabled. This element is for eBay Motors Pro users. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates if shipping options are available for most categories. This element is for eBay Motors Pro users. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether counter offers are allowed on Best Offers for most categories. This element is for eBay Motors Pro users. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether most categories allow seller- level contact information for Classified Ad format listings. A value of <code>true</code> means seller-level contact information is available for Classified Ad listings site-wide, unless a specific category overrides the setting. This element is for eBay Motors Pro users. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether most categories support including a phone number in the seller's contact information. This element is for Local Market dealers. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates which telephone option is enabled to contact the seller. This element is for Local Market dealers. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether most categories support including an address in the seller's contact information. This element is for Local Market dealers. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates which address option is enabled to contact the seller. This element is for Local Market dealers. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether most categories support including a company name in the seller's contact information. This element is for Local Market dealers. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether most categories support including an email address in the seller's contact information. This element is for Local Market dealers. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates if Best Offer is enabled for Classified Ad listings in most categories. This element is for Local Market dealers. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether categories allow auto-accept for Best Offers for Classified Ads. This element is for Local Market dealers. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether categories allow auto-decline for Best Offers for Classified Ads. This element is for Local Market dealers. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates if the payment method should be displayed to the user for most categories. Even if enabled, checkout may or may not be enabled. This element is for Local Market dealers. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates if shipping options are available for most categories. This element is for Local Market dealers. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether counter offers are allowed on Best Offers for most categories. This element is for Local Market dealers. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether most categories allow seller- level contact information for Classified Ad format listings. A value of <code>true</code> means seller-level contact information is available for Classified Ad format listings site-wide, unless a specific category overrides the setting. This element is for Local Market dealers. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates which telephone option is enabled to contact the seller. This element is for For Sale By Owner. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether most categories support including an address in the seller's contact information. This element is for For Sale By Owner. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates which address option is enabled to contact the seller. This element is for For Sale By Owner. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether most categories support including a company name in the seller's contact information. This element is for For Sale By Owner. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether LocalMarketSpecialitySubscription feature is supported for most categories. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether LocalMarketRegularSubscription feature is supported for most categories. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether LocalMarketPremiumSubscription feature is supported for most categories. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the supported local listing distances for most categories, for users who have not subscribed to either Regular or Specialty vehicles. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is deprecated. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Defines if quantity can be revised while a listing is in semi or fully restricted mode. Applies to fixed-price listings. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Defines if price can be revised while a listing is in semi or fully restricted mode. Applies to fixed-price listings. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Defines if extended business seller listing durations are enabled on a given site. When the value of this element is <code>true</code>, it means the listing duration values defined in StoreOwnerExtendedListingDurations are applicable to fixed-price listings. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Provides additional listings durations that are supported by Store Owners. The extended listing durations provided here in this element should be merged in with the baseline listing durations provided in the ListingDurations container. GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Specifies the default site setting for whether a return policy is required for most categories. For most sites: If true, listings in most categories require a return policy. For eBay Australia (AU) and US eBay Motors Parts and Accessories: If true, most categories support but do not require a return policy. Individual categories can override the site default. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether a handling time (dispatch time) is required for most categories. The handling time is the maximum number of business days the seller commits to for preparing an item to be shipped after receiving a cleared payment. The seller's handling time does not include the shipping time (the carrier's transit time). If <code>false</code>, most listings on the site require a handling time (see DispatchTimeMax in AddItem) when flat or calculated shipping is specified. (A handling time is not required for local pickup or for freight shipping.) For a list of the handling time values allowed for each site, use DispatchTimeMaxDetails in GeteBayDetails. Note: Although the field name ends with "Enabled", a value of <code>true</code> means that a handling time is NOT required, and value of <code>false</code> means that a handling time IS required. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether a maximum flat rate shipping cost is imposed for listings in most categories on the site. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Flat rate shipping https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/shipping-flat-rate.html#max-flat Specifies the default site setting for whether a maximum flat rate shipping cost is imposed on sellers who list in categories on this site yet are shipping an item into the country of this site from another country. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Returns the applicable max cap per shipping cost for shipping service group2 GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Returns the applicable max cap per shipping cost for shipping service group3 GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates the acceptable payment methods that can be used when using the Add/Revise/Relist calls for an item listed on the corresponding site. Note: eBay now controls all electronic payment methods available to buyers, but sellers still need to specify offline payment methods for listings that require/support offline payment such as motor vehicle listings. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether categories support multi-variation listings. If true, you can pass in Item.Variations in the AddFixedPriceItem family of calls when you list in categories that support this feature. Multi-variation listings contain items that are logically the same product, but that vary in their manufacturing details or packaging. For example, a particular brand and style of shirt could be available in different sizes and colors, such as "large blue" and "medium black" variations. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is deprecated. Specifies the default site setting for whether categories allow free, automatic upgrades for Gallery Plus, which enhances pictures in search results. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether categories allow free, automatic upgrades for Picture Pack, a discount package that includes super-sizing of pictures. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether listing items with parts compatibility is supported by application (<code>ByApplication</code>), by specification (<code>BySpecification</code>), or not at all (<code>Disabled</code>). A given category cannot support both types of parts compatibility. Parts compatibility listings contain information to determine the assemblies with which a part is compatible. For example, an automotive part or accessory listed with parts compatibility can be matched with vehicles (e.g., specific years, makes, and models) with which the part or accessory can be used. Parts Compatibility is supported in limited Parts & Accessories categories for the US eBay Motors site only. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Parts and accessories https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-motors-parts-accessories.html#search Specifies the default site setting for whether parts compatibility information is required when listing items, and if so, how many compatibilities must be specified. If the value is "0," you are not required to specify compatibility information. A value greater than "0" indicates that listing with parts compatibity is mandatory and the listing must contain the specified number of compatibilities at a minimum. Parts compatibility listings contain information to determine the assemblies with which a part is compatible. For example, an automotive part or accessory listed witih parts compatibility can be matched with vehicles (e.g., specific years, makes, and models) with which the part or accessory can be used. This field applies only to listings in which compatibility is specified by application. Entering parts compatibility by application specifies the assemblies (e.g., a specific year, make, and model of car) to which the item applies. This can be done automatically by listing with a catalog product that supports parts compatibility, or manually, using Item.ItemCompatibilityList when listing or revising an item. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for the maximum number of compatible applications allowed per item when adding or revising items with parts compatibility. Parts compatibility listings contain structured information to determine the assemblies with which a part is compatible. For example, an automotive part or accessory listed with parts compatibility can be matched with vehicles (e.g., specific years, makes, and models) with which the part or accessory can be used. This field applies only to listings in which compatibility is specified by application manually when listing or revising an item. Entering parts compatibility by application manually specifies the assemblies (e.g., a specific year, make, and model of car) to which the item applies, using Item.ItemCompatibilityList. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether most categories support (or require) Item.ConditionID in listings. Use this to determine whether to use ConditionID in AddItem and related calls. See ConditionValues for a list of valid IDs. In general, this is set to <code>Disabled</code>, and meta-categories (level 1 categories) define their own default settings. Disabled GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This container shows the site default item condition values. Individual leaf categories define their own default set of item condition values and always override this list. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This container shows the site default special item condition values, such as Certified - Refurbished condition (condition ID 2000), Excellent - Refurbished condition (condition ID 2010), Very Good - Refurbished condition (condition ID 2020), and Good - Refurbished condition (condition ID 2030). A seller must be pre-qualified by eBay to list items with the any of these refurbished item conditions. All other item conditions supported by a category will be returned in the ConditionValues container instead. Individual leaf categories define their own default set of item condition values and always override this list. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the default site setting for whether most categories follow specific rules associated with "value categories". Some eBay sites may select a few categories and designate them as "value categories". These are typically selected from categories where buyers can find great deals. (Not all categories with great deals are designated as value categories.) This designation can change over time. While a category is designated as a value category (i.e., when ValueCategory = <code>true</code>), it is subject to the following rule: Items in value categories can only be listed in one category. For example, if you attempt to list in two categories and the PrimaryCategory or SecondaryCategory is a value category, then eBay drops the SecondaryCategory and lists the item in the PrimaryCategory only. Similarly, if you attempt to add a secondary category to an existing listing, or you change the category for an existing listing, and if the primary or secondary category is a value category, then eBay drops the secondary category. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is no longer applicable. Disabled GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This enumeration value indicates whether or not most categories on the specified eBay site support the use of European Article Numbers (EANs) to help create a listing in an Add/Revise/Relist/Verify API call. <ul> <li>A value of <code>Disabled</code> indicates that EANs cannot be used for most categories on the specified eBay site. </li> <li>A value of <code>Enabled</code> indicates that EANs can be used for most categories on the specified eBay site. </li> <li>A value of <code>Required</code> indicates that an EAN is required for most categories on the specified eBay site. </li> </ul> GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This enumeration value indicates whether or not most categories on the specified eBay site support the use of International Standard Book Numbers (ISBNs) to help create a listing in an Add/Revise/Relist/Verify API call. A value of <code>Disabled</code> indicates that ISBNs cannot be used for most categories on the specified eBay site, a value of <code>Enabled</code> indicates that ISBNs can be used for most categories on the specified eBay site, and a value of <code>Required</code> indicates that an ISBN is required for most categories on the specified eBay site. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This enumeration value indicates whether or not most categories on the specified eBay site support the use of Universal Product Codes (UPCs) to help create a listing in an Add/Revise/Relist/Verify API call. A value of <code>Disabled</code> indicates that UPCs cannot be used for most categories on the specified eBay site, a value of <code>Enabled</code> indicates that UPCs can be used for most categories on the specified eBay site, and a value of <code>Required</code> indicates that a UPC is required for most categories on the specified eBay site. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies the maximum fitment count. Sellers can provide up to 1000 fitments at the lowest level of granularity. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates the type of vehicle; car, truck, boat, or motorcycle. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies what categories the Shipping profile is applicable to. Only returned when this value (or this category's setting) overrides the value inherited from the category's parent. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies what categories the Payment profile is applicable to. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Specifies what categories the Return Policy profile is applicable to. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally After EOL Attributes, VIN will no longer be supported as primary attributes, rather consumers should use new tag. This feature helps consumers in identifying if category supports VIN. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally After EOL Attributes, VRM will no longer be supported as primary attributes, rather consumers should use new tag. This feature helps consumers in identifying if category supports VRM. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally After EOL Attributes, Seller Provided Title will no longer be supported as primary attributes, rather consumers should use new tag. This feature helps consumers in identifying if category supports Seller Provided Title. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally After EOL Attributes, Deposit will no longer be supported as primary attributes, rather consumers should use new tags. This feature helps consumers in identifying if category supports Deposit. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether or not the the specified category is enabled for Global Shipping Program. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether most categories on the specified eBay site support the Boat and Motorcycle Parts Compatibility feature. The Boats Parts Compatibility feature allows sellers to list their boats' parts and accessories items with parts compatibility name-value pairs specific to boats, and allows potential buyers to search for these items using parts compatibility search fields. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Indicates whether most categories on the specified eBay site support the "Click and Collect" feature. With the 'Click and Collect' feature, a buyer can purchase certain items on an eBay site and collect them at a local store. Buyers are notified by eBay once their items are available. The "Click and Collect" feature is only available to large merchants on the UK and Australia sites. The 'Click and Collect' feature is only available to large merchants on the eBay UK (site ID - 3), eBay Australia (Site ID - 15), and eBay Germany (Site ID - 77) sites. Note: For Click and Collect eligible sellers, the Click and Collect feature can only be enabled at the account level, and then each of the seller's listings within an Click and Collect enabled category will be automatically evaluated for Click and Collect eligibility. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field indicates whether or not most categories on the specified eBay site support digital gift cards. Digital gift cards are currently only supported on the US site. There are some restrictions when it comes to selling gift cards, including the following:
<ul> <li>Each seller can only have one gift card listing at any given time</li> <li>The maximum dollar value of the gift card may not exceed 500.00</li> <li>Prepaid credit cards from American Express, Discover, MasterCard, or Visa are not allowed</li> </ul> For more information on eBay's Gift Card policy, see the <a href="http://pages.ebay.com/help/policies/gift.html">Gift cards policy</a> Help page. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as <code>true</code> if one or more categories on an eBay site support the use of an eBay Product ID (e.g. ePID) in an Add/Revise/Relist API call to identify which motorcycles and/or scooters are compatible with a motor vehicle part or accessory. ePIDs can only be used to identify motorcycles and scooters on the Germany and UK sites. For more information on using an ePID to identify a compatible motorcycle or scooter through an Add/Revise/Relist API call on the Germany or UK site, see the documentation for the <a href=" https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/AddItem.html#Request .Item.ItemCompatibilityList.Compatibility.NameValueList">Compatibility.Name ValueList</a> container. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is returned as <code>true</code> if one or more categories on an eBay site support the use of a K Type vehicle number in an Add/Revise/Relist API call to identify which cars and/or trucks are compatible with a motor vehicle part or accessory. K type vehicle numbers can only be used to identify cars and trucks on the Germany site. For more information on using a K Type vehicle number to identify a compatible car or truck through an Add/Revise/Relist API call on the Germany site, see the documentation for the <a href=" https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/AddItem.html#Request .Item.ItemCompatibilityList.Compatibility.NameValueList">Compatibility.Name ValueList</a> container. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field is deprecated. No eBay categories require listings based on an eBay catalog product. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field returns the options a seller has for accepting or not accepting returns from domestic buyers. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated marketplace and category. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field returns the options a seller has for accepting or not accepting returns from international buyers. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated marketplace and category. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field returns the options a seller has for specifying the return period for returns from domestic buyers. The return period is the amount of time the buyer has to initiate a return once they have received the item. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated marketplace and category. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field returns the options a seller has for specifying the return period for returns from international buyers. The return period is the amount of time the buyer has to initiate a return once they have received the item. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated marketplace and category. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field returns the options a seller has for specifying who pays the return shipping cost for domestic returns. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated marketplace and category. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This field returns the options a seller has for specifying who pays the return shipping cost for international returns. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated marketplace and category. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally In US, sellers can offer an item replacement in addition to offering money-back for domestic returns. This field returns the options a seller has for specifying how they will handle domestic returns. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated marketplace and category. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally In US, sellers can offer an item replacement in addition to offering money-back for international returns. This field returns the options a seller has for specifying how they will handle international returns. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated marketplace and category. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally In some EU countries, sellers are legally required to describe the return policy they offer. This field returns a flag that indicates whether or not the seller can specify their return-policy details in the associated marketplace. The values returned in this field are pertinent only if ReturnPolicyEnabled in GetCategoryFeatures is set to <code>true</code> for the associated marketplace and category. GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally Details about a specific site. Short name that identifies an eBay site. Usually, an eBay site is associated with a particular country or region (e.g., US or Belgium_French). Specialty sites (e.g., eBay Stores) use the same site ID as their associated main eBay site. The US eBay Motors site is an exception to this convention. Item.Site in AddItem AddItem.html#Request.Item.Site User.Site in GetUser GetUser.html#Response.User.Site GeteBayDetails Conditionally Numeric identifier for an eBay site. If you are using the SOAP API, you use numeric site IDs in the request URL. If you are using the XML API, you use numeric site IDs in the X-EBAY-API-SITEID header. GeteBayDetails Conditionally Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always Type defining the SiteHostedPictureDetails container that is returned in an UploadSiteHostedPictures call. The seller-defined name for the picture. This field is only returned if a PictureName value was specified in the request. A name for a picture can make it easier to track than an arbitrary, eBay-assigned URL. UploadSiteHostedPictures Conditionally This enumeration value indicates the size of the generated picture. This value may differ from the one specified in the request (e.g. if a Supersize image cannot be generated). UploadSiteHostedPictures Always This enumeration value indicates the image format of the generated image, such as JPG, GIF, or PNG. UploadSiteHostedPictures Always This is the full URL for the uploaded picture on the EPS server. This value should be stored by the seller, as this URL will be needed when create, revise, or relist an item and add this image to the listing. UploadSiteHostedPictures Always This is the truncated version of the full URL. UploadSiteHostedPictures Always The URL and size information for each generated image. UploadSiteHostedPictures Always The URL of the external Web site hosting the uploaded photo. This field is returned if an ExternalPictureURL is provided in the call request. 500 1 UploadSiteHostedPictures Conditionally This timestamp indicates when the picture must be uploaded with an eBay listing before it is purged from the EPS server. By default, unpublished pictures (not associated with an active eBay listing) are kept on the EPS server for thirty days. UploadSiteHostedPictures Always This type is no longer applicable as member communication through Skype has been disabled in API calls. This type is no longer applicable as member communication through Skype has been disabled in API calls. This type specifies the sort order of a returned array of elements. The array or list to be sorted, the sort key, and the default sort order depend on the call. The results will be sorted by the specified key in ascending (low to high) order. The results will be sorted by the specified key in descending (high to low) order. (out) Reserved for internal or future use. Indicates category support for listing of Local Market items by sellers subscribed to Local Market for Specialty Vehicles. Each of the subscriptions will have following options, which will define "National" vs "Local" ad format listing. "LocalOptional" : This will allow national and local listing. "LocalOnly" : Seller can have Local listings only. "NationalOnly" : Seller can not opt into local only exposure. It has to be national listing. Type defining the Statements regulatory container used at the listing level to provide statements for the listing. This field sets the statement code(s) for hazard or product safety statement(s) for the listing. If your product contains hazardous substances or mixtures, please select the values corresponding to the hazard statements that are stated on your product's Safety Data Sheet. The selected hazard information will be displayed on your listing. If your product shows universal product safety or compliance warnings, please select the values corresponding to the product safety statements for display in the product safety section of the listing. A separate Statement field is required for each hazard or product safety statement. The seller specifies the identifier of each statement in this field. Note: For hazmat statements, use the <a href="https://developer.ebay.com/api-docs/sell/metadata/resources/marketplace/methods/getHazardousMaterialsLabels">getHazardousMaterialsLabels</a> method in the <a href="https://developer.ebay.com/api-docs/sell/metadata/resources/methods">Metadata API</a> to find supported values for a specific marketplace/site. For sample values, see <a href="https://developer.ebay.com/api-docs/sell/static/metadata/feature-regulatorhazmatcontainer.html#Hazard" target="_blank">Hazard statement sample values</a>. For product safety statements, use the <a href = "/api-docs/sell/metadata/resources/marketplace/methods/getProductSafetyLabels" target="_blank">getProductSafetyLabels</a> method in the <a href="https://developer.ebay.com/api-docs/sell/metadata/resources/methods">Metadata API</a> to find supported values for a specific marketplace/site. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem Conditionally This type is no longer used and was replaced by ShippingLocationDetails. This field is deprecated. This field is deprecated. This field is deprecated. Specifies the type of action to carry out with SetStoreCategories. (in) Add the listed categories to the store. (in) Delete the listed categories from the store. (in) Move the listed categories from one place in the store category structure to another. (in) Rename the listed store categories to the names provided. (out) Reserved for internal or future use. This type holds an array of custom categories set up by a seller for their eBay Store. This container is used to express details about a customized eBay Store category. GetStore Always SetStoreCategories Yes This type is used to express details about a customized eBay Store category. Unique identifier of an eBay Store's custom category. eBay auto-generates this identifier when a seller establishes a custom store category. This category ID should not be confused with an eBay category ID. This field is conditionally required for SetStoreCategories, if the Action value is set to <code>Rename</code>, <code>Move</code> or <code>Delete</code>. GetStore SetStoreCategories Always SetStoreCategories Conditionally The seller-specified name of the custom category. This field is conditionally required for SetStoreCategories, if the Action value is set to <code>Add</code>. GetStore SetStoreCategories Always SetStoreCategories Conditionally The order in which the custom store category appears in the list of store categories when the eBay store is visited. GetStore SetStoreCategories Always SetStoreCategories No This container is used if the seller wants to add child categories to a top-level eBay store category. eBay Stores support three category levels. 3 GetStore SetStoreCategories Always SetStoreCategories Conditionally This type is no longer applicable, as Store Inventory is no longer a supported eBay listing type. List of available options for how items are sorted in an eBay Store. Lists items with those ending soon listed first. Lists items with those newly listed appearing in the list first. Lists items by price in ascending order. The item with the lowest starting price is listed first. Lists items by price in descending order. The item with the highest starting price is listed first. Lists items by combined price and shipping cost in ascending order. The item with the lowest combined starting price plus shipping cost is listed first. Reserved for future use. Lists items by combined price and shipping cost in descending order. The item with the highest combined starting price plus shipping cost is listed first. (out) Reserved for internal or future use. Store logo. The URL of the seller's store logo. 1267 1279 NoOp SetStore Conditionally GetStore Conditionally If the field is present, the corresponding feature applies to the category. The field is returned as an empty element (i.e., a boolean value is not returned). If the field is present, the corresponding feature applies to the category. The field is returned as an empty element (i.e., a boolean value is not returned). This type is used to specify the additional listing durations that are available to sellers who have eBay Store subscriptions. The StoreOwnerExtendedListingDurations container is only returned under the SiteDefaults node if the eBay marketplace supports additional listing durations for eBay Store owners, and this container is only returned under a Category node if this eBay category supports additional listing durations for eBay Store owners (other than the durations that are already supported for the category). Specifies the additional listing duration(s) (in days) supported by the eBay site and/or category. A Duration field is returned for each additional listing duration that the eBay marketplace or category supports. ListingDurationCodeType GetCategoryFeatures

DetailLevel: ReturnAll

Conditionally This type is used to provide details about a seller's eBay Store. Name of the eBay Store. The name is shown at the top of the Store page. 35 GetStore Always The URL path of the Store (58 characters maximum). Only if you are using Chinese characters in the Name property do you need to use this field, such as if you are opening a Store on the Taiwan site. The reason for this is that the URL path is normally derived from the Store name, but it cannot be derived from the name of the Store if it contains Chinese characters because URLs cannot contain Chinese characters. GetStore Conditionally The complete URL of the user's Store. This field is only ever returned, and does not need to be explicitly set. GetStore Conditionally The seller-provided description of the eBay Store. 300 GetStore Always This container provides information about a Store logo. The GetStore call now only returns the Logo.URL value, but not Logo.LogoID or Logo.Name. GetStore Conditionally Container consisting of an array of one or more CustomCategory containers. Each CustomCategory container consists of details related to an eBay Store custom category. To modify an eBay Store's custom categories, an eBay Store owner would use the StoreCategories container in the request of a SetStoreCategories call. GetStore Always This field is deprecated. Indicates the time the store was last opened or reopened. GetStore Conditionally This type defines the Storefront container, which can be used by eBay Stores sellers to list an item under two primary custom categories either by category ID or category name. A custom category is a category that was created by a seller in their eBay store. This container is used by Add/Revise/Relist calls. The Storefront container is also returned in GetItem and other Trading calls that retrieve Item data. Note: This type is applicable only for eBay Store sellers. Unique identifier of a primary custom category in which to list the item. A custom category is a category that the seller created in their eBay Store. eBay Store sellers can create up to three levels of custom categories for their stores, but the API only supports root-level categories. To list an item using the categories in a seller's store, you must set this field to a root-level custom category or a custom category that has no child categories (subcategories). If you attempt to list an item in a category that has subcategories, the call response contains a warning, and the item is listed in the 'Other' store category. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Unique identifier for the secondary custom category in which to list the item. Set this field to a root-level custom category or a custom category that has no child categories (subcategories). The system resets the value to 0 (None) in the following cases: - The values of StoreCategoryID and StoreCategory2ID field are the same - You specify StoreCategory2ID but not StoreCategoryID In other words, StoreCategoryID must be set to a valid custom category and be different from StoreCategory2ID. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Category name of a primary custom category in which to list the item. A custom category is a category that the seller created in their eBay Store. eBay Store sellers can create up to three levels of custom categories for their stores, but the API only supports root-level categories. To list an item using a category name from a seller's store, you must set this field to a root-level custom category or a custom category that has no child categories (subcategories). If you attempt to list an item in a category that has subcategories, the call response contains a warning, and the item is listed in the store category called 'Other'. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No Name of the secondary custom category in which to list the item. Set this field to a root-level custom category or a custom category that has no child categories (subcategories). The system resets the value to 0 (None) in the following cases: - The values of StoreCategoryName and StoreCategory2Name field are the same - You specify StoreCategory2Name but not StoreCategoryName In other words StoreCategoryName must be set to a valid custom category name and be different from StoreCategory2Name. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No The URL of the seller's eBay Stores page. GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally The name of the seller's eBay Store. 200 This type is used by the SuggestedBidValues container that is returned if the buyer is attempting to bid on an auction item through the PlaceOffer call. The SuggestedBidValues container is only returned if the buyer is attempting to bid on an auction item. A BidValue field is returned for each incremental bid value (up to the dollar value specified in the Offer.MaxBid field in the request) that eBay will bid on behalf of the buyer each time that buyer is outbid for the auction item. How many BidValue fields that appear will depend on the current winning bid amount, the required bid increment, and the buyer's specified max bid amount. PlaceOffer Conditionally How often the summary is to be delivered. Deliver every Sunday. Deliver every Monday. Deliver every Tuesday. Deliver every Wednesday. Deliver every Thursday. Deliver every Friday. Deliver every Saturday. On day 1 of the month. On day 2 of the month. On day 3 of the month. On day 4 of the month. On day 5 of the month. On day 6 of the month. On day 7 of the month. On day 8 of the month. On day 9 of the month. On day 10 of the month. On day 11 of the month. On day 12 of the month. On day 13 of the month. On day 14 of the month. On day 15 of the month. On day 16 of the month. On day 17 of the month. On day 18 of the month. On day 19 of the month. On day 20 of the month. On day 21 of the month. On day 22 of the month. On day 23 of the month. On day 24 of the month. On day 25 of the month. On day 26 of the month. On day 27 of the month. On day 28 of the month. On day 29 of the month. On day 30 of the month. On day 31 of the month. Every 31 days. Every 60 days. The period of time for which to create a summary. The last 24 hours. The last 7 days. The last 31 days. The current week. The prior week. The current month. The prior month. The last 60 days. Type defining the SupportedSellerProfile container, which contains summary information related to specific Business Policies payment, return policy, and shipping profiles. The profile type is found in the ProfileType field. Unique identifier of a Business Policies profile. This identifier is auto-generated by eBay when the seller creates the profile. This field is always returned with the SupportedSellerProfile container. GetUserPreferences Conditionally SetUserPreferences No Indicates the type of the Business Policies profile. Valid values are PAYMENT, RETURN_POLICY, and SHIPPING. This field is always returned with the SupportedSellerProfile container. GetUserPreferences Conditionally SetUserPreferences No The seller-defined name for a Business Policies profile. This field is always returned with the SupportedSellerProfile container. GetUserPreferences Conditionally SetUserPreferences No Seller-provided description of a Business Policies profile. This field is only returned if a seller has provided a description for the profile. GetUserPreferences Conditionally SetUserPreferences No Identifies the the Business Policies category group associated with the Business Policies profile. Current values are ALL (referring to all non-motor vehicle categories) and MOTORS_VEHICLE (for motor vehicle listings). GetUserPreferences Conditionally SetUserPreferences No Type defining the SupportedSellerProfiles container for all payment, return, and shipping policy profiles that a seller has defined for a site. Container consisting of information related to specific Business Policies payment, return, and shipping policy profiles. The profile type is found in the ProfileType field. GetUserPreferences Conditionally SetUserPreferences No Defines the Transaction Confirmation Request feature. If the field is present, the corresponding feature applies to the category. The field is returned as an empty element (i.e., a boolean value is not returned). Status values for the processing progress for the category structure changes specified by a SetStoreCategories request. If the SetStoreCategories call is processed asynchronously, then the status is returned by GetStoreCategoryUpdateStatus, otherwise, the status is returned in the SetStoreCategories response. (out) The category changes have not started. (out) The category changes are in progress. (out) The category changes completed successfully. (out) The category changes failed. (out) Reserved for internal or future use. Enumerated type that lists the types of taxes that may be charged to the buyer for each order line item purchased. This enumeration value indicates that standard sales tax was charged to the buyer against the order line item. This enumeration value indicates that an electronic waste recycling fee was charged to the buyer against the order line item. This enumeration value indicates that a tire recycling fee was charged to the buyer against the order line item. This enumeration value indicates that a Goods and Services import tax was charged to the buyer against the order line item. Note: At this time, this tax type is only applicable to the Australia site. Reserved for internal or future use. Type used by the TaxDetails container, which consists of detailed tax information for an order line item, including the tax type and description, tax on the item cost, and tax related to shipping and handling. The information in this container supercedes/overrides the sales tax information in the ShippingDetails.SalesTax container (if returned). A separate TaxDetails container will be returned for each type of tax that applied to an order line item. For tax that is subject to 'eBay collect and remit', such as US sales tax or 'Goods and Services tax' for Australia or New Zealand, the TaxDetails container will be returned under the eBayCollectAndRemitTaxes container. For all other tax, the tax details will be returned under the Taxes container. This field indicates the tax type. A separate TaxDetails container is returned for each unique imposition (tax type). GetItemTransactions GetOrders GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This enumeration value indicates the type of tax charged against the item. GetItemTransactions GetOrders GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This value is the total amount of tax charges for the order line item for the corresponding tax type (see Imposition value), and includes taxes that are applied against the <a href="https://www.ebay.co.uk/help/buying/paying-items/buyer-protection-fee?id=5594" target="_blank">Buyer Protection fee</a>. TaxAmount = TaxOnSubtotalAmount + TaxOnShippingAmount + TaxOnHandlingAmount + the tax on the <a href="https://www.ebay.co.uk/help/buying/paying-items/buyer-protection-fee?id=5594" target="_blank">Buyer Protection fee</a> GetItemTransactions GetOrders GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This value is the amount of sales tax applied based on the unit cost of the order line item for the corresponding imposition (tax type) and includes taxes that are applied against the <a href="https://www.ebay.co.uk/help/buying/paying-items/buyer-protection-fee?id=5594" target="_blank">Buyer Protection fee</a>. GetItemTransactions GetOrders GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This value is the amount of sales tax applied based on shipping costs for the order line item for the corresponding impositiion (tax type). GetItemTransactions GetOrders GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This value is the amount of sales tax applied based on handling costs for the order line item for the corresponding impositiion (tax type). GetItemTransactions GetOrders GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This value is the actual tax ID for the buyer. This field will generally only be returned if a seller on the Italy or Spain sites required that the buyer supply a tax ID during the checkout process. If the Order.BuyerTaxIdentifier container is returned, the type of tax ID can be found in the BuyerTaxIdentifier.Type field. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This field indicates the collection method used to collect the 'eBay Collect and Remit' or 'Good and Services' tax for the order. This field is always returned for orders subject to 'Collect and Remit' or 'Good and Services' tax, and its value is always <code>NET</code>. Note: Although the CollectionMethod field is returned for all orders subject to 'Collect and Remit' sales tax or 'Good and Services' tax, the CollectionMethod field and CollectionMethodCodeType are not currently of any practical use, although this field may have use in the future. If and when the logic of this field is changed, this note will be updated and a note will also be added to the Release Notes. NET GetItemTransactions GetOrders OrderReport GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally eBayCollectAndRemitTaxes.TaxDetails NET OrderReport Conditionally eBayCollectAndRemitTaxes.TaxDetails This enumerated type contains the possible values that can be returned in the name attribute of the BuyerTaxIdentifier.Attribute field. Currently, this type only contains one enumeration value, but in the future, other attributes related to the tax ID may be created for this type. This value indicates that the value returned in the BuyerTaxIdentifier.Attribute field is the country that issued the buyer tax ID. Reserved for internal or future use. This type is used to display the value of the name attribute of the BuyerTaxIdentifier.Attribute field. The only supported value for this attribute is 'IssuingCountry', but in the future, other attributes related to the tax ID may be supported. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This type defines the BuyerTaxIdentifier container that is returned in order management calls. This container will either consist of VAT or Codice Fiscale taxpayer identification information for the buyer. This enumeration value identifies the type of tax ID that was supplied by the buyer during the checkout process. Date, Decimal, EAN, ISBN, Text, UPC GetOrders

DetailLevel: none, ReturnAll

Conditionally Date, Decimal, EAN, ISBN, Text, UPC OrderReport Conditionally Date, Decimal, EAN, ISBN, Text, UPC GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This value is the actual tax ID for the buyer. The type of tax ID is shown in the Type field. GetOrders

DetailLevel:none,ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel:none,ReturnAll

Conditionally This field shows an attribute, and its corresponding value for the buyer's tax identification card. Currently, this field is only used to indicate which country issued the buyer's tax ID, but in the future, other attributes related to the tax ID may be returned in this field. This field's value will be an <a href="http://en.wikipedia.org/wiki/ISO_3166-1" target="_blank">ISO 3166-1 two-digit code</a> that represents the issuing country. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This type is used to show sales tax-related details for a tax jurisdiction. The concept of 'sales tax' is only applicable to eBay US and Canada (English and French) sites. This is the unique, two-digit identifier of the tax jurisdiction (such as 'CA' for California). To retrieve all JurisdictionID values for a site, a seller can either use a GetTaxTable call with DetailLevel set to <code>ReturnAll</code>, or they can use the GeteBayDetails call with DetailLevel name set to <code>TaxJurisdiction</code>. The JurisdictionID field is always required in a SetTaxTable call, and always returned with each TaxJurisdiction container to identify the tax jurisdiction. SetTaxTable Yes GetBidderList GeteBayDetails Conditionally GetTaxTable GetSellerList

DetailLevel: none, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This float value is the sales tax percentage rate applicable to the corresponding tax jurisdiction. Sellers are responsible for providing accurate sales tax rates for each jurisdiction. This sales tax rate comes into play when a buyer from that tax jurisdiction makes a purchase from the seller. The value passed in is stored with a precision of 3 digits after the decimal point (##.###). This field is only returned in GetTaxTable (and other 'Get' calls) if a sales tax percentage rate has been set. Note: Buyers in all 50 US states and DC are automatically charged sales tax for eBay purchases, and eBay collects and remits this sales tax to the proper taxing authority on the buyer's behalf. Because of this, if a sales tax percentage rate is applied to a listing by a seller in one of these states, this field will be ignored during the checkout process. Currently, sales tax percentage rates can only be specified by sellers in Canada and 5 US territories, including American Samoa (AS), Guam (GU), Northern Mariana Islands (MP), Palau (PW), and Virgin Islands (VI). SetTaxTable Yes GetBidderList Conditionally GetSellerList GetTaxTable

DetailLevel: none, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This field is included in a SetTaxTable call and set to <code>true</code> if the seller wants sales tax for the jurisdiction to apply to the cumulative amount of item cost and shipping charges. This value defaults to <code>false</code> if not specified. This field is always returned with each TaxJurisdiction container (whether <code>true</code> or <code>false</code>). Note: Buyers in all 50 US states and DC are automatically charged sales tax for eBay purchases, and eBay collects and remits this sales tax to the proper taxing authority on the buyer's behalf. Because of this, if a sales tax percentage rate is applied to a listing by a seller in one of these states, this field will be ignored during the checkout process. Currently, sales tax percentage rates can only be specified by sellers in Canada and 5 US territories, including American Samoa (AS), Guam (GU), Northern Mariana Islands (MP), Palau (PW), and Virgin Islands (VI). GetBidderList Conditionally GetSellerList GetTaxTable

DetailLevel: none, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally False SetTaxTable Yes Full name for the jurisdiction or region for display purposes. GeteBayDetails Conditionally Returns the latest version number for this feature. Use the version to determine if and when to refresh your cached client data. GeteBayDetails Conditionally The time in GMT when the details for this feature were last updated. Use this timestamp to determine if and when to refresh your cached client data. GeteBayDetails Conditionally This type is used to express sales tax details for one or more tax jurisdictions. The concept of 'sales tax' is only applicable to eBay US and Canada (English and French) sites. In a SetTaxTable, a TaxJurisdiction container is required for each tax jurisdiction that the seller wishes to make additions/changes. Sales tax details for zero or more jurisdictions (states, provinces, etc). This can be just one jurisdiction, up to all jurisdictions defined for the site's country. Any values specified through a TaxJurisdiction container will override any existing values defined in the seller's Sales Tax Table. If GetTaxTable is called without the DetailLevel field, only tax jurisdictions where sales tax rates have been set up are returned. However, if the DetailLevel field is included in the request and set to <code>ReturnAll</code>, all tax jurisdictions are returned, regardless of whether or not the seller has modified settings for any/all of these jurisdictions. This container is only returned in order-related 'Get' calls if sales tax is applicable to the order line item. Note: Buyers in all 50 US states and DC are automatically charged sales tax for eBay purchases, and eBay collects and remits this sales tax to the proper taxing authority on the buyer's behalf. Because of this, if a sales tax percentage rate is applied to a listing by a seller in one of these states, this field will be ignored during the checkout process. Currently, sales tax percentage rates can only be specified by sellers in Canada and 5 US territories, including American Samoa (AS), Guam (GU), Northern Mariana Islands (MP), Palau (PW), and Virgin Islands (VI). SetTaxTable Yes GetTaxTable

DetailLevel: none, ReturnAll

Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetBidderList Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Enumerated type that lists the types of taxes that may be charged to the buyer for each order line item purchased. This enumeration value indicates that standard sales tax was charged to the buyer against the order line item. This enumeration value indicates that an electronic waste recycling fee was charged to the buyer against the order line item. This enumeration value indicates that a Goods and Services import tax was charged to the buyer against the order line item. This tax type is only applicable for items being sold by Australian or New Zealand sellers. This enumeration value indicates that French VAT tax was charged to the buyer against the order line item. This tax type is only applicable for items sold on the eBay France marketplaces. This enumeration value indicates that European VAT tax was charged to the buyer against the order line item. This enumeration applies to VAT tax on the UK marketplace, the Norway marketplace, and other EU marketplaces (except for France). Reserved for internal or future use. Type defining the Taxes container, which contains detailed tax information (sales tax and VAT) for an order line item. The information in this container supercedes/overrides the sales tax information in the ShippingDetails.SalesTax container. The value returned in this field is the VAT ID for eBay, and this value may vary based on the region or country. The eBayReference field's name attribute will show the type of VAT ID, such as <code>IOSS</code>, <code>OSS</code>, or <code>ABN</code>. This field will be returned if VAT tax is applicable for the order. See the <a href="types/eBayTaxReferenceValue.html">eBayTaxReferenceValue</a> type page for more information on the VAT tax type strings that may appear for the name attribute. Note: For all VAT ID/VATIN values to be returned (except for France), developers will need to use a Trading WSDL with a version number of 1211 (or newer). For French VAT ID/VATIN values to be returned, developers will need to use a Trading WSDL with a version number of 1225 (or newer). Otherwise, the VAT information will be returned in the Order.ShippingAddress.Street2 field. Developers will also have the option of using older version, but setting the X-EBAY-API-COMPATIBILITY-LEVEL header value to 1211 or 1225 or higher. GetItemTransactions GetOrders GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This value indicates the total tax amount for the order line item, for all tax types, which may include sales tax (seller-applied or 'eBay Collect and Remit'), 'Goods and Services' tax (for Australian or New Zealand sellers), taxes that are applied against the <a href="https://www.ebay.co.uk/help/buying/paying-items/buyer-protection-fee?id=5594" target="_blank">Buyer Protection fee</a>, or other fees like an electronic waste recycling fee. GetItemTransactions GetOrders GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Container consisting of detailed sales tax information for an order line item, including the tax type and description, sales tax on the item cost, and sales tax related to shipping and handling. GetItemTransactions GetOrders GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Data for one theme group. Returned for GetDescriptionTemplates if theme groups are requested. Unique identifier for this theme group. GetDescriptionTemplates Conditionally Name of this theme group (localized to the language associated with the eBay site). GetDescriptionTemplates Conditionally Unique identifier for each theme in this group. There is at least one theme in a theme group. GetDescriptionTemplates Conditionally The number of ThemeID elements in this group. GetDescriptionTemplates Conditionally Time zone details about a region or location to which the seller is willing to ship. A unique identifier for a given time zone. This ID does not change for a given time zone, even if the time zone supports both standard and daylight saving time variants. Valid values for TimeZoneID correspond to OLSON IDs. These IDs provide not only the information as to the offset from GMT (UTC), but also daylight saving time information. Thus, for example, America/Phoenix is distinct from America/Denver because they have different daylight saving time behavior. This value is not localized. Time values https://developer.ebay.com/api-docs/user-guides/static/make-a-call/tapi-data-types.html#time Olson ID Comparison http://en.wikipedia.org/wiki/Tz_database GeteBayDetails Conditionally Display name of a time zone in its standard (non-daylight saving) time representation. This value is localized and returned in the language for the site specified in the request (i.e., the numeric site ID that you specify in the request URL for the SOAP API or the X-EBAY-API-SITEID header for the XML API). GeteBayDetails Conditionally The offset in hours from GMT for a time zone when it is not adjusted for daylight saving time. GeteBayDetails Conditionally Display name of a time zone in its daylight saving time representation. This element is emitted for time zones that support daylight saving time only. The value is localized and returned in the language for the site specified in the request. GeteBayDetails Conditionally The offset in hours from GMT for a time zone when it is on daylight saving time. This element is emitted for time zones that support daylight saving time only. GeteBayDetails Conditionally Indicates whether or not the time zone is currently on daylight saving time. A value of true indicates that the time zone is on daylights savings time. This element is emitted for time zones that support daylight saving time only. GeteBayDetails Conditionally Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always Contains the status of the token Token is Active Token is Expired Token is revoked by eBay Token is revoked by user Token is revoked by Application Token is Invalid Reserved for internal or future use Returns token status. Current token status. GetTokenStatus Always Identifies the user to whom the token belongs. GetTokenStatus Always Original expiration time for the token. GetTokenStatus Always Token revocation time, if the token has been revoked. GetTokenStatus Always Enumerated type that consists of the Top-Rated Seller programs that exist around the world. If this enumeration value is returned, it indicates that the eBay user is in the US Top-Rated Seller program. If this enumeration value is returned, it indicates that the eBay user is in the UK Top-Rated Seller program. If this enumeration value is returned, it indicates that the eBay user is in the Germany Top-Rated Seller program. If this enumeration value is returned, it indicates that the eBay user is in the Global Top-Rated Seller program. Reserved for internal or future use. Container for Top-Rated Seller program information. A TopRatedProgram field is returned for each Top-Rated Seller program that the eBay user qualifies for. q GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally ComingSoon Enumerated type listing the possible roles an eBay user may have in regards to an eBay order. The eBay user is acting as the buyer for the order(s). In GetOrders, this value should be passed into the OrderRole field in the request to retrieve orders in which the calling eBay user is the buyer in the order. The eBay user is acting as the seller for the order(s). In GetOrders, this value should be passed into the OrderRole field in the request to retrieve orders in which the calling eBay user is the seller in the order. This value is reserved for future or internal use. Type defining the TransactionArray container, which contains an array of Transaction containers. Each Transaction container consists of detailed information on one order line item. A Transaction container is returned for each line item in the order. This container consists of detailed information on one order line item. For the AddOrder call, a Transaction container is used to identified the unpaid order line items that are being combined into one Combined Invoice order. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetItemsAwaitingFeedback Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GetMyeBayBuying DeletedFromWonList WonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally AddOrder Yes Note: Currently, the only supported value for this enumeration type is <code>eBay</code>. Half.com listings will no longer be supported in APIs. Specifies the site on which the purchase was made. eBay This value indicates the purchase occurred on an eBay marketplace site. Note: eBay Express no longer exists. The order line item was created on the eBay Express site. Note: Half.com listings will no longer be supported in APIs. The order line item was created on Half.com site. Note: Shopping.com listings are no longer supported in APIs. The order line item was created on the Shopping.com site. Note: World Of Good is no longer associated with eBay. The order line item was created on the WorldOfGood site. Reserved for future use. This type is used by the Program container, which provides details on whether the order line item has passed or failed the authenticity inspection. This container gives status on whether the order line item has passed or failed the authenticity inspection. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This container provides details about an order line item being handled by eBay fulfillment. It is only returned for paid orders being fulfilled by eBay or an eBay fulfillment partner. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This container provides details on a motor vehicle being purchased using Secure Purchase. It is only applicable and returned for motor vehicle listings on eBay Motors. For more information about using Secure Purchase to purchase a vehicle, see <a href="https://pages.ebay.com/secure-purchase/" target="_blank">Secure Purchase</a>. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Enumerated type defining the possible values that can returned in the attribute of the Payment.ReferenceID and Payment.PaymentReferenceID field. MandateReferenceNumber This value is the unique identifier of an external payment transaction. No longer applicable as the eBay Now service is no longer available to buyers and sellers. This value is reserved for future or internal use. Type defining the ReferenceID element, which is used to display the unique identifier of a payment (and payment type through the type attribute. This attribute indicates the type of payment. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Contains the order status, e.g. the buyer's online payment and whether the checkout process for the order is complete. Indicates the status of the buyer's payment for an order. If the payment was successfuly processed, a value of <code>NoPaymentFailure</code> will be returned. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates the current status of the checkout flow for the order. If the payment was successfuly processed, a value of <code>CheckoutComplete</code> will be returned. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates date and time an order's status was last updated (in GMT). Note: Please note that for a multiple line item order, if any part of the order was modified, all line items of that order may be returned in the response, and each line item of that order should have the same timestamp value in this field. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The payment method that the buyer selected to pay for the order. Note: Effective September 26, 2025, access to buyer payment details for U.S. users will be limited to select developers. All other developers will receive a value of "CustomCode" in place of buyer payment details. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. Note: Sellers no longer have to specify any electronic payment methods at listing time, but this field is still returned. The value returned in this field will generally be <code>CreditCard</code>, unless an eBay gift card was used by the buyer to pay a partial or full balance of the order. If this is the case, the value returned in this field will be <code>CCAccepted</code>. Either of these two values will be returned, but neither accurately reflects the actual payment method that the buyer used. If the order was paid for off of eBay's platform using an 'offline' payment method such as 'CashOnPickup' or 'MOCC' (money order or cashier's check), and the seller marked the order as paid, either of those values may get returned here. OrderReport Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates whether checkout is complete, incomplete, or pending for an order. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Indicates whether the buyer has selected shipping details during checkout. False indicates that the shipping service was selected by eBay for the buyer. For example, if the buyer has not yet completed the Review Your Purchase page, he has not picked a shipping service. If it is false, the application should ignore ShippingServiceCost and ShippingServiceSelected (items whose values are defaulted by eBay). GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This field indicates the type and/or status of a payment hold on the item. If there is no hold against the item, this field is returned with a value of <code>NotApplicable</code>. Note: For the GetItemTransactions and GetOrders, calls, this field is only returned to the seller of the order; this field is not returned for the buyer or third party. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Always GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Always This field gives the status of a buyer's Item Not Received (INR) Inquiry if the buyer has created an INR Inquiry through the site or through the Post-Order API. If there is no INR inquiry or return request filed against the order, this field is returned with a value of <code>NotApplicable</code>. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetItemTransactions

DetailLevel: none, ReturnAll

Always GetSellerTransactions

DetailLevel: none, ReturnAll

Always This field gives the status of a buyer's return request if the buyer has initiated a return request or has escalated an existing return request into a return case. If there is no return request filed against the order or no escalation, this field will either not be returned or be returned with a value of <code>NotApplicable</code>. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Always GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The enumeration value in this field indicates which payment method was used by the German buyer who was offered the 'Pay Upon Invoice' option. This field will only be returned if a German buyer was offered the 'Pay Upon Invoice' option. Otherwise, the buyer's selected payment method is returned in the PaymentMethodUsed field by the GetItemTransactions call. Note: Effective September 26, 2025, access to buyer payment details for U.S. users will be limited to select developers. All other developers will receive a value of "CustomCode" in place of buyer payment details. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This enumeration value indicates the current state of a purchased digital gift card. The normal flow is for the buyer (or other recipient of the gift card) to download the gift card from the delivered email after purchase, and then to activate the card for use. This field is only applicable and returned for digital gift card order line items. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally The current status for the order cancellation request if it exists. This field is only returned if a cancellation request has been made on an order, or if the order is currently going through the cancellation process, or if the order has already been cancelled. GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally Contains information about a sales transaction from an eBay listing. This identifier is automatically created by the eBay system once a buyer has committed to make a purchase in an auction or fixed-price listing. A fixed-priced listing (single or multiple-variation) with multiple quantity can spawn one or more sales transactions. The total amount the buyer paid for the order line item. This amount includes the sale price of each line item, shipping and handling charges, additional services, sales tax, and any Buyer Protection fees + tax against this fee for the line item in the order. If the seller allowed the buyer to change the total for an order, the buyer is able to change the total up until the time when Checkout status is Complete. Determine whether the buyer changed the amount by retrieving the order line item data and comparing the AmountPaid value to what the seller expected. If multiple order line items between the same buyer and seller have been combined into a 'Combined Invoice' order, the AmountPaid value returned for each line item in the order reflects the total amount paid for the entire order, and not for the individual order line item. In a GetItemTransactions or GetSellerTransactions call, you can determine which order line items belong to the same 'Combined Invoice' order by checking to see if the ContainingOrder.OrderID value is the same. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This value indicates the dollar amount by which the buyer has adjusted the the total cost of the sales transaction. Adjustments to sales transaction costs may include shipping and handling, buyer discounts, or added services. A positive amount indicates the amount is an extra charge being paid to the seller by the buyer. A negative value indicates this amount is a credit given to the buyer by the seller. This field is always returned, even if there was no cost adjustment to the sales transaction. Its value will just be '0.0' if there was no cost adjustment. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always This field shows the converted value of AdjustmentAmount in the currency of the site that returned the response. Refresh this value every 24 hours to pick up the current conversion rates. This field is always returned, even if there was no cost adjustment to the sales transaction. Its value will just be '0.0' if there was no cost adjustment. This value should be the same as the value in AdjustmentAmount if the eBay listing site and the site that returned the response are the same, or use the same currency. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Container consisting of user and shipping details for the order's buyer. To be returned by GetItemsAwaitingFeedback the seller must be the one making the request. For GetOrders and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this container will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, real data is only returned to the buyer or seller, and dummy/masked data will be returned to all third parties. GetItemsAwaitingFeedback Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Container consisting of shipping-related details for a sales transaction. Shipping details may include shipping rates, package dimensions, handling costs, excluded shipping locations (if specified), shipping service options, sales tax information (if applicable), and shipment tracking details (if shipped). Note: For GetOrders, a ShippingDetails container is returned at the order at line item level. GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This field shows the converted value of AmountPaid in the currency of the site that returned the response. Refresh this value every 24 hours to pick up the current conversion rates. This field is always returned for paid orders. This value should be the same as the value in AmountPaid if the eBay listing site and the site that returned the response are the same, or use the same currency. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This field shows the converted value of TransactionPrice in the currency of the site that returned the response. Refresh this value every 24 hours to pick up the current conversion rates. This field is always returned for sales transactions. This value should be the same as the value in TransactionPrice if the eBay listing site and the site that returned the response are the same, or use the same currency. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally This timestamp indicates date/time when the sales transaction occurred. A sales transaction is created when there is a commitment to buy, or when the buyer purchases the item through a 'Buy it Now' option. For auction listings, a sales transaction is created when that listing ends with a high bidder whose bid meets or exceeds the Reserve Price (if set). For a fixed-price listing or a 'Buy It Now' auction listing, a sales transaction is created once the buyer clicks the Buy button. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally This value indicates whether or not the seller requires a deposit for the purchase of a motor vehicle. This field is only applicable to motor vehicle listings that require an initial deposit. A value of 'OtherMethod' will be returned if the motor vehicle listing requires an initial deposit, or a value of 'None' if an initial deposit is not required. eBay motors offline payment methods https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-motors-payments.html#deposit GetItemTransactions GetSellerTransactions None, OtherMethod

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This container consists of relevant details about the listing associated with the sales transaction. Which listing fields are returned under this container will depend on the listing, the eBay marketplace, and the API call. In an AddOrder call, only the unique identifier of the listing (ItemID) is needed to help identify the sales transaction to combine into a 'Combined Invoice' order. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally GetItemsAwaitingFeedback GetMyeBaySelling Conditionally AddOrder Yes GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always This value indicates the quantity of the line item purchased at the same time by the same buyer from one listing. For auction listings, this value is always '1'. For fixed-price, non-variation listings, this value can be greater than 1. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Container consisting of checkout/payment status details for an order line item. Several of these fields change values during the checkout flow. For GetOrders, only a limited number of applicable fields are returned at the order line item level. The fields indicating the status of the order are actually found in the OrderArray.Order.CheckoutStatus container. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally Unique identifier for an eBay sales transaction. This identifier is created once there is a commitment from a buyer to purchase an item, or if/when the buyer actually purchases the line item through a 'Buy it Now' option. An ItemID/TransactionID pair can be used and referenced during an order checkout flow to identify a line item. The TransactionID value for auction listings is always <code>0</code> since there can be only one winning bidder/one sale for an auction listing. Note: Historically, TransactionID values have been '0' for auction listings, and some developers may have built logic around this. However, non-zero TransactionID values for auction listings started being used for some eBay marketplaces beginning in July 2024, and all eBay marketplaces are expected to start using non-zero TransactionID values for auction listings in the near future. If necessary, developers should update code to handle non-zero transaction IDs for auction transactions. For GetOrders and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer and seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, transaction ID is only returned to the buyer and seller, and a dummy value of <code>10000000000000</code> will be returned to all third parties. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally GetItemsAwaitingFeedback Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always AddOrder Yes The sale price for one unit of the line item. This price does not include any other costs like shipping/handling costs, sales tax costs, or any discounts, and its value will remain the same before and after payment. If multiple units were purchased through a single-variation, fixed-price listing, to get the subtotal of the units purchased, the TransactionPrice value would have to be multiplied by the Transaction.QuantityPurchased value. For a motor vehicle listing that required a deposit/down payment, the amount in the TransactionPrice is actually the deposit amount. For GetMyeBaySelling: this field is only returned if the transaction came as a result of a buyer's Best Offer accepted by the seller. Otherwise, the Transaction.TotalPrice field should be viewed instead. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetMyeBaySelling

DetailLevel: ReturnAll

SoldList, DeletedFromSoldList Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always Indicates whether or not the sales transaction resulted from the seller accepting a Best Offer (or Counter Offer) from a buyer. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always VAT rate for the line item. When the VATPercent is specified, the item's VAT information appears on the item's listing page. In addition, the seller can choose to print an invoice that includes the item's net price, VAT percent, VAT amount, and total price. Since VAT rates vary depending on the item and on the user's country of residence, a seller is responsible for entering the correct VAT rate; it is not calculated by eBay. To specify a VATPercent, a seller must have a VAT-ID registered with eBay and must be listing the item on a VAT-enabled site. Max precision 3 decimal places. Max length 5 characters. Note: The View Item page displays the precision to 2 decimal places with no trailing zeros. However, the full value you send in is stored. The shipping service actually selected by the buyer from the shipping services offered by the seller. The buyer typically selects the shipping service at checkout/payment time. GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally OrderReport Conditionally Display message from buyer. This field holds transient data that is only being returned in Checkout-related notifications. Subscribe to platform notifications https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/platform-notifications.html Specifies the paid status of the order. GetMyeBayBuying

DetailLevel: none, ReturnAll

WonList DeletedFromWonList Conditionally Specifies the paid status of the order. GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally Indicates the time when the buyer paid for the order and/or order was marked as 'Paid' by the seller. This field is returned once payment has been made by the buyer. This value will only be visible to the user on either side of the order. An order can be marked as 'Paid' in the following ways: <ul> <li>Automatically when a payment is made through eBay's system</li> <li>Seller marks the item as paid in My eBay or through Selling Manager Pro </li> <li>Programmatically by the seller through the CompleteSale call.</li> </ul> GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally OrderReport Conditionally GetMyeBayBuying

DetailLevel: none, ReturnAll

WonList DeletedFromWonList Conditionally GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally Indicates the time when the line item was marked as 'Shipped'. This value will only be visible to the user on either side of the order. An order can be marked as 'Shipped' by purchasing an eBay shipping label, providing shipment tracking in My eBay or through Selling Manager Pro, or programmatically by the seller through the CompleteSale call. Note: This field does not appear in the Sell Feed API's <code>LMS_ORDER_REPORT</code> responses, because once shipment tracking information is provided to the buyer, the order/order line item is considered acknowledged, and acknowledged orders do not show up in the <code>LMS_ORDER_REPORT</code> responses. GetOrders

DetailLevel: none, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally GetMyeBayBuying

DetailLevel: none, ReturnAll

WonList DeletedFromWonList Conditionally This field indicates the total price for a sales transaction. Before payment, this dollar value will be the price before a shipping service option is selected. Once a shipping service option is selected, the price in this field will be updated to reflect the shipping and handling costs associated with that shipping service option. GetMyeBayBuying

DetailLevel: none, ReturnAll

WonList DeletedFromWonList Conditionally GetMyeBaySelling

DetailLevel: none, ReturnAll

SoldList Conditionally This container consists of Feedback left by the caller for their order partner. This container is only returned if the order is complete and feedback on the order line item has been left by the caller. GetMyeBayBuying DeletedFromWonList WonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally This container consists of Feedback received by the caller from their order partner. This container is only returned if the order is complete and feedback on the order line item has been received by the caller. GetItemsAwaitingFeedback Conditionally GetMyeBayBuying DeletedFromWonList WonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally This container is returned in a GetItemTransactions or GetSellerTransactions response if the IncludeContainingOrder field is included in the call request payload and set to 'true'. This container will be returned whether the order line item is the only line item in the order, or if the order has multiple line items. Note: The new OrderLineItemCount field is automatically returned if the user is using Version 1113 of the Trading WSDL (or newer, as versions roll out). If the user is using Versions 1107 or 1111 of the Trading WSDL, the OrderLineItemCount field will only be returned if the user includes the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header and sets its value to <code>1113</code>. If a user is using a Trading WSDL older than 1107, the OrderLineItemCount field will not be returned. GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally A Final Value Fee is calculated and charged to a seller's account immediately upon creation of an order line item. Note that this fee is created before the buyer makes a payment. As long as the IncludeFinalValueFee field is included in the call request and set to 'true', the Final Value Fee for each order line item is returned, regardless of the checkout status. If a seller requests a Final Value Fee credit, the value of Transaction.FinalValueFee will not change if a credit is issued. The credit only appears in the seller's account data. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The site upon which the line item was purchased. GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions

DetailLevel: none, ReturnAll

Conditionally This value indicates the site on which the sales transaction originated. Note: Currently, the only value that should be returned in this field is <code>eBay</code>, as the Half.com marketplace no longer exists. GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always CustomCode, eBay GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally CustomCode, eBay GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally CustomCode, eBay In a fixed-priced listing, a seller can offer variations of the same item. For example, the seller could create a fixed-priced listing for a t-shirt design, and offer the shirt in different colors and sizes. In this case, each color and size combination is a separate variation. Each variation can have a different quantity and price. Due to the possible price differentiation, buyers can buy multiple items from this listing at the same time, but all of the items must be of the same variation. One order line item is created whether one or multiple quanity of the same variation are purchased. The Variation node contains information about which variation was purchased. Therefore, applications that process orders should always check to see if this node is present. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This field is returned if a buyer left a comment for the seller during the left by buyer during the checkout flow. For GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, real data is only returned to the buyer or seller, and a string value of <code>Unavailable</code> will be returned to all third parties. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The sale price of the order line item. This amount does not take into account shipping and handling charges, sales tax, or any other costs related to the order line item. If multiple units were purchased through a non- variation, fixed-price listing, this value will reflect that. So, if the base cost of the order line item was $15.00, and a quantity of two were purchased (Transaction.QuantityPurchased) the value in this field would show as <code>30.00</code>. To see the full price of the order line item, including any shipping and handling charges, and any sales tax, the (Transaction.TotalPrice) field value should be viewed instead. However, note that the TotalPrice field value is only updated after a shipping service option is selected and payment is made. And if the seller is offering free shipping, the values in the TotalTransactionPrice and the TotalPrice fields may be the same. GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally A container consisting of detailed tax information (sales tax, Goods and Services tax, or VAT) for a sales transaction. The Taxes container is returned if the order line item is subject to any taxes on the buyer's purchase. The information in this container supercedes/overrides any sales tax information in the ShippingDetails.SalesTax container. GetItemTransactions GetOrders GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Boolean value indicating whether or not an order line item is part of a bundle purchase using Product Configurator. GetItemTransactions GetSellerTransactions GetOrders

DetailLevel: none, ReturnAll

OrderReport Conditionally The shipping cost paid by the buyer for the order line item. This field is only returned after checkout is complete. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally The handling cost that the seller has charged for the order line item. This field is only returned after checkout is complete. The value of this field is returned as zero dollars (0.0) if the seller did not specify a handling cost for the listing. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally A unique identifier for an eBay order line item. This identifier is created as soon as there is a commitment to buy from the seller, or the buyer actually purchases the item using a 'Buy it Now' option. For GetOrders and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, order line item ID is only returned to the buyer or seller, and a dummy value of <code>10000000000000</code> will be returned to all third parties. GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Always GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always GetItemsAwaitingFeedback Conditionally GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always The generated eBay payment ID used by the buyer when he/she chooses electronic transfer as payment method for paying the seller. This field is only applicable to the eBay Germany site (Site ID 77). GetSellerTransactions

DetailLevel: none

Conditionally A container consisting of name and ID of the seller's discount campaign, as well as the discount amount that is being applied to the order line item. This container is only returned if the order line item is eligible for seller discounts. GetItemTransactions GetOrders GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This field is returned if the IncludeCodiceFiscale flag is included in the request and set to <code>true</code>, and if the buyer has provided this value at checkout time. This field is only applicable to buyers on the Italy and Spain sites. The Codice Fiscale number is unique for each Italian and Spanish citizen and is used for tax purposes. GetSellerTransactions Conditionally Order line items requiring multiple shipping legs include items being shipped through the Global Shipping Program or through eBay International Shipping, as well as order line items subject to/eligible for the Authenticity Guarantee program. For both international shipping options, the address of the shipping logistics provider is shown in the MultiLegShippingDetails.SellerShipmentToLogisticsProvider.ShipToAddress container. Similarly, for Authenticity Guarantee orders, the authentication partner's shipping address is shown in the same container. If an order line item is subject to the Authenticity Guarantee service, the Transaction.Program container will be returned. GetItemTransactions GetSellerTransactions GetMyeBaySelling

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This container consists of details related to the first leg of an order requiring multiple shipping legs. Types of orders that require multiple shipping legs include international orders going through the Global Shipping Program or through eBay International Shipping, as well as orders subject to/eligible for the Authenticity Guarantee program.If the item is subject to the Authenticity Guarantee service program, the seller ships the item to the authentication partner, and if the item passes an authentication inspection, the authentication partner ships it directly to the buyer. This container is only returned if the order has one or more order line items requiring multiple shipping legs. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This field indicates the date/time that an order invoice was sent from the seller to the buyer. This field is only returned if an invoice (containing the order line item) was sent to the buyer. GetOrders GetItemTransactions GetSellerTransactions

DetailLevel: ReturnAll

Conditionally OrderReport Conditionally This flag indicates whether or not the order line item is an intangible good, such as an MP3 track or a mobile phone ringtone. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always Contains information about each monetary transaction that occurs for the order line item, including order payment, any refund, a credit, etc. Both the payer and payee are shown in this container. GetItemTransactions GetSellerTransactions

DetailLevel:ReturnAll

Conditionally Container consisting of an array of PickupOptions containers. Each PickupOptions container consists of the pickup method and its priority. The priority of each pickup method controls the order (relative to other pickup methods) in which the corresponding pickup method will appear in the View Item and Checkout page. This container is always returned prior to order payment if the seller created/revised/relisted the item with the EligibleForPickupInStore and/or EligibleForPickupDropOff flag in the call request set to 'true'. If and when the In-Store pickup method (US only) or 'Click and Collect' pickup method (UK and Australia only) is selected by the buyer and payment for the order is made, this container will no longer be returned in the response, and will essentially be replaced by the PickupMethodSelected container. Note: A seller must be eligible for the In-Store Pickup feature or Click and Collect feature to list an item that is eligible for In-Store Pickup or Click and Collect. At this time, the In-Store Pickup and Click and Collect features are generally only available to large retail merchants, and can only be applied to multiple-quantity, fixed-price listings. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally This container consists of details related to the selected In-Store pickup method, including the pickup method, the merchant's store ID, the status of the In-Store pickup, and the pickup reference code (if provided by merchant). GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally This field will be returned at the order line item level only if the buyer purchased a digital gift card, which is delivered by email, or if the buyer purchased an item that is enabled with the 'Click and Collect' feature. Currently, LogisticsPlanType has two applicable values: <code>PickUpDropOff</code>, which indicates that the buyer selected the 'Click and Collect' option. With Click and Collect, buyers are able to purchase from thousands of sellers on the eBay UK and Australia sites, and then pick up their order from the nearest 'eBay Collection Point', including over 750 Argos stores in the UK. The Click and Collect feature is only available on the eBay UK and Australia sites; or, <code>DigitalDelivery</code>, which indicates that the order line item is a digital gift card that will be delivered to the buyer or recipient of the gift card by email. LogisticsPlanCodeType GetOrders

DetailLevel:none,ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel:none,ReturnAll

Conditionally This container is returned in GetOrders (and other order management calls) if the 'Pay Upon Invoice' option is being offered to the buyer, and the seller is including payment instructions in the shipping package(s) for the order. The 'Pay Upon Invoice' option is only available on the Germany site. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally The unique identifier of the inventory reservation. GetOrders

DetailLevel:none,ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel:none,ReturnAll

Conditionally A unique identifier for an eBay order. This field is only returned for paid orders, and not unpaid orders. Note: ExtendedOrderID was first created when eBay changed the format of Order IDs back in June 2019. For a short period, the OrderID field showed the old Order ID format and the ExtendedOrderID field showed the new Order ID format. For paid orders, both OrderID and ExtendedOrderID now show the same Order ID value. For GetOrders and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the correct Order ID is returned to the buyer or seller, but a dummy Order ID value of <code>1000000000000</code> will be returned to all third parties. 40 GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally If <code>true</code>, the buyer of the order line item has an eBay Plus subscription and is eligible to receive program benefits, such as fast, free domestic shipping and free returns on eligible items. eBay determines which listings qualify for eBay Plus based on whether the buyer has an active eBay Plus subscription and whether the listing meets the program's requirements. See <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-plus.html" target="_blank">eBay Plus</a> for listing requirements. Note: Currently, eBay Plus is available only to buyers in Germany and Australia. more details eBay Plus https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-plus.html GetOrders GetItemTransactions GetSellerTransactions Conditionally OrderReport Conditionally This container is returned in GetOrders and other order management calls if a buyer has purchased a digital gift card but has sent it to another individual as a gift, and has left a message for the recipient. The GiftSummary container consists of the message that the buyer wrote for the recipient of the digital gift card. A digital gift card line item is indicated if the DigitalDeliverySelected container is returned in the response, and if the digital gift card is sent to another individual as a gift, the Gift boolean field will be returned with a value of <code>true</code>. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This container is only returned by GetOrders and other order management calls if the buyer purchased a digital gift card for themselves, or is giving the digital gift card to someone else as a gift (in this case, the Gift boolean field will be returned with a value of <code>true</code>). The DigitalDeliverySelected container consists of information related to the digital gift card order line item, including the delivery method, delivery status, and recipient of the gift card (either the buyer, or another individual that is receiving the gift card as a gift from the buyer. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This boolean field is returned as <code>true</code> if the seller is giving a digital gift card to another individual as a gift. This field is only applicable for digital gift card order line items. GetOrders GetItemTransactions GetSellerTransactions Conditionally OrderReport Conditionally Note: This field is for future use, as the eBay Guaranteed Shipping feature has been put on hold. eBay Guaranteed Shipping should not be confused with eBay Guaranteed Delivery, which is a completely different feature. This field is returned as <code>true</code> if the seller chose to use eBay's Guaranteed Shipping feature at listing time. With eBay's Guaranteed Shipping, the seller will never pay more for shipping than what is charged to the buyer. eBay recommends the shipping service option for the seller to use based on the dimensions and weight of the shipping package. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally This field is deprecated, and can be ignored if returned. The Guaranteed Delivery program is no longer supported on any eBay marketplace. GetOrders

DetailLevel: none, ReturnAll

Always OrderReport Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Always This boolean field is returned as <code>true</code> if the line item is subject to a tax (US sales tax or Australian Goods and Services tax) that eBay will collect and remit to the proper taxing authority on the buyer's behalf. This field is also returned if <code>false</code> (not subject to eBay Collect and Remit). An eBayCollectAndRemitTaxes container is returned if the order line item is subject to such a tax, and the type and amount of this tax is displayed in the eBayCollectAndRemitTaxes.TaxDetails container. Australian 'Goods and Services' tax (GST) is automatically charged to buyers outside of Australia when they purchase items on the eBay Australia site. Sellers on the Australia site do not have to take any extra steps to enable the collection of GST, as this tax is collected by eBay and remitted to the Australian government. For more information about Australian GST, see the <a href="https://www.ebay.com.au/help/selling/fees-credits-invoices/taxes-import-charges?id=4121">Taxes and import charges</a> help topic. Buyers in all US states will automatically be charged sales tax for purchases, and the seller does not set this rate. eBay will collect and remit this sales tax to the proper taxing authority on the buyer's behalf. For more US state-level information on sales tax, see the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/taxes-import-charges?id=4121#section4">eBay sales tax collection</a> help topic. GetItemTransactions GetOrders OrderReport GetSellerTransactions Conditionally This container is returned if the order line item is subject to a tax (US sales tax or Australian Goods and Services tax) that eBay will collect and remit to the proper taxing authority on the buyer's behalf. The type of tax will be shown in the TaxDetails.Imposition and TaxDetails.TaxDescription fields, and the amount of this tax will be displayed in the TaxDetails.TaxAmount field. Australian 'Goods and Services' tax (GST) is automatically charged to buyers outside of Australia when they purchase items on the eBay Australia site. Sellers on the Australia site do not have to take any extra steps to enable the collection of GST, as this tax is collected by eBay and remitted to the Australian government. For more information about Australian GST, see the <a href="https://www.ebay.com.au/help/selling/fees-credits-invoices/taxes-import-charges?id=4121">Taxes and import charges</a> help topic. Buyers in all US states will automatically be charged sales tax for purchases, and the seller does not set this rate. eBay will collect and remit this sales tax to the proper taxing authority on the buyer's behalf. For more US state-level information on sales tax, see the <a href="https://www.ebay.com/help/selling/fees-credits-invoices/taxes-import-charges?id=4121#section4">eBay sales tax collection</a> help topic. GetItemTransactions GetOrders OrderReport GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally This container gives the status of an order line item going through the Authenticity Guarantee service process. In the Authenticity Guarantee service program, a third-party authenticator must verify the authenticity of the item before it can be sent to the buyer. This container is only returned for order line items subject to the Authenticity Guarantee service process, and if it is returned, the seller must make sure to send the item to the third-party authenticator's address (shown in the MultiLegShippingDetails.SellerShipmentToLogisticsProvider.ShipToAddress field), and not to the buyer's shipping address. If the item is successfully authenticated, the authenticator will ship the item to the buyer. GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Note: This array is only returned if the order has associated linked line items. Container consisting of an array of linked line item objects. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally Type defining the UPCEnabled field that is returned under the FeatureDefinitions container of the GetCategoryFeatures response (as long as 'UPCEnabled' is included as a FeatureID value in the call request or no FeatureID values are passed into the call request). This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the UPC product identifying feature. To verify if a specific eBay site supports the UPC product identifying feature (for most categories), look for a 'true' value in the SiteDefaults.UPCEnabled field. To verify if a specific category on a specific eBay site supports the UPC product identifying feature, pass in a CategoryID value in the request, and then look for a 'true' value in the UPCEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). This enumerated type defines the rate types that United Parcel Service (UPS) can offer to sellers for shipping. This enumeration value indicates that the seller is currently receiving the UPS Daily Rate for shipping items. This enumeration value indicates that the seller is currently receiving the UPS On-Demand Rate for shipping items. Reserved for internal or future use This type is used by the URLDetails containers that are returned in the response of GeteBayDetails if the <code>URLDetails</code> value is used in the DetailName field of the call request. Each URLDetails container conists of the URL of the different eBay pages, such as the View Item URL, the eBay Store URL, and others. This enumeration value indicates the type of eBay page. GeteBayDetails Conditionally A commonly used eBay URL. Applications use some of these URLs (such as the View Item URL) to launch eBay Web site pages in a browser. Logo URLs are required to be used in certain types of applications. See your API license agreement. Also see this page for logo usage rules: https://developer.ebay.com/join/licenses/apilogousage GeteBayDetails Conditionally Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. GeteBayDetails

DetailLevel: none, ReturnSummary, ReturnAll

Always This enumerated type consists of the different eBay URLs that can be returned under the URLDetails containers of a GeteBayDetails response. AppealProductUrl, CreateProductUrl, ManageProductUrl This value indicates that the URL in the corresponding URL field is the base URL for the View Item page. The user will just input the Item ID for a listing at the end of the URL to retrieve the View Item page for that listing. This value indicates that the URL in the corresponding URL field is the base URL for the eBay User page. The user will just input the user ID for an eBay user at the end of the URL to retrieve the eBay User page. This value indicates that the URL in the corresponding URL field is the URL for the My eBay home page. This value indicates that the URL in the corresponding URL field is the URL for the user's My eBay Bids/Offer page. This value indicates that the URL in the corresponding URL field is the URL to the 'Didn't Win' section on the user's My eBay Bids/Offer page. This value indicates that the URL in the corresponding URL field is the URL to the 'Bidding' section on the user's My eBay Bids/Offer page. This value indicates that the URL in the corresponding URL field is the URL to the user's My eBay Watch List page. This value indicates that the URL in the corresponding URL field is the base URL to the user's eBay Store page. The seller will just add a forward slash (/) and their eBay Store name to get to their eBay Store home page. This value indicates that the URL in the corresponding URL field is the full URL to the small version of the eBay Marketplace logo. This value indicates that the URL in the corresponding URL field is the full URL to the medium version of the eBay Marketplace logo. This value indicates that the URL in the corresponding URL field is the full URL to the large version of the eBay Marketplace logo. This value indicates that the URL in the corresponding URL field is the base URL that a seller needs to enter the UI flow to make a request that a missing product be added to the eBay Catalog. Note: Catalog change requests through the UI flow are currently not available, so this URL will not be returned in GeteBayDetails. This value indicates that the URL in the corresponding URL field is the base URL that a seller needs to enter the UI flow to make a request that an existing eBay Catalog product be revised. The seller will have to append the ePID value of the catalog product to the end of the URL. Note: Catalog change requests through the UI flow are currently not available, so this URL will not be returned in GeteBayDetails. This value indicates that the URL in the corresponding URL field is the base URL that a seller needs to enter the UI flow to get the status of a catalog change request (request for a new catalog product or request to revise an existing product). The seller will have to append the identifier of the catalog change request to the end of the URL. Note: Catalog change requests through the UI flow are currently not available, so this URL will not be returned in GeteBayDetails. Reserved for future use. This enumerated type defines the rate types that United States Postal Service (USPS) can offer to sellers for shipping. This enumeration value indicates that the seller is currently receiving the USPS Discounted Rate for shipping items. This enumeration value indicates that the seller is currently receiving the USPS Retail Rate for shipping items. Reserved for internal or future use Units of measure that you can use to specify properties such as weight and size dimensions. Kilograms Grams Pounds Ounces Centimeters Milimeters Inches Feet Reserved for internal or future use. This type provides information about the weight, volume or other quantity measurement of a listed item. The European Union requires listings for certain types of products to include the price per unit so buyers can accurately compare prices. eBay uses the UnitType and UnitQuantity values and the item's listed price to calculate and display the per-unit price on eBay EU sites. Designation of size, weight, volume or count to be used to specify the unit quantity of the item. This value can be one of the following: <pre> Kg 100g 10g L 100ml 10ml M M2 M3 Unit </pre> With GetItem, this field is returned only when you provide IncludeItemSpecifics in the request and set it to <code>true</code>. GetItem GetItems Conditionally Number of units of size, weight, volume or count of the specified unit type for the item. eBay divides the item price by this number to get the price per unit to be displayed in the item listing for comparison purposes. With GetItem, this field is returned only when you provide IncludeItemSpecifics in the request and set it to <code>true</code>. GetItem GetItems Conditionally This type defines the UnpaidItemAssistancePreferences container. This container is used in SetUserPreferences to set the preferences related to the Unpaid Item Assistant feature. The UnpaidItemAssistancePreferences container is also returned in GetUserPreferences (if the ShowUnpaidItemAssistancePreference flag is included and set to true in the request). See the <a href="https://www.ebay.com/help/selling/getting-paid/resolving-unpaid-items?id=4137">Resolving unpaid items with buyers</a> Help topic for more information about setting up and using the Unpaid Item preferences feature. This value indicates the number of days that should elapse before an unpaid order is cancelled on behalf of the seller. Valid values are: 4, 7, 11, 19, 27, and 30 (days). This field is ignored if the OptInStatus flag is included and set to <code>false</code> in the request, or if the seller is not currently opted into the Unpaid Item preferences feature on My eBay. 4 30 GetUserPreferences Conditionally SetUserPreferences No Flag to indicate whether or not the seller has enabled Unpaid Item preferences. Unpaid Item preferences must be enabled for any of the Unpaid Item preferences to have an effect. GetUserPreferences Conditionally SetUserPreferences No Flag to indicate whether or not the seller wants eBay to automatically relist items after an unpaid order is cancelled. For a multiple-quantity listing, the quantity is adjusted if AutoRelist is set to <code>true</code>. This field is ignored if the OptInStatus flag is included and set to <code>false</code> in the request, or if the seller is not currently opted into the Unpaid Item preferences feature on My eBay. GetUserPreferences Conditionally SetUserPreferences No This field should be included and set to <code>true</code> if the seller wants to clear all excluded users set in Unpaid Item preferences. A seller may want to create an excluded user list if that seller prefers to work directly with those buyers to work out the unpaid order situation. Users can be added to Exclusion list through the ExcludedUser field. The RemoveAllExcludedUsers field is ignored if the OptInStatus flag is included and set to false in the request, or if the seller is not currently opted into the Unpaid Item preferences feature in Unpaid Item preferences on My eBay. GetUserPreferences Conditionally SetUserPreferences No An eBay User ID to which the seller's Unpaid Item preferences do not apply. A seller may want to create an excluded user list if that seller prefers to work directly with those buyers to work out the unpaid order situation. Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. One or more ExcludedUser fields are used in SetUserPreferences to add users to Unpaid Item preferences Exclusion list. Any and all ExcludedUser fields are ignored if the OptInStatus flag is included and set to <code>false</code> in the request, or if the seller is not currently opted into the Unpaid Item preferences feature in Unpaid Item preferences on My eBay. In GetUserPreferences, one or more ExcludedUser fields represent the current Excluded user list. GetUserPreferences Conditionally SetUserPreferences No This type is deprecated. Contains the items, searches and 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. The user's chosen name for this list. GetMyeBayBuying Conditionally The value in this field indicates the total number of items in the user-defined list. The number of Item nodes in the ItemArray should match this value. GetMyeBayBuying Conditionally This field is not supported. The value in this field indicates the total number of favorite sellers in the user-defined list. The number of FavoriteSeller nodes returned in the response should match this value. GetMyeBayBuying Conditionally An array of Items that the user has added to the user-defined list. GetMyeBayBuying Conditionally An array of Favorite Searches that the user has added to the user-defined list. GetMyeBayBuying Conditionally An array of Favorite Sellers that the user has added to the user-defined list. GetMyeBayBuying Conditionally Contains an array of eBay UserID entries. Unique eBay user ID for the user. Applies to eBay Motors Pro applications only. Note: Effective September 26, 2025, both usernames and public user IDs will be accepted in this field. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. GetSellerList No This is a string wrapper for the eBay ID that uniquely identifies a user. This is used by several other types to identify a specific eBay user. For GetAllBidders,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, but information for all competing bidders or outside watchers will be returned as anonymized userIDs. Enumerated type this is used to indicate the type of user that initiated a monetary transaction. This enumeration value indicates that an eBay user initiated the monetary transaction. This enumeration value indicates that an eBay partner (such as Pitney Bowes) initiated the monetary transaction. This value is reserved for future use. Based on the context of the field, this type defines the user is sending or receiving a payment. This attribute indicates if the payer or payee is an eBay user or an eBay partner. GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally These codes indicate the current state or status of an eBay user account. UnconfirmedPassport, CreditCardVerifyPassport, UnconfirmedExpress, CreditCardVerifyHalfOptIn, UnconfirmedHalfOptIn This value indicates that the status of the user's eBay account is unknown. This value should seldom, if ever, be returned and typically represents a problem. This value indicates that the eBay user's account is suspended. A user with a suspended account cannot participate in buying or selling activity. This value indicates that the eBay user's account is a confirmed, active account. This value indicates that the eBay User has completed online registration, but has either not responded to confirmation email or has not yet been sent the confirmation email. Or, if this user began registration as a seller but did not complete it, the user will have this status. A seller with this status can begin to list an item but cannot complete the listing until the seller completes seller registration. This value indicates that the user originally registered on AuctionWeb (pre-eBay), but that user never re-registered on eBay. Note that there are very few (if any) eBay accounts in the 'Ghost' state. This value indicates that the eBay user's account is in maintenance mode. This value indicates that the eBay user's account has been deleted. This value indicates that the user has completed the registration and confirmation process, but needs to complete verification of credit card information. A user has this status if this user began registration as a seller but did not complete it. A seller with this status can begin to list an item but cannot complete the listing until the seller completes seller registration. This value indicates that the eBay user's account is currently on hold. A common reason for a user's account to go on hold is a non-payment of the monthly eBay invoice. A user cannot sell or buy items if their account is on hold. This value indicates that the user record has been merged with another account record for the same user This value indicates that the eBay User has completed online registration, and eBay has just sent the user a registration code in a confirmation email. The eBay user will have to respond to the confirmation email to get their account confirmed. This value indicates that the user has scheduled an account closure but eBay has yet to process the closure request. Note: The Half.com site has been shut down, so this value is no longer applicable. User has completed the registration for Half.com and opted to automatically also be registered with eBay, but the registration confirmation is still pending Note: The Half.com site has been shut down, so this value is no longer applicable. User has completed the registration for Half.com and opted to automatically also be registered with eBay, but the user needs to complete verification of credit card information. A user has this status on eBay if this user began registration as a seller but did not complete it. A seller with this status can begin to list an item but cannot complete the listing until the seller completes seller registration. This value is no longer applicable. This value is no longer applicable. This value is no longer applicable. This value indicates that the user is a guest user. The user has not added a password and has not confirmed an email address. The user has not signed up as a regular user, but has agreed to the User Agreement and Privacy Policy. The user has been through the buying flow for a guest; the user has been through checkout using the streamlined Buy-It-Now flow. Reserved for internal or future use Type to contain the data for one eBay user. Depending on the context, the user might be the seller or the buyer on either side of an order, or the bidder or winning bidder in a listing. An object of this type is returned by a number of calls, including the GetUser call. A value of <code>true</code> indicates that the user has set up an About Me page. Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetAllBidders GetBidderList Always Unique identifier for the user that does not change when the eBay user name is changed. Use when an application needs to associate a new eBay user name with the corresponding eBay user. https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/user-mgmt-anonymous-info.html Anonymous user information GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally Email address for the user. Please see the links below to the topics related to anonymous user information and static email addresses. You cannot retrieve an email address for any user with whom you do not have an order relationship, regardless of site. An email address of another user is only returned if you and the other user are in an order relationship, within a certain time of order line item creation (although this limitation isn't applicable to the GetAllBidders call in the case of motor vehicles categories.) Based on Trust and Safety policies, the time is unspecified and can vary by site. Since a bidder's user info is anonymous, this tag will be returned only to that bidder, and to the seller of an item that the user is bidding on. For the GetOrders call, the buyer's email address will be returned (to the seller only) for orders less than two weeks old, but for orders that occurred more than two weeks in the past, the buyer's email address will no longer be returned. This Email field will still be returned, but 'dummy data', such as <code>Invalid Request</code> will replace the actual email address. Note: For the GetItemTransactions call, this field is only returned to the seller of the order; this field is not returned for the buyer or third party. 64 for US. May differ for other countries. Note: The eBay database allocates up to 128 characters for this field https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/user-mgmt-anonymous-info.html Anonymous user information https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/member-communications.html Member communications GetAllBidders GetBidderList Conditionally GetBestOffers

DetailLevel: none, ReturnAll

Conditionally GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetMyeBayBuying WonList DeletedFromWonList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetSellerList Seller

DetailLevel: ReturnAll

Conditionally GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer GetSellerEvents

DetailLevel: ReturnAll

Conditionally The aggregate feedback score for a user. A user's feedback score is the net positive feedback minus the net negative feedback left for the user. Feedback scores are a quantitative expression of the desirability of dealing with a user as a buyer or a seller in either side of an order. Each order line item can result in one feedback entry for a given user (the buyer can leave feedback for the seller, and the seller can leave feedback for the buyer.). That one feedback can be positive, negative, or neutral. The aggregated feedback counts for a particular user represent that user's overall feedback score (referred to as a "feedback rating" on the eBay site). If the user has chosen to make their feedback private and that user is not the user identified in the request's authentication token, FeedbackScore is not returned and FeedbackPrivate is returned with a value of <code>true</code>. In GetMyeBayBuying and GetMyeBaySelling, feedback information (FeedbackScore and FeedbackRatingStar) is returned in BidList.ItemArray.Item.Seller. For GetMyeBayBuying, the feedback score of each seller with an item having received a bid from the buyer is returned. For GetMyeBaySelling, the feedback score of the seller is returned. GetMyeBayBuying and GetMyeBaySelling also return feedback information (FeedbackScore and FeedbackRatingStar) in BidList.ItemArray.Item.SellingStatus.HighBidder. GetMyeBayBuying returns feedback information on the high bidder of each item the buyer is bidding on. GetMyeBaySelling returns feedback information on the high bidder of each item the seller is selling. Since a bidder's user info is anonymous, the real feedback score will be returned only to that bidder, and to the seller of an item that the user is bidding on. For all other users, the value -99 is returned. For GetOrders and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the accurate Feedback Score for the user is returned to the buyer or seller, but a dummy value of <code>0</code> will be returned to all third parties. https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/user-mgmt-anonymous-info.html Anonymous user information GetAllBidders Conditionally GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetBidderList Always GetBestOffers

DetailLevel: none, ReturnAll

Always GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetSellerEvents

DetailLevel: ReturnAll

Conditionally GetMyeBayBuying GetMyeBaySelling BidList WatchList BestOfferList LostList DeletedFromLostList ActiveList

DetailLevel: none, ReturnAll

Conditionally Total count of negative Feedback entries received by the user, including weekly repeats. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Total count of positive Feedback entries received by the user, including weekly repeats. This contains the aggregate feedback score for a user. A member's feedback score is the net positive feedback minus the net negative feedback left for the member. Feedback scores are a quantitative expression of the desirability of dealing with that person as a Buyer or a Seller on either side of an order. Each order line item can result in one feedback entry for a given user (the buyer can leave feedback for the seller, and the seller can leave feedback for the buyer). Feedback can be positive, negative, or neutral. The aggregated feedback counts for a particular user represent that user's overall feedback score (referred to as a "feedback rating" on the eBay site). This rating is commonly expressed as the eBay Feedback score for the user. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Percent of total feedback that is positive. For example, if the member has 50 feedbacks, where 49 are positive and 1 is neutral or negative, the positive feedback percent could be 98.0. The value uses a max precision of 4 and a scale of 1. If the user has feedback, this value can be returned regardless of whether the member has chosen to make their feedback private. Not returned if the user has no feedback. For GetOrders and GetItemTransactions only: If using Trading WSDL Version 1019 or above, this field will only be returned to the buyer or seller, and no longer returned at all to third parties. If using a Trading WSDL older than Version 1019, the accurate Positive Feedback Percentage value for the user is returned to the buyer or seller, but a dummy value of <code>0.0</code> will be returned to all third parties. GetAllBidders

DetailLevel: ReturnAll

Conditionally GetItem Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Indicates whether the user has chosen to make their feedback score and feedback details private (hidden from other users). The percentage of positive feedback can still be returned, even if other feedback details are private. Since a bidder's user info is anonymous, this tag will be returned only to that bidder, and to the seller of an item that the user is bidding on. https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/user-mgmt-anonymous-info.html Anonymous user information GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetAllBidders GetBidderList Always GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer A visual indicator of an eBay user's Feedback score. A different colored star is used for each range of Feedback scores. See FeedbackRatingStarCodeType for specific values. Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetAllBidders GetBidderList Always GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetMyeBayBuying GetMyeBaySelling BidList WatchList BestOfferList LostList DeletedFromLostList ActiveList

DetailLevel: none, ReturnAll

Conditionally Indicates whether the user has been verified. For more information about the ID Verify program, see: <a href="https://pages.ebay.com/help/policies/identity-idverify.html">Protecting your account</a> Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetAllBidders GetBidderList Always GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always This boolean field is returned as <code>true</code> if the eBay user is in good standing with eBay. Note: This field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetAllBidders GetBidderList Always GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller This boolean is returned as <code>true</code> if the eBay user has been registered on eBay for 30 days or less. Note: The Buyer.NewUser field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetAllBidders GetBidderList Always GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions Seller

DetailLevel: none, ReturnAll

Always This container consists of the Registration address for the eBay user. GetUser: eBay returns complete RegistrationAddress details (including Phone), as applicable to the registration site for the eBay user making the call. GetItem and GetSellerTransactions: RegistrationAddress for another user (except for Phone) is only returned if you have an order relationship with that user AND that user is registered on DE/AT/CH, regardless of your registration site and the site to which you send the request. For example, the seller can see the buyer's registration address if the buyer is registered on DE/AT/CH, or the buyer can see the seller's registration address if the seller is registered on DE/AT/CH. (The buyer and seller won't see their own registration addresses in GetItem.) Note: This container and its child fields will stop being returned in GetSellerTransactions on January 31, 2024. GetUser

DetailLevel: ReturnAll

Conditionally GetItem Conditionally Seller HighBidder

DetailLevel: ReturnAll

Indicates the date the specified user originally registered with eBay. Since a bidder's user info is anonymous, this tag will be returned only to that bidder, and to the seller of an item that the user is bidding on. https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/user-mgmt-anonymous-info.html Anonymous user information GetBestOffers

DetailLevel: none, ReturnAll

Always GetAllBidders GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer eBay site the user is registered with. Since a bidder's user info is anonymous, this tag will be returned only to that bidder, and to the seller of an item that the user is bidding on. https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/user-mgmt-anonymous-info.html Anonymous user information GetAllBidders GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer Indicates the user's registration/user status. GetAllBidders GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Always GetItem HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions Seller

DetailLevel: none, ReturnAll

Always GetItemTransactions GetSellerTransactions Buyer

DetailLevel: none, ReturnAll

Conditionally Unique eBay user ID for the user. Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to <a href="https://developer.ebay.com/api-docs/static/data-handling-update.html" target="_blank">Data Handling Compliance</a>. Since a bidder's user info is anonymous, this tag contains the actual value of an ID only for that bidder, and for the seller of an item that the user is bidding on. For other users, the actual value is replaced by an anonymous value, according to these rules: When bidding on items, UserID is replaced with the value "a****b" where a and b are random characters from the UserID. For example, if the UserID = <code>IBidALot</code>, it might be displayed as, "I****A". Important: In this format, the anonymous bidder ID can change for each auction. For GetMyeBayBuying only, when bidding on items: UserID is replaced with the value "a****b" where a and b are random characters from the UserID. When bidding on items listed on the Philippines site: UserID is replaced with the value "Bidder X" where X is a number indicating the order of that user's first bid. For example, if the user was the third bidder, UserID = <code>Bidder 3</code>. Note that in this Philippines site format, the anonymous bidder ID stays the same for a given auction, but is different for different auctions. For example, a bidder who is the third and then the seventh bidder in an auction will be listed for both bids as "Bidder 3". However, if that same bidder is the first bidder on a different auction, the bidder will be listed for that auction as "Bidder 1", not "Bidder 3". For GetMyeBayBuying only, when bidding on items listed on the UK and AU sites: UserID is replaced with the string "High Bidder". For PlaceOffer, see also SellingStatus.HighBidder. https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/user-mgmt-anonymous-info.html Anonymous user information PlaceOffer Conditionally GetAllBidders GetBidderList Conditionally GetBestOffers

DetailLevel: none, ReturnAll

Conditionally GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItemsAwaitingFeedback Conditionally Buyer GetMyeBayBuying

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList SoldList BidList

DetailLevel: none, ReturnAll

Conditionally GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer GetSellerEvents

DetailLevel: ReturnAll

Conditionally If <code>true</code>, identifies a user whose ID has changed within the last 30 days. Does not indicate a new user (see NewUser). Since a bidder's user info is anonymous, this tag will be returned only to that bidder, and to the seller of an item that the user is bidding on. Note: For the GetItemTransactions call, this field is only returned to the seller of the order; this field is not returned for the buyer or third party. https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/user-mgmt-anonymous-info.html Anonymous user information GetAllBidders GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer Date and time when the user last changed their eBay user ID (in GMT). Note: The Buyer.UserIDLastChanged field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/user-mgmt-anonymous-info.html Anonymous user information GetAllBidders GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always Indicates whether or not the user is subject to VAT. Users who have registered with eBay as VAT-exempt are not subject to VAT. See documentation on Value-Added Tax (VAT). Vat-exempt sellers https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/taxes-vat.html#exempt GetAllBidders GetBidderList Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Always GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Always Seller GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer Contains information about the user as a buyer, such as the shipping address. See BuyerType for its child elements. Since a bidder's user info is anonymous, this tag will be returned only to that bidder, and to the seller of an item that the user is bidding on. https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/user-mgmt-anonymous-info.html Anonymous user information GetAllBidders Always GetSellerList HighBidder

DetailLevel: ItemReturnDescription, ReturnAll

GranularityLevel: Fine

Conditionally GetItem Conditionally HighBidder

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetItemTransactions GetSellerTransactions

DetailLevel: none, ReturnAll

Conditionally Buyer GetMyeBaySelling SoldList

DetailLevel: none, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally Buyer OrderReport Buyer Conditionally Contains information about a seller, including listing settings, listing preferences, seller rankings, and seller type. Note: This container will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetBidderList Seller Always GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally GetItem Always Seller

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList Seller

DetailLevel: none, ItemReturnDescription, ReturnAll

GranularityLevel: Coarse, Medium, Fine

Always This field indicates whether the user's account is enabled for buying and selling (indicated by FullMarketPlaceParticipant) on eBay, or if the account is a Partially Provisioned Account (indicated by Shopper) without selling and buying privileges on eBay. GetUser Always Specifies the subscription level for a user. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Indicates whether a user has read-only access to the eBay Wiki (<code>true</code>) or whether the user is able contribute or edit articles on the eBay Wiki (<code>false</code>). By default, all registered eBay users have access to contribute and edit articles on the eBay Wiki. All content contributed to the eBay Wiki is subject to the Community Content Policy. false GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Always TUV level is a number allocated to a user based on various characteristics such as buyer, seller, new buyer, new seller, high risk, or bid limit. Applies to eBay Motors Pro applications only. AU, DE, FR, IT, UK GetUser

DetailLevel: ReturnAll

Conditionally The value added tax identifier (VATID) is applicable to the VAT-enabled sites. Applies to eBay Motors Pro applications only. AU, DE, FR, IT, UK GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Contains information about the user as a bidder on a certain item. Returned by GetAllBidders if IncludeBiddingSummary = <code>true</code> is included in the request. GetAllBidders Conditionally Indicates whether or not the User container has been made anonymous. If <code>true</code>, some elements in the User container have either been removed, or had their values changed to remove identifying characteristics. If false, all expected elements are returned, and no values are changed. Since a bidder's user info is anonymous, this tag is returned as false only to the bidder, and to the seller of an item that the user is bidding on. For all other users, this tag is returned as <code>true</code>. https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/user-mgmt-anonymous-info.html Anonymous user information GetAllBidders GetSellerEvents Always GetSellerList

GranularityLevel: Fine

Always GetItem Always

DetailLevel: none, ItemReturnAttributes, ItemReturnDescription, ReturnAll

HighBidder Total count of neutral Feedback entries received by the user, including weekly repeats. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Reserved for internal or future use. GetUser

DetailLevel: none, ReturnAll

Always This flag indicates whether or not the user is eligible to sell items on eBay. This field is only returned if the IncludeFeatureEligibility flag is included in the call request and set to <code>true</code>. GetUser

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Contains the shipping address of a bidder who has made a Best Offer for an item. You cannot retrieve a shipping address for any user with whom you do not have an order relationship, regardless of site. The shipping address of another user is returned only if you and the other user are in an order relationship, within a certain time of order line item creation. Because a bidder's user information is anonymous, this container is returned only to that bidder, and to the seller of an item that the user is bidding on. GetBestOffers

DetailLevel: none, ReturnAll

Conditionally The Membership container will be returned if the seller is enrolled in one or more membership programs on one or more eBay sites. A Program container will be returned for each applicable membership program, and provides details on that program, including the eBay site, the program name (such as '<code>EBAYPLUS</code>'), and the membership expiration date. This container will not be returned at all if the seller is not enrolled in any applicable membership programs. GetUser

DetailLevel: none, ReturnAll

Conditionally The first name of the buyer or seller involved in the order. Note: The Seller.UserFirstName field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetOrders

DetailLevel: none,ReturnAll

Conditionally OrderReport Conditionally The last name of the buyer or seller involved in the order. Note: The Seller.UserLastName field will stop being returned in GetItemTransactions and GetSellerTransactions on January 31, 2024. GetOrders

DetailLevel: none,ReturnAll

Conditionally OrderReport Conditionally This type is used to set/display details related to VAT (Value-Added Tax) and Business Seller features. Note: VAT is not applicable to all countries, including the US. Sellers must be registered as Business Sellers on the site they are selling on in order to use the Business Seller-related fields. This field should be included in an Add/Revise/Relist call and set to <code>true</code> if the seller is registered on the selling site as a Business Seller. This field must be included and set to <code>true</code> if the RestrictedToBusiness field is also included and set to <code>true</code>. The RestrictedToBusiness field is used by German (Site ID 77), Austrian (Site ID 16), and Swiss (Site ID 193) sellers who wish to restrict sales of their item to other users registered as business users. This field is returned in 'Get' calls only if set on the listing, and the person making the call owns the listing. However, other Business Seller-related information will be returned to all users in 'Get' calls under the SellerInfo and BusinessSellerDetails containers. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

BusinessSellerDetails Conditionally This field must be included in an Add/Revise/Relist call and set to <code>true</code> if a German (Site ID 77), Austrian (Site ID 16), or Swiss (Site ID 193) seller wishes to restrict sales of their item to other users registered on eBay as business users. If this field is set as <code>true</code>, the BusinessSeller field must also be included and set to <code>true</code>. This feature is not available on any other eBay marketplaces. This field can be included and set to <code>true</code> only by Business Sellers registered on one of the three sites above, and only if the listing category supports Business-to-Business listings. The <a href="../../../../../api-docs/sell/metadata/resources/marketplace/methods/getCategoryPolicies#response.categoryPolicies.b2bVatEnabled" target="_blank">getCategoryPolicies</a> of the Metadata API can be used by the seller (using one of the Site IDs above) to see which categories support Business-to-Business listings. A b2bVatEnabled boolean field will be returned as <code>true</code> if a listing category supports Business-to-Business listings. This field is returned in 'Get' calls only if set on the listing, and the person making the call owns the listing. However, other Business Seller-related information will be returned to all users in 'Get' calls under the SellerInfo and BusinessSellerDetails containers. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetBidderList BusinessSellerDetails Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

BusinessSellerDetails Conditionally This container is used in an Add/Revise/Relist call to set the VAT (Value-added Tax) percentage rate that will be charged to buyers when an item is purchased from the listing. VAT is not applicable to all countries, including the US. Allowed VAT percentage rates can vary by region/country, so sellers should be aware of the rates they are legally required/allowed to charge, and they are responsible for charging the correct VAT rate. If VAT is charged on a listing, the seller can choose to print an invoice for the buyer that shows the item's net price, the VAT percentage rate, the VAT amount, and the total price. This field is returned in 'Get' calls only if the listing is subject to VAT. Note: Previously, up to three digits beyond the decimal point were allowed for this float value, but now a seller can include only one digit beyond the decimal point (e.g. 12.3) when using an Add/Revise/Relist call to set this value. An error will occur if more digits beyond the decimal point are specified. 0.0 27.0 4 4 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem Conditionally GetBidderList Item Conditionally GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Item Conditionally This string value is the Site ID value of the eBay Marketplace where the VAT is applicable and where the seller is registered as a Business Seller. The eBay sites that support VAT (and their corresponding Site IDs) can be found in the <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/taxes-vat.html" target="_blank">Value-added tax (VAT)</a> topic. GetItem Conditionally BusinessSellerDetails

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This is the unique VAT identifier associated with the Business Seller's account. This field will only be returned to Business Sellers who own the specified listing. Non-Business Sellers will not have a VAT identifier associated with their account, so this field will never be returned for those users. GetItem Conditionally BusinessSellerDetails

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Indicates whether or not the user is subject to VAT. Users who have registered with eBay as VAT-exempt are not subject to VAT. See documentation on Value-Added Tax (VAT). (out) VAT is not applicable (out) Residence in a country with VAT and user is not registered as VAT-exempt (out) Residence in a country with VAT and user is registered as VAT-exempt (out) Reserved for internal or future use If present, the site defines category settings for when the seller can provide a Vehicle Identification Number (VIN) for US, CA, and CAFR eBay Motors sites. VIN is required for cars and trucks from model year 1981 and later. (The US developed national standards for VIN values as of 1981.) If present, the site defines category settings for whether the seller can provide a Vehicle Registration Mark (VRM) for a UK eBay Motors vehicle listing. Defines the value category feature. If a field of this type is present, the corresponding feature applies to the site. The field is returned as an empty element (e.g., a boolean value is not returned). GetCategoryFeatures

DetailLevel: none, ReturnSummary, ReturnAll

Conditionally Defines the Value Pack feature (a feature pack). If the field is present, the corresponding feature applies to the category. The field is returned as an empty element (i.e., a boolean value is not returned). This enumeration type is used by the order management calls (like GetOrders), and indicates the type of tax ID used in the BuyerTaxIdentifier container.. Decimal,Numeric,Text,ISBN,UPC,EAN,Date This value is deprecated. This value is deprecated. This value is deprecated. This value is deprecated. This value is deprecated. This value is deprecated. This value is deprecated. This value indicates that the tax ID in the ID field is a Codice Fiscale ID, which is an identifier used by the Italian government to identify taxpayers in Italy. This value indicates that the tax ID in the ID field is a Spanish National Identity Number, which is one identifier used by the Spanish government to identify taxpayers in Spain. In Spanish, this ID is known as the 'Documento nacional de identidad'. The other tax identifier for Spanish residents is the NIE number, or 'Numero de Identidad de Extranjero'. This value indicates that the tax ID in the ID field is a Russian Passport number. This value indicates that the tax ID in the ID field is a Tax Registration Number, which is an identifier used by the Brazilian government to identify taxpayers in Brazil. In Portuguese, this ID is known as the 'Cadastro de Pessoas Fisicas', or 'CPF'. This value indicates that the tax ID in the ID field is a Turkish Identification Number, which is an identifier used by the Turkish government to identify taxpayers in Turkey. In Turkish, this ID is known as the 'Turkiye Cumhuriyeti Kimlik Numarasi', often abbreviated as T.C. Kimlik No. This value indicates that the tax ID in the ID field is a NIE Number, which is one identifier used by the Spanish government to identify taxpayers in Spain. 'NIE' stands for 'Numero de Identidad de Extranjero'. The other tax identifier for Spanish residents is the DNI number, or 'Documento nacional de identidad'. Spanish residents can also be identified by their Spanish VAT (Value-Added Tax) number, which is also called the 'Numero de Identificacion Fiscal' or NIF. This value indicates that the ID in the ID field is an NIF Number, which is also known as their Spanish VAT (Value-Added Tax) number. 'NIF' stands for 'Numero de Identificacion Fiscal'. Spanish residents can also be identified by their DNI ('Documento nacional de identidad') number or their NIE ('Numero de Identidad de Extranjero') number. This value indicates that the tax ID in the ID field is a Cedula number, which is an identifier used by the Chilean, Columbian, and Dominican Republic governments to identify taxpayers in those countries. This ID is sometimes referred to as a 'Cedula de Identidad'. This value indicates that the tax ID in the ID field is a NIT number, which is an identifier used by the Guatemalan government to identify taxpayers in Guatemala. In Spanish, this ID is known as the 'Numero de identificacion tributaria'. This value indicates that the identifier in the ID field is a driver's license number. This value indicates that the tax ID in the ID field is a CNPJ number, which is an identifier used by the Brazilian government to identify taxpayers in Brazil. In Portuguese, this ID is known as the 'Cadastro Nacional da Pessoa Juridica'. This value indicates that the tax ID in the ID field is a VAT Identification Number for the buyer. This value indicates that the tax ID in the ID field is a CURP number, which is one identifier used by the Mexican tax authorities (SAT) to identify taxpayers in Mexico. In Spanish, this ID is known as the 'Clave Única de Registro de Población'. This value indicates that the tax ID in the ID field is a RFC number, which is one identifier used by the Mexican tax authorities (SAT) to identify taxpayers in Mexico. In Spanish, this ID is known as the 'Registro Federal de Contribuyentes'. This value indicates that the tax ID in the ID field is a Tax Registration Number, which is an identifier used by the Chileans government to identify taxpayers in Chile. In Spanish, this ID is known as the 'Rol Único Tributario'. Reserved for future use. Type defining the VariationDetails container that is returned in GeteBayDetails if VariationDetails is included in the request as a DetailName filter, or if GeteBayDetails is called with no DetailName filters. This value indicates the maximum number of item variations that the site will allow within one multi-variation listing. GeteBayDetails Conditionally This value indicates the maximum number of variation specific sets that the site will allow per listing. Typical variation specific sets for clothing may be 'Color', 'Size', 'Long Sleeve', etc. GeteBayDetails Conditionally This value indicates the maximum number of values that the site will allow within one variation specific set. For example, if the variation specific set was 'Color', the seller could specify as many colors that are available up to this maximum value. GeteBayDetails Conditionally Returns the latest version number for this field. The version can be used to determine if and when to refresh cached client data. GeteBayDetails Always Gives the time in GMT that the feature flags for the details were last updated. This timestamp can be used to determine if and when to refresh cached client data. GeteBayDetails Always This type specifies variation-specific Extended Producer Responsibility information, specifically the EcoParticipationFee. For multiple-variation listings, this type's EcoParticipationFee is used and not the EcoParticipationFee in the ExtendedProducerResponsibility type. This type is supported by a limited number of sites and specific categories. Use the <a href="../../../../../api-docs/sell/metadata/resources/marketplace/methods/getExtendedProducerResponsibilityPolicies" target="_blank">getExtendedProducerResponsibilityPolicies</a> method of the Sell Metadata API to retrieve valid categories for a site. For GetItem calls, this container is only returned to the listing owner, if the container is available. This is the fee paid for new items to the eco-organization (for example, "eco-organisme" in France) fee for each variation in a multiple-variation listing. It is a contribution to the financing of the elimination of the item responsibly. For multiple-variation listings, this EcoParticipationFee (in the VariationExtendedProducerResponsibility container) is used and not the EcoParticipationFee in the ExtendedProducerResponsibility container. 16 0.0 AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Type used by the VariationKey container to identify one or more item variations to either add or remove from an eBay user's Watch List. The unique identifier of the fixed-price listing whose variation(s) should be added to or removed from the watch list. AddToWatchList RemoveFromWatchList Conditionally This container is used to identify one or more item variations within the multiple-variation listing. If the specified name-value pairs do not match any item variation, the call behaves as if no variations were specified. AddToWatchList RemoveFromWatchList Conditionally This type defines the VariationProductListingDetails container that is used to specify a Global Trade Item Number (GTIN), such as an EAN, an ISBN, or a UPC value, to identify a specific product variation in a multiple-variation listing. For a multiple-variation listing, the same GTIN type(s) must be used for all product variations within the same listing. For instance, if specify an ISBN value for one product variation within the listing, an ISBN value (and not an EAN or UPC value) must be specified for all product variations within the listing. This field is used if the seller wants to, or is required to identify each product variation within a multiplge-variation listing by an ISBN (International Standard Book Number) value. An ISBN is a unique identifer for books. Both 10 and 13-character ISBNs are supported. When specifying a 13-character ISBN, the value must begin with either '978' or '979'. The seller can use the GetCategoryFeatures call to see if an ISBN is supported/required for a category. Note: If the listing is being posted to a category that expects an ISBN value, but one doesn't exist for the product, the seller must provide a string indicating that the product identifier is unavailable. This text varies by marketplace. Refer to <a href="https://developer.ebay.com/api-docs/sell/static/inventory/product-identifier-text.html" target="_blank">Product Identifier Text</a> for the specific text based on the listing marketplace. AddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents Conditionally

DetailLevel: none, ReturnAll

This field is used if the seller wants to, or is required to identify each product variation within a multiple-variation listing by a UPC (Universal Product Code) value. A UPC is a commonly-used identifier for many different products. The seller can use the GetCategoryFeatures call to see if a UPC is supported/required for a category. Note: If the listing is being posted to a category that expects a UPC value, but one doesn't exist for the product, the seller must provide a string indicating that the product identifier is unavailable. This text varies by marketplace. Refer to <a href="https://developer.ebay.com/api-docs/sell/static/inventory/product-identifier-text.html" target="_blank">Product Identifier Text</a> for the specific text based on the listing marketplace. AddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents Conditionally

DetailLevel: none, ReturnAll

This field is used if the seller wants to, or is required to identify each product variation within a multiple-variation listing by an EAN (European Article Number) value. An EAN is a unique 8 or 13-digit identifier that many industries (such as book publishers) use to identify products. The seller can use the GetCategoryFeatures call to see if an EAN is supported/required for a category. Note: If the listing is being posted to a category that expects an EAN value, but one doesn't exist for the product, the seller must provide a string indicating that the product identifier is unavailable. This text varies by marketplace. Refer to <a href="https://developer.ebay.com/api-docs/sell/static/inventory/product-identifier-text.html" target="_blank">Product Identifier Text</a> for the specific text based on the listing marketplace. AddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents Conditionally

DetailLevel: none, ReturnAll

Note: DO NOT USE. Currently, sellers cannot associate an eBay catalog product with single variations within a multiple-variation listing for any eBay category. If the seller attempts to supply an eBay Product Identifier (ePID) at the variation level, a warning will get returned in the response stating that, 'Specifying a product identifier on a variant is not allowed in this category.'. The ProductReferenceID field was originally added as part of the Product-Based Shopping Experience (PBSE) mandate, and eBay was going to allow and even require ePIDs to be specified for some leaf categories. However, with the rollback of the PBSE mandate, this field is not currently applicable or supported. 38 (42 with "EPID") AddFixedPriceItem RelistFixedPriceItem ReviseFixedPriceItem VerifyAddFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This container is for future use. If it used, it will be ignored. Type defining the VariationSpecificPictureSet container, which is used to specify the URL(s) where the picture(s) of the variation specific will be hosted. If the Variations.Pictures container is used, at least one VariationSpecificPictureSet container is required. A value that is associated with VariationSpecificName. For example, suppose this set of pictures is showing blue shirts, and some of the variations include Color=Blue in their variation specifics. If VariationSpecificName is <code>Color </code>, then VariationSpecificValue would be <code>Blue</code>. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

The URL of a picture that is associated with the VariationSpecificValue. A variation specific picture set can consist of up to 12 self-hosted or eBay Picture Services (EPS) hosted pictures. eBay Picture Services and self-hosted images can never be combined into the same variation specific picture set. To specify more than one image, use multiple PictureURL fields, passing in a distinct URL in each of those fields. This field cannot have an empty/null value. The UploadSiteHostedPictures call can be used to upload pictures to EPS. Note that if pictures are externally-hosted, they must be hosted on a site that is using the 'https' protocol. The image specified in the first PictureURL field is also used as the thumbnail image for applicable variations. For example, if the picture set contains pictures of red shirts (i.e., VariationSpecificName=Color and VariationSpecificValue=Red), the first picture is used as the thumbnail image for all the red shirt variations. Note: Up to 12 pictures may be specified for one variation within a multiple-variation listing. Note: All images, whether they are hosted by EPS or self-hosted, must comply with eBay picture requirements, including the requirement that all images must be at least 500 pixels on its longest side. If the image does not satisfy the 500 pixels requirement, the listing may be blocked. For more information about other requirements and tips for adding pictures to listings, see the <a href="https://www.ebay.com/help/selling/listings/adding-pictures-listings?id=4148">Adding pictures to your listings</a> help page. You can use Item.PictureDetails to specify additional pictures. For example, the item-level pictures could include a model wearing a black shirt, as a typical example of the shirt style. Note: If a URL contains spaces, those spaces can be replaced with <code>%20</code>. For example, <code>https://example.com/my image.jpg</code> must be submitted as <code>https://example.com/my%20image.jpg</code> to replace the space in the image file name. However, a semicolon character (;) cannot be replaced with <code>%20</code>, so a semicolon cannot be a part of the URL, as an error will occur. Variation pictures cannot be added or removed from a fixed-price listing when the listing is scheduled to end within 12 hours or if the item variation has already had transactions. Note: For some large merchants, there are no limitations on when variation pictures can be added or removed from a fixed-price listing, even when the item variation has had transactions or is set to end within 12 hours. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Returns the URL of a variation-specific picture that is hosted outside of eBay. When you list, revise, or relist a variation, use VariationSpecificPictureSet.PictureURL (not ExternalPictureURL) to specify your self-hosted picture or EPS picture. Note: All images must comply to the <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/pictures.html">Picture Requirements</a>. This is returned only when the seller used a self-hosted picture for the variation. 150 https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/picture-hosting.html Picture hosting GetItem Conditionally

outputSelector: Variations

Returns the URLs of the seller's self-hosted (hosted outside of eBay) variation specific pictures and the URL for the corresponding eBay Picture Services (EPS), that was generated when the picture was uploaded. GetItem Conditionally This type is used by the Variation container, which provides full details on each item variation in a multiple-variation listing. A SKU (stock keeping unit) is a seller-defined identifier. It is only intended for the seller's use (not for buyers). A SKU value is not required, but many large sellers like to add SKU value to their listings. If defined on a listing, a SKU value can be used by sellers to reconcile their eBay inventory with your own inventory system, instead of using the VariationSpecifics identifying values. If specified, all SKU values must be unique within the Variations node. That is, no two variations within the same listing can have the same SKU. If you include the Item.InventoryTrackingMethod field in an 'FixedPriceItem' call and set its value to <code>SKU</code>, the Variation.SKU values become required for each variation.. For GetItem, GetOrders and other 'Get' calls: Only returned if the seller specified a SKU for the variation. Note: The Item.Variations container and its child fields will stop being returned in GetItemTransactions on January 31, 2024. 80 SKU identifiers https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/skus.html AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions Transaction

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally 1309 Avoid 1349 Transaction.Variation GetItemTransactions Item

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally The fixed price for this item variation. For example, a "Blue, Large" variation price could be USD 10.00, and a "Black, Medium" variation price could be USD 5.00. Each variation requires this field, and the prices can be the same for all variations, or be different for each variation. This enables sellers to provide discounts on certain variations without affecting the price of others. Required (and always returned) for listings with variations. You can revise a variation's price at any time (even if it has purchases). When you modify a variation during revise or relist, you need to include both its StartPrice and Quantity. Note: The Item.Variations container and its child fields will stop being returned in GetItemTransactions on January 31, 2024. Pricing https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/variations.html#price AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally 1309 Avoid 1349 Transaction.Variation GetItemTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Variations.Variation Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally This value indicates the quantity of the specific variation that are available for purchase. If you set Variation.Quantity to <code>0</code> when you create, revise, or relist an item listing, the variation is dropped from the listing. To prevent this, you can set <a href="https://developer.ebay.com/DevZone/XML/docs/Reference/ebay/SetUserPreferences.html#Request.OutOfStockControlPreference">SetUserPreferences.OutOfStockControlPreference</a> to <code>true</code>. For GetItem (and other related calls that retrieve the Item object), the Variation.Quantity value indicates the total quantity associated with the variation, including the quantity available and the quantity sold. To calculate the quantity available for sale, subtract SellingStatus.QuantitySold from this value. For RelistFixedPriceItem: <ul> <li>For an item variation that had an available quantity greater than <code>0</code> when the listing ended, the Quantity value of the item variation for the newly relisted item is set to the actual quantity available. For item variations, there is actually no QuantityAvailable field, but this value may be derived if you look at the corresponding item variation in a GetMyeBaySelling) response and subtract the Variation.QuantitySold value from the Variation.Quantity value, which represents the original Variation.Quantity value at creation time of the previous listing. </li> <li>For item variations with an available quantity of <code>0</code> when the listing ended, the relisted item will retain the Variaton.Quantity value that was passed in at creation time of the previous listing. </li> </ul> So, if you are relisting an item that had one or more item variations with an available quantity of <code>0</code> when the listing ended, we strongly recommend that you pass in the correct available quantity through the corresponding Variation.Quantity field of a relist call. Alternatively, you can update the correct quantity available by using a ReviseInventoryStatus call and passing in a Quantity value, while also making sure to pass in the correct SKU value(s) to identify the correct item variation. A ReviseInventoryStatus call can be used to revise the quantity of up to four single item listings and/or item variations (from the same or different listings). For ReviseFixedPriceItem: You can revise a variation's quantity at any time, even if it has purchases. However, unless you set the <a href="https://developer.ebay.com/DevZone/XML/docs/Reference/ebay/SetUserPreferences.html#Request.OutOfStockControlPreference">OutOfStockControlPreference</a> boolean field of the SetUserPreferences call to <code>true</code>, at least one variation must remain with a non-zero quantity in order for the listing to remain active. If you set the OutOfStockControlPreference field to <code>true</code>, a multiple-variation listing will remain active but hidden from search even if the quantity of all variations in the listing is set to <code>0</code>. When you modify a variation during revise or relist, you need to include both its StartPrice and Quantity. If you revise the Quantity value for a variation after items have already sold, specify the quantity available for sale. (eBay will automatically add the quantity sold to the value you specify.) If you set the quantity to <code>0</code> and the variation has no purchases, the variation may be dropped from the listing. For GetSellerTransactions: See Item.Quantity instead. See the <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/update-variations.html" target="_blank">Trading API User Guide</a> for more details about setting and modifying a variation's quantity. Note: The number in the Variation.Quantity field represents the current quantity of the item variation that is available using the "Ship to home" fulfillment method. This number does not take into account any quantity of the item variation that is available through "local" fulfillment methods such as In-Store Pickup or Click and Collect. This is due to the fact that there is no current implementation (or API field) where the seller informs eBay about the quantity of item variations available through each local fulfillment method. In the case where a listing is only offering the item variations through a local fulfillment method, this value should default to <code>0</code>, and the Item.IgnoreQuantity will also be returned as <code>True</code>. Note: The Item.Variations container and its child fields will stop being returned in GetItemTransactions on January 31, 2024. Set and adjust a variation's quantity https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/variations.html#qty Out-of-Stock control https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/out-of-stock.html AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Yes GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally 1309 Avoid 1349 Transaction.Variation GetItemTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Variations.Variation Conditionally A list of name/value pairs that uniquely identify the variation within the listing. All variations must specify the same set of Item Specific names, but each variation must provide a unique combination of values for those Item Specific names. For example, if the items vary by color and size, then every variation must specify 'Color' and 'Size' as Item Specific names, but no two variations can specify the same combination of 'Color' and 'Size' values. When you revise a listing that includes variations, you can change names of Variationpecifics by using the Variations.ModifyNameList container. You can also add, delete, or replace individual variations as needed to match your current inventory. Use the Variation.Delete field to delete a variation that has no sales (order line items). If the variation has sales, then set the Quantity to 0. For GetSellerEvents To keep the GetSellerEvents response smaller, Variationpecifics are not returned if the variation has a SKU. If the variation has no SKU, then Variationpecifics are returned instead. Optionally, you can pass IncludeVariationSpecifics as <code>true</code> in the request to force Variationpecifics to be returned, even when the SKU is returned. Note: The Item.Variations container and its child fields will stop being returned in GetItemTransactions on January 31, 2024. 2 5 Configure variation-selection widgets for buyers (View Item) https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/variations.html#widgets Revise and relist with variations https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/update-variations.html AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions Transaction.Variation

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally 1309 Avoid 1349 Transaction.Variation GetItemTransactions Item.Variations.Variation

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetMyeBayBuying LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally Contains the variation's quantity sold. Always returned when variations are present. Note: The Item.Variations container and its child fields will stop being returned in GetItemTransactions on January 31, 2024. GetItem Conditionally GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally 1309 Avoid 1349 Transaction.Variation GetItemTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Variations.Variation Conditionally The title of the variation. This is a concatenation of the listing title plus the values (no names) from Variationpecifics. For example, if the Title is "Polo Shirt" and the variation is for a medium pink shirt, the variation title could be "Polo Shirt[Pink,M]. Note: The Item.Variations container and its child fields will stop being returned in GetItemTransactions on January 31, 2024. 127 GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Transaction.Variation Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling

DetailLevel: none, ReturnAll

Conditionally URL for the variation on eBay. This links to eBay's View Item page, with the page configured to show details of the specified variation. The syntax of this URL is similar to Item.ViewItemURL (not optimized for natural search). GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally GetItemTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Transaction.Variation Conditionally GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport Conditionally If this field is included and set to true, the corresponding variation is deleted from the listing with a successful call. In general, a listing with variations must have at least one variation with a non-zero quantity in order to remain active. Additional deletion rules depend on whether you are revising or relisting. For ReviseFixedPriceItem only: This boolean field can now be used in a Revise call to delete a variation even if the variation still has quantity and/or has had one or more previous sales during the life of the listing. Previously, if a variation had any purchases, you could not delete the variation, but only set its quantity to zero. To replace a varation, you can delete it and add the new or corrected one. However, you can't specify the same SKU twice in the same request (because the intent would be ambiguous). So, either use a new SKU for the newer variation, or use the call twice (once to delete the variation, and once to add the new variation with the same SKU). For RelistFixedPriceItem only: You can delete any variation, as long as the relisted listing includes at least 1 variation with a non-zero quantity. (That is, when you relist, you could delete all but one variation, or you could delete all existing variations and add a new one.) ReviseFixedPriceItem RelistFixedPriceItem Conditionally false The number of watches placed on this variation by eBay users. GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally A note a user makes on an item with variations in My eBay. For eBay.com, only GetMyeBaySelling (not GetItem) returns this field, and only if you pass IncludeNotes in the request. Only visible to the user who created the note. Not supported as input in ReviseFixedPriceItem. Use SetUserNotes instead. In SoldList, notes for variations are only returned at the Item level, not the variation level. GetMyeBaySelling ActiveList ScheduledList UnsoldList

DetailLevel: none, ReturnAll

Conditionally This container provides information for a single variation (within a multiple-variation listing) that has a Strikethrough Price (STP) or a Minimum Advertised Price (MAP) discount pricing treatment. For a multiple-variation listing, the discount pricing information should be set at the variation level and not at the item level (e.g. Item.DiscountPriceInfo). STP and MAP apply only to fixed-price listings. STP is available on the US, eBay Motors, UK, Germany, Canada (English and French), France, Italy, Spain, and Ireland sites, while MAP is available only on the US site. Discount pricing is available to qualified sellers (and their associated developers) who participate in the Discount Pricing Program. Once qualified, sellers receive a 'special account flag' (SAF) that allows them to apply Discount Pricing to both single-variation and multi-variation items. STP is intended for eBay partners and their sellers only. As a seller listing Discount Price items, you are required to maintain records of your discount pricing in the event you are called upon to substantiate your item pricing. Discount pricing https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/discount-pricing.html AddFixedPriceItem AddItem RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddFixedPriceItem VerifyAddItem VerifyRelistItem No GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

This container is used to provide one or more product identifiers for a product variation within a multiple-variation, fixed-price listing. The same product identifier type(s) must be used for all product variations within the listing. For instance, if one product variation uses ISBNs, all product variations must use ISBN values. When you include the VariationProductListingDetails container in a call, you must specify at least one GTIN or ePID. If an ePID is provided, a matching eBay catalog product must exist for the value that is passed in. For ReviseItem and RelistItem only: When you revise a listing, if it ends within 12 hours, you cannot change the product identifier and you cannot remove existing product variation listing details data. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem No GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetSellerEvents Conditionally

DetailLevel: none, ReturnAll

This container defines variation-specific Extended Producer Responsibility information, specifically the EcoParticipationFee. For GetItem calls, this container is only returned to the listing owner, if the container is available. AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem AddItem ReviseItem RelistItem VerifyAddItem VerifyRelistItem No GetItem

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Conditionally Defines the multi-variation listing feature. If the field is present, the corresponding feature applies to the site. The field is returned as an empty element (e.g., a boolean value is not returned). Multi-variation listings contain items that are logically the same product, but that vary in their manufacturing details or packaging. For example, a particular brand and style of shirt could be available in different sizes and colors, such as "large blue" and "medium black" variations. Variations are multiple similar (but not identical) items in a fixed-price listing. For example, a single listing could contain multiple items of the same brand and model that vary by color and size (like "Blue, Large" and "Black, Medium"). Each variation can have its own quantity and price. For example, a listing could include 10 "Blue, Large" variations and 20 "Black, Medium" variations. Contains data that distinguishes one item variation from another. For example, if an item varies by color and size, each Variation node specifies a combination of one of those colors and sizes. When listing or relisting an item, you are allowed to create a listing with only one item variation, and you might have a plan to add more item variations to the listing in the future. However, if you don't plan to add other item variations in the future, we recommend that you avoid listing with only one variation, so that you avoid confusing buyers. If you specify multiple Variation containers in an add/revise/relist/verify add call to define multiple item variations, the Variation containers must be contiguous or an error will occur. This means that you would not want to input a Pictures or a VariationSpecificsSet container in between Variation containers in an API call. When you modify an item variation with a ReviseFixedPriceItem call, the best practice is to include all applicable fields under the Variation container, even if some of the values/settings are not being modified. The StartPrice and VariationSpecifics must be included when modifying an existing item variation, even if these values are not being changed. If a SKU value is defined for the item variation, it is strongly recommended that you include the SKU field, regardless of whether the SKU value is changing or not. If the SKU field is not included, any existing SKU value will be removed from the item variation. It is also strongly recommended that you include the Quantity field and input an accurate value, because if the Quantity field is omitted in the API call, the quantity for the item variation is set to <code>0</code>. Note: The Item.Variations container and its child fields will stop being returned in GetItemTransactions on January 31, 2024. Multiple-variation listings https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/variations.html AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem Conditionally 1 120 GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

GetSellerList

DetailLevel: ItemReturnDescription, ReturnAll

Conditionally GetMyeBayBuying LostList WatchList WonList DeletedFromWonList DeletedFromLostList

DetailLevel: none, ReturnAll

Conditionally GetMyeBaySelling ActiveList ScheduledList SoldList UnsoldList

DetailLevel: none, ReturnAll

Conditionally GetSellerEvents

DetailLevel: none, ReturnAll

Conditionally 1309 Avoid 1349 Transactions.Variation GetItemTransactions Item

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally Contains a set of pictures that correspond to one of the variation specifics, such as Color. For example, if a listing has blue and black color variations, you could choose Color for all the pictures, and then include a set of pictures for the blue variations and another set of pictures for the black variations. We strongly recommend that you also include shared pictures in Item.PictureDetails, as this results in a better experience for buyers. For ReviseFixedPriceItem only: To replace or delete individual pictures, pass in the entire Pictures node with the complete set of variation pictures that you want in the listing. If the applicable variations have purchases or the listing ends in less than 12 hours, you can add pictures, but you can't remove existing pictures. Variation, Pictures, or ModifyNameList (or all) need to be specified when the Variations node is specified in listing requests Note: Only one Pictures node is allowed for a listing. However, the node has been defined as unbounded (repeatable) in the schema to allow for different use cases for some calls or sites in the future. 1 Include pictures for variations https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/variations.html#pix AddFixedPriceItem ReviseFixedPriceItem RelistFixedPriceItem VerifyAddFixedPriceItem No GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

The set of all variation specific names and values that can be applicable to the listing (at any time in its life cycle). This must include all names and values specified in the VariationSpecifics nodes. Required when Variations are specified in a new listing, and when you modify the name of a variation by using ModifyNameList. When you modify variation specific names, VariationSpecificsSet must include the new names plus the names that are not changing (but omit the old names), This set configures variation selection widgets that appear on eBay's View Item page. For example, if you specify Color and Size names in the set, eBay's View Item page displays Color and Size drop-down lists to enable a buyer to choose a variation of interest. The order in which you specify the names and values also controls the order in which the selection widgets appear on the View Item page. For example, if you specify "Color", then "Size", and then "Sleeve Style" as names, the View Item page shows drop-down lists with those labels in that order. For "Size", if you specify "S", "M", and "L" as values, the View Item page shows the values in that order in the Size drop-down list. Use the <a href="https://developer.ebay.com/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory" target="_blank">getItemAspectsForCategory</a> method of the Taxonomy API to retrieve recommendations for names and values. Required when Variations are specified in a new listing (e.g., in AddFixedPriceItem). Also required when you change variation specific names or values in ReviseFixedPriceItem and RelistFixedPriceItem. Configure variation-selection widgets for buyers (View Item) https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/variations.html#widgets AddFixedPriceItem VerifyAddFixedPriceItem Conditionally ReviseFixedPriceItem RelistFixedPriceItem Conditionally GetItem Conditionally

DetailLevel: none, ItemReturnDescription, ItemReturnAttributes, ReturnAll

Modifies variation specific names when you revise or relist items. You can modify a variation specific name regardless of the quantity sold (i.e., no restrictions on whether the item has orders or order line items (transactions)). (Use VariationSpecifics to modify variation specific values.) You are not required to specify SKU, VariationSpecifics, and other variation details in the request when you are only modifying a variation specific name. Variation, Pictures, VariationSpecificsSet, or ModifyNameList (or all) need to be specified when the Variations node is specified in listing requests. Revise and relist with variations https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/update-variations.html RelistFixedPriceItem ReviseFixedPriceItem Conditionally This type is used by the Add/Revise/Relist calls to add a video to a listing. Videos can be added to listings using the <a href="https://developer.ebay.com/api-docs/commerce/media/overview.html" target="_blank">Media API</a>. See the <a href="https://developer.ebay.com/api-docs/commerce/media/overview.html" target="_blank">Media API</a> reference documentation for all of the necessary details to upload videos to eBay. The GetItem call will return the VideoDetails container if the listing contains a video, and the seller of the item is the one making the GetItem call. Unique identifier of a video. This identifier is automatically created by eBay once a seller successfully uploads a video to eBay. Videos can be added using the <a href="https://developer.ebay.com/api-docs/commerce/media/resources/video/methods/uploadVideo" target="_blank">uploadVideo</a> method of the <a href="https://developer.ebay.com/api-docs/commerce/media/overview.html" target="_blank">Media API</a>. In an Add/Revise/Relist call, passing in the ID for the video will add the video to the listing. Although a video can be added to a listing before it is in the <code>LIVE</code> state, the video won't be available for viewing in the listing until it does reach this state. The status of an uploaded video can be retrieved with the <a href="https://developer.ebay.com/api-docs/commerce/media/resources/video/methods/getVideo" target="_blank">getVideo</a> method and seen in the <a href="https://developer.ebay.com/api-docs/commerce/media/resources/video/methods/getVideo#response.status" target="_blank">status</a> field of the response. To replace a video already attached to the listing, the seller could make a Revise or Relist call and just send in a different VideoID value. As long as the VideoID value was valid, the specified video would replace the existing video in the listing. To remove a video from a listing (and not replace it) using a Revise or Relist call, the seller can include a DeletedField tag in the request and set its value to <code>Item.VideoDetails.VideoID</code>. If the call is successful, the video will be removed from the listing. Note: eBay will perform a validation check on each specified VideoID value to verify that the video belongs to, and was uploaded by the seller. The GetItem call can be used by the seller to see which video (if any) is attached to the listing. The VideoDetails container will be returned if the listing contains a video. The VideoDetails container will only be returned to the seller of the item and no one else. AddFixedPriceItem AddItem AddItems RelistFixedPriceItem RelistItem ReviseFixedPriceItem ReviseItem VerifyAddItem VerifyAddFixedPriceItem VerifyRelistItem No GetItem Conditionally This enumerated type contains a list of wireless carriers that may be providing SMS messages for a Platform Notifications subscriber. Cingular, Dobson, Alltel, Leap, Amena This value is no longer applicable, as Cingular is no longer in existence. This value indicates that T-Mobile is providing SMS messages for the Platform Notifications subscriber. This value indicates that Sprint is providing SMS messages for the Platform Notifications subscriber. This value is no longer applicable, as Nextel was purchased by Sprint. This value indicates that Verizon is providing SMS messages for the Platform Notifications subscriber. This value indicates that Cincinnati Bell is providing SMS messages for the Platform Notifications subscriber. This value is no longer applicable, as Dobson is no longer in existence. This value is no longer applicable, as Alltel is no longer in existence. This value is no longer applicable, as Leap is no longer in existence. This value indicates that US Cellular is providing SMS messages for the Platform Notifications subscriber. This value indicates that Movistar is providing SMS messages for the Platform Notifications subscriber. This value is no longer applicable, as Amena is no longer in existence. This value indicates that Vodafone is providing SMS messages for the Platform Notifications subscriber. This value indicates that AT&T is providing SMS messages for the Platform Notifications subscriber. This value is reserved for future use. Type defining the eBayMotorsProAdFormatEnabled field that is returned under the FeatureDefinitions container if <code>eBayMotorsProAdFormatEnabled</code> is used as a FeatureID value in the request, or if no FeatureID values are used in the request. This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support Classified Ad listings for eBay Motors Pro users. To verify if a specific eBay site supports Classified Ad listings for eBay Motors Pro users (for most categories), look for a <code>true</code> value in the SiteDefaults.eBayMotorsProAdFormatEnabled field. To verify if a specific category on a specific eBay site supports Classified Ad listings for eBay Motors Pro users, pass in a CategoryID value in the request, and then look for a <code>true</code> value in the eBayMotorsProAdFormatEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Type defining the eBayMotorsProAutoAcceptEnabled field that is returned under the FeatureDefinitions container if <code>eBayMotorsProAutoAcceptEnabled</code> is used as a FeatureID value in the request, or if no FeatureID values are used in the request. This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the Best Offer Auto-Accept feature for eBay Motors Classified Ad listings. Only eBay Motors Pro users are eligible to use eBay Motors Classified Ad listings. To verify if a specific eBay site supports the Best Offer Auto-Accept feature for eBay Motors Classified Ad listings (for most categories), look for a <code>true</code> value in the SiteDefaults.eBayMotorsProAutoAcceptEnabled field. To verify if a specific category on a specific eBay site supports the Best Offer Auto-Accept feature for eBay Motors Classified Ad listings, pass in a CategoryID value in the request, and then look for a <code>true</code> value in the eBayMotorsProAutoAcceptEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Type defining the eBayMotorsProAutoAcceptEnabled field that is returned under the FeatureDefinitions container if <code>eBayMotorsProAutoDeclineEnabled</code> is used as a FeatureID value in the request, or if no FeatureID values are used in the request. This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the Best Offer Auto-Decline feature for eBay Motors Classified Ad listings. Only eBay Motors Pro users are eligible to use eBay Motors Classified Ad listings. To verify if a specific eBay site supports the Best Offer Auto-Decline feature for eBay Motors Classified Ad listings (for most categories), look for a <code>true</code> value in the SiteDefaults.eBayMotorsProAutoDeclineEnabled field. To verify if a specific category on a specific eBay site supports the Best Offer Auto-Decline feature for eBay Motors Classified Ad listings, pass in a CategoryID value in the request, and then look for a <code>true</code> value in the eBayMotorsProAutoDeclineEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Type defining the eBayMotorsProBestOfferEnabled field that is returned under the FeatureDefinitions container if <code>eBayMotorsProBestOfferEnabled</code> is used as a FeatureID value in the request, or if no FeatureID values are used in the request. This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the Best Offer feature for eBay Motors Classified Ad listings. Only eBay Motors Pro users are eligible to use eBay Motors Classified Ad listings. To verify if a specific eBay site supports the Best Offer feature for eBay Motors Classified Ad listings (for most categories), look for a <code>true</code> value in the SiteDefaults.eBayMotorsProBestOfferEnabled field. To verify if a specific category on a specific eBay site supports the Best Offer feature for eBay Motors Classified Ad listings, pass in a CategoryID value in the request, and then look for a <code>true</code> value in the eBayMotorsProBestOfferEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Indicates whether the site supports the use of a company name when contacting the seller about eBay Motors Classified Ad listings. This feature is only applicable for eBay Motors Pro users. Indicates whether the site supports the use of a company address when contacting the seller about eBay Motors Classified Ad listings. This feature is only applicable for eBay Motors Pro users. Indicates whether the site supports the use of an email address when contacting the seller about eBay Motors Classified Ad listings. This feature is only applicable for eBay Motors Pro users. Indicates whether the site supports the use of a phone number when contacting the seller about eBay Motors Classified Ad listings. This feature is only applicable for eBay Motors Pro users. Type defining the eBayMotorsProCounterOfferEnabled field that is returned under the FeatureDefinitions container if <code>eBayMotorsProCounterOfferEnabled</code> is used as a FeatureID value in the request, or if no FeatureID values are used in the request. This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support counter offers to Best Offers for eBay Motors Classified Ad listings. Only eBay Motors Pro users are eligible to use eBay Motors Classified Ad listings. To verify if a specific eBay site supports counter offers to Best Offers for eBay Motors Classified Ad listings (for most categories), look for a <code>true</code> value in the SiteDefaults.eBayMotorsProCounterOfferEnabled field. To verify if a specific category on a specific eBay site supports counter offers to Best Offers for eBay Motors Classified Ad listings, pass in a CategoryID value in the request, and then look for a <code>true</code> value in the eBayMotorsProCounterOfferEnabled field of the corresponding Category node (match up the CategoryID values if more than one Category IDs were passed in the request). Type defining the eBayMotorsProPaymentMethodCheckOutEnabled field that is returned under the FeatureDefinitions container if <code>eBayMotorsProPaymentMethodCheckOutEnabled</code> is used as a FeatureID value in the request, or if no FeatureID values are used in the request. This field is returned as an empty element (a boolean value is not returned) if one or more eBay API-enabled sites support the display of accepted payment methods for eBay Motors Classified Ad listings. Only eBay Motors Pro users are eligible to use eBay Motors Classified Ad listings. Indicates which phone option the site supports for contacting the seller about Classified Ad format listings. Added for EbayMotors Pro users. This field is returned (as an empty element) if the site supports contacting the seller for a Classified Ad listings. This is for EbayMotors Pro users only. Indicates if the site supports shipping options for Classified Ad format listings. Added for EbayMotors Pro users. Indicates which address option the site supports for Classified Ad format listings. Added for EbayMotors Pro users. Contains information about a country where a specified seller is eligible to offer eBay Plus on listings for that country. eBay Plus is a premium account option for buyers, which provides benefits such as fast free domestic shipping and free returns on selected items. eBay determines which listings qualify for eBay Plus based on whether the buyer has an active eBay Plus subscription and whether the listing meets the program's requirements. See <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-plus.html" target="_blank">eBay Plus</a> for listing requirements. Note: Currently, eBay Plus is available only to buyers in Germany and Australia. In Australia, the seller has no control/responsibility over setting the eBay Plus feature for a listing. Instead, eBay will evaluate/determine whether a listing is eligible for eBay Plus. For more details about eBay Plus, see <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-plus.html">eBay Plus</a>. An ISO 3166 standard two-letter code that identifies a country where the seller is eligible to offer eBay Plus on fixed price listings. Note: Currently, eBay Plus is available only to buyers in Germany and Australia. GetUserPreferences Conditionally Note: This boolean field is no longer in use and will be ignored. eBay determines which listings qualify for eBay Plus based on whether the buyer has an active eBay Plus subscription and whether the listing meets the program's requirements. See <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-plus.html" target="_blank">eBay Plus</a> for listing requirements. GetUserPreferences Conditionally Note: This boolean field is no longer in use and will be ignored. eBay determines which listings qualify for eBay Plus based on whether the buyer has an active eBay Plus subscription and whether the listing meets the program's requirements. See <a href="https://developer.ebay.com/api-docs/user-guides/static/trading-user-guide/ebay-plus.html" target="_blank">eBay Plus</a> for listing requirements. GetUserPreferences Conditionally This type is used to indicate the type of tax identifier that is appearing in the eBayReference field. The tax identifier type which will vary by country/region. This attribute value is returned to indicate the VAT tax type or tax number, which will vary by country/region. This string value will be one of the following: <ul> <li><code>ABN</code>: if this string is returned, the ID in the field is an eBay Australia tax number</li> <li><code>GST</code>: if this string is returned, the ID in the field is an eBay Jersey tax number</li> <li><code>IOSS</code>: if this string is returned, the ID in the field is an eBay EU or UK IOSS number, or if the country is Kazakhstan it is an eBay Kazakhstan VAT (reference value of '<code>-</code>',no VAT Number or taxNum) </li> <li><code>IRD</code>: if this string is returned, the ID in the field is an eBay New Zealand tax number</li> <li><code>OSS</code>: if this string is returned, the ID in the field is an eBay Germany VAT ID, or if the country is Kazakhstan it is an eBay Kazakhstan VAT (reference value of '<code>-</code>', no VAT Number or taxNum) </li> <li><code>SST</code>: if this string is returned, the ID in the field is an eBay Malaysia tax number, or if the country is Kazakhstan it is an eBay Kazakhstan VAT (reference value of '<code>-</code>', no VAT Number or taxNum) </li> <li><code>DDG</code>: if this string is returned, the ID in the field is an eBay Malaysia tax number, or if the country is Belarus, the ID in the field is an eBay Belarus tax number, or if the country is Kazakhstan it is an eBay Kazakhstan VAT (reference value of '<code>-</code>', no VAT Number or taxNum) </li> <li><code>VOEC</code>: if this string is returned, the ID in the field is an eBay Norway tax number</li> <li><code>VAT</code>: if this string is returned, the ID in the field is an eBay Belarus tax number</li> <li><code>VAT_ID</code>: if this string is returned, the ID in the field is an eBay France VAT ID</li> </ul> GetOrders

DetailLevel: none, ReturnAll

Conditionally OrderReport

DetailLevel: none, ReturnAll

Conditionally GetItemTransactions GetSellerTransactions

DetailLevel: none, ItemReturnDescription, ReturnAll

Conditionally