This call is used by a seller to retrieve cases in which you are involved. This call returns eBay Buyer Protection and PayPal Buyer Protection cases (opened through the Resolution Center), older disputes created through other sites, and Unpaid Item or Cancel Transaction disputes created through the AddDispute call of the Trading API.
Several filters are available for this call which can restrict results by date, case status, case type, by item, or by transaction. If more than one filter type is used in the call, boolean AND logic is applied to the result set. Boolean OR logic is used for conditions within a filter.
Call flow for retrieving details on a specific case are as follows:
Call getUserCases with or without filters. Select one case identified by the caseId container.
If the CaseType is EBP_INR or EBP_SNAD, call getEBPCaseDetail.
For all other case types, use the getDispute call in the Trading API.
Container element for case status filters. One or more caseStatus elements may be used. The caseStatusFilter field uses Boolean OR logic, which means all matching case statuses are returned. There are six possible case statuses to retrieve.
See the Field Index to learn which calls use caseStatusFilter.
Container element for case type filters. One or more caseType elements may be used. The caseTypeFilter field uses Boolean OR logic, which means all specified and matching case types are returned. There are nine possible case types to retrieve.
See the Field Index to learn which calls use caseTypeFilter.
This filter restricts results to 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. Cases with creation dates dating back more than 18 months cannot be returned. If you want to retrieve cases for a period longer than 90 days, you have to make multiple getUserCases calls using this filter and specifying different date ranges in each subsequent call.
See the Field Index to learn which calls use creationDateRangeFilter.
This filter restricts results to cases filed against a specific item listing or a specific order line item. If the itemFilter.transactionId field is specified, a maximum of one case will be returned since there can only be one case per order line item.
See the Field Index to learn which calls use itemFilter.
Sorts the results based on creation date or case status, in ascending or descending order. Results are returned based on case creation date in ascending order if this field is not included in the request.
See the Field Index to learn which calls use sortOrder.