eBay Return Management APIVersion 1.1.0

getUserReturns



Note: The Return Management API is no longer recommended. Instead, current users of the Return Management API should make plans to migrate to, and use the Return operations of the Post-Order API. New users interested is programmatically managing return requests, should also make plans to integrate with the Post-Order API. The Return Management API was developed to be used by sellers who had opted in to "Hassle-free Returns". Hassle-free Returns have been replaced by a new Returns Platform, where sellers fully or partially automate the processing of return requests through Return Automation Rules. The Return Management API does not support all features and logic of the new Returns Platform, and this API will be deprecated in the near future.

This call retrieves summary information for returns in which the user is involved as a buyer or seller. This call can be used to retrieve returns created within the last 18 months.

Note: Users of this call should start using the GET /post-order/v2/return/search call of the Post-Order API instead.

Request Details

Making a getUserReturns call with no input parameters will retrieve all returns in which the user is (or was) involved as a buyer or seller in the last 30 days. In addition to this basic call, there are also numerous filtering, sorting, and pagination options for a getUserReturns call, which are described below.

Using Filters

It is possible to use any and all filter types in one call, and boolean AND logic is used when retrieving results. Each filter types is described below:

Sorting Results

The two sorting fields are sortType and sortOrderType. sortType sets the primary entity to sort against, such as return filing date or estimated amount of return. If this field is not included in the request, the sort type defaults to "FilingDate". sortOrderType controls whether results are sorted in ascending or descending order. If this field is not included in the request, the sort order defaults to "Descending".

Using Pagination

The paginationInput container is used to control how many returns are included on one page of results, and if there are multiple pages of results, the pageNumber value is used to control which page of results is retrieved.

Pagination can be very helpful for managing large result sets. The seller can then use subsequent getUserReturns calls to retrieve results page by page by incrementing the pageNumber value in the request each time.

If paginationInput values are not used, up to 200 returns may be returned on one page. The entriesPerPage value defaults to 200, and the pageNumber value defaults to 1.

Working with the Response

A returns node is returned for each return that satisfies the input criteria. The following container/fields are always returned under a returns node:

The paginationOutput container is always returned regardless of whether the caller used the paginationInput container in the request. The paginationOutput container consists of values that indicate the total number of pages and returns that match the input criteria, the number of returns per page, and the current page number being viewed.

The responseDue container is returned if the buyer or seller has a pending response due in the return. The current status of the return dictates the type or response that is due.

Related Information

See also the reference documentation for this call:



Input

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

See also Samples.

<?xml version="1.0" encoding="utf-8"?>
<getUserReturnsRequest xmlns="http://www.ebay.com/marketplace/returns/v1/services">
  <!-- Call-specific Input Fields -->
  <creationDateRangeFilter> DateRangeFilterType
    <fromDate> dateTime </fromDate>
    <toDate> dateTime </toDate>
  </creationDateRangeFilter>
  <itemFilter> ItemFilterType
    <itemId> string </itemId>
    <transactionId> string </transactionId>
  </itemFilter>
  <orderId> string </orderId>
  <otherUserFilter> UserFilterType
    <role> UserFilterRoleType </role>
    <userId> string </userId>
    <userLoginName> string </userLoginName>
  </otherUserFilter>
  <paginationInput> PaginationInput
    <entriesPerPage> int </entriesPerPage>
    <pageNumber> int </pageNumber>
  </paginationInput>
  <ReturnStatusFilter> ReturnStatusFilterType
    <ReturnStatus> ReturnStatusInputType </ReturnStatus>
    <!-- ... more ReturnStatus values allowed here ... -->
  </ReturnStatusFilter>
  <sortOrderType> ReturnSortOrderType </sortOrderType>
  <sortType> ReturnSortType </sortType>
</getUserReturnsRequest>
Argument Type Occurrence Meaning
creationDateRangeFilter DateRangeFilterType Optional Container used to restrict results to return cases created within a specified date range. The specified date range is inclusive. The maximum date range that can be specified with this filter is 90 days. Return cases with creation dates dating back more than 18 months cannot be retrieved. To retrieve return cases for a period longer than 90 days, multiple getUserReturns calls must be made using this filter and specifying different date ranges in each subsequent call.

If more than one filter type is used in one call, boolean AND logic is applied to the result set.
creationDateRangeFilter
  .fromDate
dateTime Conditional The starting date for the date range. The fromDate must be older than the toDate, and it cannot be set back more than 18 months in the past. This field is required if the dateRangeFilter container is used.
creationDateRangeFilter.toDate dateTime Optional The ending date for the date range. The toDate must be more recent than the fromDate. This field is optional. If it is omitted, all return cases created from the fromDate up to the present (system date) are returned, unless the range specified by the fromDate and the present date is greater than 90 days, in which case the toDate defaults to 90 days forward from the fromDate.
itemFilter ItemFilterType Optional Container used to retrieve all return cases related to a specific eBay listing, or to retrieve a return case related to a specific order. Boolean OR logic is used if an eBay item ID and transaction ID are both specified.

If more than one filter type is used in one call, boolean AND logic is applied to the result set.
itemFilter.itemId string Conditional The unique identifier for an eBay item listing. If specified, all return cases filed against any of this item listing's order line items are retrieved.

An itemId value is required if the itemFilter container is used. If a transactionId value is used to identify a specific eBay order line item, that transactionId value must be associated with the itemId value or an error occurs.
Max length: 19.
itemFilter.transactionId string Optional The unique identifier for an eBay order line item. If a transactionId value is specified, any return case filed against this order line item is retrieved. The transactionId value must be associated with the itemId value or an error occurs.
Max length: 19.
orderId string Optional Id of the order
otherUserFilter UserFilterType Required Container used to retrieve all return cases related to a specific eBay member, who is identified by role and either by user ID or login name or both.

If more than one filter type is used in one call, boolean AND logic is applied to the result set.
otherUserFilter.role UserFilterRoleType Conditional The role (such as buyer or seller) of the other party involved in the return case. This field is required if the otherUserFilter container is used.

Applicable values:

BUYER
This value is specified in the otherUserFilter.role field to retrieve return cases where the other user's role is buyer.
BUYERORSELLER
This value is specified in the otherUserFilter.role field to retrieve return cases where the other user's role is buyer or seller.
SELLER
This value is specified in the otherUserFilter.role field to retrieve return cases where the other user's role is seller.

otherUserFilter.userId string Conditional The eBay user ID for the other party involved in the return case. Either a userId or a userLoginName value must be specified in the otherUserFilter container.
otherUserFilter.userLoginName string Conditional The eBay user login name for the other party involved in the return case. Either a userId or a userLoginName value must be specified in the otherUserFilter container.
paginationInput PaginationInput Optional Container used to control the pagination of the result set, including the number of return cases to return per page and the page number you want to return in the output. Pagination is typically used when the result set is expected to be large. The seller can then use subsequent getUserReturns calls to retrieve results page by page by incrementing the pageNumber value in the request each time. The caller will know the total number of pages that need to be retrieved by looking at the paginationOutput.totalPages value in the response.

If the paginationInput container is not used, all return cases matching the filter criteria are retrieved and displayed on one "page" of the response.
paginationInput.entriesPerPage int Optional This integer value is used to specify the maximum number of return cases to return in a single "page" of data. This value, along with the number of return cases that match the input criteria, will determine the total pages (see paginationOutput.totalPages) in the result set. This value defaults to '200' (the maximum allowed value) if not specified.
Min: 1. Max: 200. Default: 200.
paginationInput.pageNumber int Optional This integer value is used to specify the "page" of data to return in the call response. The total number of result pages is determined by the total number of return cases (returned in paginationOutput.totalEntries) matching the request criteria divided by the number of return cases to display per page of data (specified in entriesPerPage). This value defaults to '1' if not specified. If there are multiple pages of return cases (see paginationOutput.totalPages) to view, multiple getUserReturns calls can be made to view all return cases, and the pageNumber value can be incremented by 1 in each subsequent call.
Min: 1. Max: 100. Default: 1.
ReturnStatusFilter ReturnStatusFilterType Optional Container consisting of one or more ReturnStatus filters. If one or more ReturnStatus filters are used, results are restricted to return cases in the specified states. If return status filtering is not used, return cases in all states are retrieved. The ReturnStatusFilter container uses Boolean OR logic, which means that all return cases matching the specified states are retrieved.

If more than one filter type is used in one call, boolean AND logic is applied to the result set.
ReturnStatusFilter
  .ReturnStatus
ReturnStatusInputType Conditional,
repeatable: [1..*]
To retrieve return cases in a specific state (such as open, closed, item shipped, etc.), pass in a ReturnStatusInputType value. At least one ReturnStatus field is required if the ReturnStatusFilter container is used, and multiple ReturnStatus values are allowed.

Applicable values:

CLOSED
This value is passed into the ReturnStatusFilter.ReturnStatus field of the getUserReturns request to retrieve all closed return cases. If CLOSED is used as a filter, return cases in the following states (these values are indicated in the Returns.ReturnSummary.status field) are returned:
  • CLOSED
  • CS_CLOSED
  • EXPIRED
  • YOU_CONTACTED_CS_ABOUT_CLOSED_Return
ITEM_SHIPPED
This value is passed into the ReturnStatusFilter.ReturnStatus field of the getUserReturns request to retrieve all return cases with the status of WAITING_DELIVERY. Return status values are indicated in the Returns.ReturnSummary.status field.
MY_RESPONSE_DUE
This value is passed into the ReturnStatusFilter.ReturnStatus field of the getUserReturns request to retrieve all return cases in which the seller's response is due. The two applicable return status values returned in the Returns.ReturnSummary.status field are MY_PAYMENT_DUE and MY_RESPONSE_DUE. The MY_PAYMENT_DUE value indicates that the seller is expected to issue a refund to the buyer. The MY_RESPONSE_DUE value can indicate that the seller must provide an RMA number to the buyer, or the seller must contact eBay customer support.
OTHER_PARTY_RESPONSE_DUE
This value is passed into the ReturnStatusFilter.ReturnStatus field of the getUserReturns request to retrieve all return cases in which the other party's response is due. The only applicable return status value returned in Returns.ReturnSummary.status field is OTHER_PARTY_RESPONSE_DUE.
RETURN_STARTED
This value is passed into the ReturnStatusFilter.ReturnStatus field of the getUserReturns request to retrieve all open return cases. If RETURN_STARTED is used as a filter, return cases in the following states (these values are indicated in the Returns.ReturnSummary.status field) are returned:
  • MY_PAYMENT_DUE
  • MY_RESPONSE_DUE
  • OTHER_PARTY_CONTACTED_CS_AWAITING_RESPONSE
  • OTHER_PARTY_RESPONSE_DUE
  • PAID
  • WAITING_DELIVERY
  • YOU_CONTACTED_CS_AWAITING_RESPONSE

sortOrderType ReturnSortOrderType Optional This field is used to sort return cases in the response in descending or ascending order. So, if FilingDate is the sortType being used, and sortOrderType is set to Descending, return cases are sorted in the response from the most recent filing date to the oldest filing date. Descending is the default value, so here is how the results will appear for each sortType:
  • BuyerLoginName: Results are sorted based on name from Z to A
  • EstimatedAmount: Results are sorted based on dollar amount from highest to lowest value
  • FilingDate: Results are sorted based on filing date from most recent to oldest
  • RefundDueDate: Results are sorted based on the date a refund is due to the seller from a date further in the future to a date less further in the future

Default: Descending.

Applicable values:

Ascending
This value is passed into the sortOrderType field of the getUserReturns call to display all retrieved return cases in ascending order. See the ReturnSortType documentation to get an idea about how Ascending affects the four different sort types.
Descending
This value is passed into the sortOrderType field of the getUserReturns call to display all retrieved return cases in descending order. See the ReturnSortType documentation to get an idea about how Descending affects the four different sort types. Descending is the default value and will be used if the sortOrderType field is not included in the getUserReturns request.

sortType ReturnSortType Optional This field is used to sort return cases in the response based on either return filing date, estimated refund amount, refund due date, or buyer login name. If this field is not used, return cases are sorted by filing date.
Default: FilingDate.

Applicable values:

BuyerLoginName
If this value is specified, return cases are sorted alphabetically based on the buyer's eBay login name. If sortOrder is set to Ascending, return cases are sorted in alphabetical order according to eBay login name. If sortOrder is set to Descending, return cases are sorted in reverse alphabetical order according to eBay login name. FilingDate is the default value, so return cases will be sorted by filing date if a sortOrder value is not specified in the getUserReturns request.
EstimatedAmount
If this value is specified, return cases are sorted based on the estimated amount of the case. If sortOrder is set to Descending, the highest value return cases will appear first in the results set. If sortOrder is set to Ascending, the lowest value return cases will appear first in the results set. FilingDate is the default value, so return cases will be sorted by filing date if a sortOrder value is not specified in the getUserReturns request.
FilingDate
If this value is specified, return cases are sorted based on the filing date of the case. If sortOrder is set to Descending, the most recent return cases will appear first in the results set. If sortOrder is set to Ascending, the oldest return cases will appear first in the results set. FilingDate is the default value, so return cases will be sorted by filing date if a sortOrder value is not specified in the getUserReturns request.
RefundDueDate
If this value is specified, return cases are sorted based on the refund due date. If sortOrder is set to Descending, return cases with refund due dates the furthest in the future will appear first in the results set. If sortOrder is set to Ascending, return cases with refund due dates the nearest in the future will appear first in the results set. FilingDate is the default value, so return cases will be sorted by filing date if a sortOrder value is not specified in the getUserReturns request.



Output

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

See also Samples.

<?xml version="1.0" encoding="utf-8"?>
<getUserReturnsResponse xmlns="http://www.ebay.com/marketplace/returns/v1/services">
  <!-- Call-specific Output Fields -->
  <paginationOutput> PaginationOutput
    <entriesPerPage> int </entriesPerPage>
    <pageNumber> int </pageNumber>
    <totalEntries> int </totalEntries>
    <totalPages> int </totalPages>
  </paginationOutput>
  <returns> ReturnSummaryType
    <creationDate> dateTime </creationDate>
    <lastModifiedDate> dateTime </lastModifiedDate>
    <otherParty> ReturnUserType
      <role> ReturnUserRoleType </role>
      <userId> string </userId>
    </otherParty>
    <responseDue> ReturnResponseDueType
      <party> ReturnUserType
        <role> ReturnUserRoleType </role>
        <userId> string </userId>
      </party>
      <respondByDate> dateTime </respondByDate>
    </responseDue>
    <ReturnId> ReturnIdType
      <id> string </id>
    </ReturnId>
    <returnRequest> ReturnRequestType
      <comments> string </comments>
      <returnItem> ReturnItemType
        <itemId> string </itemId>
        <returnQuantity> int </returnQuantity>
        <transactionId> string </transactionId>
      </returnItem>
      <!-- ... more returnItem nodes allowed here ... -->
      <returnReason> ReturnReasonType (EnumerationDetailType)
        <code> token </code>
      </returnReason>
    </returnRequest>
    <ReturnType> ReturnType </ReturnType>
    <status> ReturnStatusType </status>
  </returns>
  <!-- ... more returns nodes allowed here ... -->
  <!-- Standard Output Fields -->
  <ack> AckValue </ack>
  <errorMessage> ErrorMessage
    <error> ErrorData
      <category> ErrorCategory </category>
      <domain> string </domain>
      <errorId> long </errorId>
      <exceptionId> token </exceptionId>
      <message> string </message>
      <parameter name="string"> ErrorParameter (string) </parameter>
      <!-- ... more parameter nodes allowed here ... -->
      <severity> ErrorSeverity </severity>
      <subdomain> string </subdomain>
    </error>
    <!-- ... more error nodes allowed here ... -->
  </errorMessage>
  <timestamp> dateTime </timestamp>
  <version> string </version>
</getUserReturnsResponse>
Return Value Type Occurrence Meaning
Call-specific Output Fields [Jump to standard fields]
paginationOutput PaginationOutput Always Pagination container consisting of fields that indicate the total number of pages and cases that match the input criteria, the number of cases per page, and the current page number being viewed. The paginationOutput container is always returned even if pagination values are not specified in the request.
paginationOutput
  .entriesPerPage
int Always This integer value indicates the maximum number of return cases to return in a single "page" of data. This value, along with the number of return cases that match the input criteria, determines the total pages (see paginationOutput.totalPages) in the result set.
Min: 1. Max: 100. Default: 1.
paginationOutput.pageNumber int Always This integer value indicate the "page" number of the results set. The total number of result pages is determined by the total number of return cases (returned in paginationOutput.totalEntries) matching the request criteria divided by the number of return cases to display per page of data (indicated in paginationOutput.entriesPerPage). If there are multiple pages of return cases (see paginationOutput.totalPages) to view, multiple getUserReturns calls can be made to view all return cases, and the paginationInput.pageNumber value can be incremented by 1 in each subsequent call.
Min: 1. Max: 200. Default: 1.
paginationOutput.totalEntries int Always This value indicates the total number of return cases that exist based on the current input criteria. Once this value is known, the caller may want to considering tweaking the paginationInput fields in the getUserReturns request and making another call.
paginationOutput.totalPages int Always This value indicates the total number of result pages that exist based on the current input criteria, including the paginationInput fields. If totalPages is more than 1, multiple getUserReturns calls must be made to view all result pages, with the paginationInput.pageNumber value being incremented by 1 in each subsequent call.
returns ReturnSummaryType Always,
repeatable: [1..*]
Container consisting of high-level information for each return case matching the input criteria. This information includes the creation and modification dates for the return case, the reason for the return, item information, response date, and the current status of the return case.
returns.creationDate dateTime Always This date indicates the date on which the return case was created.
returns.lastModifiedDate dateTime Always This date indicates the date on which the return case was last modified.
returns.otherParty ReturnUserType Always Container that identifies the other party involved in the return case. The party is identified by eBay user ID and role (BUYER or SELLER).
returns.otherParty.role ReturnUserRoleType Always The role (such as buyer or seller) of the party involved in the return case.

Applicable values:

BUYER
This value indicates that the user's role in the return case is buyer.
EBAY
This value indicates that the user's role in the return case is eBay.
OTHER
This value is reserved for future use.
SELLER
This value indicates that the user's role in the return case is seller.
SYSTEM
This value indicates that the user's role in the return case is system.

returns.otherParty.userId string Always The eBay user ID for the party involved in the return case.
returns.responseDue ReturnResponseDueType Conditionally This container consists of the party whose response is due and the due date of that response. This container is only returned in the requests of the getUserReturns and getReturnDetail calls if a response is due from the seller or other party involved in the return case.
returns.responseDue.party ReturnUserType Conditionally Container that identifies the party whose response is due. The party is identified by eBay user ID and role (BUYER or SELLER).
returns.responseDue.party.role ReturnUserRoleType Always The role (such as buyer or seller) of the party involved in the return case.

Applicable values:

BUYER
This value indicates that the user's role in the return case is buyer.
EBAY
This value indicates that the user's role in the return case is eBay.
OTHER
This value is reserved for future use.
SELLER
This value indicates that the user's role in the return case is seller.
SYSTEM
This value indicates that the user's role in the return case is system.

returns.responseDue.party
  .userId
string Always The eBay user ID for the party involved in the return case.
returns.responseDue
  .respondByDate
dateTime Conditionally This date indicates the due date of the party's response.
returns.ReturnId ReturnIdType Always Container consisting of the unique identifier for a return case. ReturnId values are returned in the ReturnId.id field of each ReturnSummary container returned in the getUserReturns and getReturnDetail calls.
returns.ReturnId.id string Always This string value is the unique identifier for a return case, and is returned in the responses of getUserReturns and getReturnDetail. For getReturnDetail, a ReturnId is a required input field.
Max length: 38.
returns.returnRequest ReturnRequestType Always Container consisting of details on the item being returned and the return reason.
returns.returnRequest.comments string Conditionally This field contains any comments posted by the buyer upon opening the return case. For a SNAD case, the buyer might state the discrepancies between the actual item received and the item described in the listing.
returns.returnRequest
  .returnItem
ReturnItemType Always,
repeatable: [1..*]
Container consisting of the eBay item ID, the transaction ID, and quantity of the item being returned to the seller. The returnItem container is returned in the getUserReturns and getReturnDetail calls.
returns.returnRequest
  .returnItem.itemId
string Always The unique identifier for an eBay item listing.
Max length: 19.
returns.returnRequest
  .returnItem.returnQuantity
int Always This value indicates the quantity of items to be returned. This value is usually '1' unless multiple identical items were purchased by the buyer.
Min: 1.
returns.returnRequest
  .returnItem.transactionId
string Always The unique identifier for an eBay order line item.
returns.returnRequest
  .returnReason
ReturnReasonType (EnumerationDetailType) Always This value indicates the buyer's reason for returning an item. Possible values include I_DONT_WANT_IT (buyer remorse) and SNAD (item Significantly Not As Described).
returns.returnRequest
  .returnReason.code
token Always Unique identifier of the enumeration value.
returns.ReturnType ReturnType Always This field indicates what type of return it is.

Applicable values:

MONEY_BACK
The buyer is returning the item for a refund.
REPLACEMENT
The buyer is requesting a replacement item to be ship.
UNKNOWN
This enumeration is returned if client is running an older version after new enumeration types are introduced.

returns.status ReturnStatusType Always This field indicates the current status of the return case. This value will often give the seller a good idea about the next step to take in the return case.

Applicable values: See status.
Standard Output Fields  
ack AckValue Always

Applicable values:

Failure
eBay encountered a fatal error during the processing of the request, causing the request to fail. When a serious application-level error occurs, the error is returned instead of the business data.
PartialFailure
eBay successfully processed the request, but one or more non-fatal errors occurred during the processing. Inspect the message details and resolve any problems before resubmitting the request.
Success
eBay successfully processed the request and the business data is returned in the response. Note that it is possible for a response to return Success, but still not contain the expected data in the result.
Warning
The request that triggered the error was processed successfully but with one or more warnings.

errorMessage ErrorMessage Conditionally Information for an error or warning that occurred when eBay processed the request. This field is not returned if the ack value is Success.
errorMessage.error ErrorData Conditionally,
repeatable: [0..*]
Details about a single error.
errorMessage.error.category ErrorCategory Conditionally There are three categories of errors: request errors, application errors, and system errors.

Applicable values:

Application
An error occurred due to a problem with the request, with the most likely source being the application sending the request. For example, the request is missing a required data element or it contains an invalid field. The problem must be corrected before the request can be resent. Inspect the error message to find the cause of the problem. If the problem is due to an application error, modify the application and resend the request. If the error is due to invalid data, the source of the data must be corrected before you resend the resend request to eBay.
Request
An error occurred due to a problem with the request, with the most likely source being missing or invalid data in the request. The problem must be corrected before the request can be retried. Inspect the error message to find the cause of the problem. If the problem is a result of end-user data, alert the end-user to the problem and provide the means for them to correct the problem. Once the problem is resolved, resend the request to eBay.
System
Indicates that an error has occurred on the eBay system side. For example, a database or server could be down. Inspect the error message to find the cause of the problem. If the problem is on the eBay side, an application can retry the request 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.

errorMessage.error.domain string Conditionally Name of the domain in which the error occurred.
errorMessage.error.errorId long 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.
errorMessage.error.exceptionId token Conditionally Unique identifier for an exception associated with an error.
errorMessage.error.message string Conditionally A detailed description of the condition that caused the error.
errorMessage.error.parameter ErrorParameter (string) Conditionally,
repeatable: [0..*]
Various warning and error messages return one or more variables that contain contextual information about the error. This is often the field or value that triggered the error.
errorMessage.error.parameter
  [ attribute name ]
string Conditionally Various warning and error messages return one or more variables that contain contextual information about the error. This is often the field or value that triggered the error.
errorMessage.error.severity ErrorSeverity Conditionally Indicates whether the reported problem is fatal (an error) or is less- severe (a warning). Review the error message details for information on the cause.

If the request fails and the application is the source of the error (for example, a required element is missing), update the application before you retry the request. If the problem is due to incorrect user data, 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, re-send the request to eBay.

If the source of the problem is on eBay's side, you can retry the request a reasonable number of times (eBay recommends you try the request twice). If the error persists, contact Developer Technical Support. Once the problem has been resolved, you can resend the request in its original form.

If a warning occurs, warning information is returned in addition to the business data. Normally, you do not need to resend the request (as the original request was successful). However, depending on the cause of the warning, you might need to contact the end user, or eBay, to effect a long term solution to the problem.

Applicable values:

Error
eBay encountered a fatal error during the processing of the request, causing the request to fail. When eBay encounters an error, it returns error data instead of the requested business data. Inspect the error details and resolve the problem before resubmitting the request.
Warning
The request was successfully processed, but eBay encountered a non-fatal error during the processing that could affect the data returned. For example, eBay might have changed the value of an input field. In this Return, eBay returns a successful response, but it also returns a warning. For best results, requests should return without warnings. Inspect the warning details and resolve the problem before resubmitting the request.

errorMessage.error.subdomain string Conditionally Name of the subdomain in which the error occurred.
timestamp dateTime Always 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 Time Values in the eBay Web Services guide for information about this time format and converting to and from the GMT time zone.
version string Always The version of the response payload schema. Indicates the version of the schema that eBay used to process the request.



Samples

Code samples not yet added for this call's documentation.



Change History

Change Date Description
1.1.0
2014-01-14
  • returns.ReturnType (added): Indicates the return type as a refund ('Money_Back') or as a replacement item.
1.0.0
2012-04-23
  • (added) New call.