GetUserCasesRequest ( BaseRequest )
This call is used by a seller to retrieve cases in which you are involved. This call returns eBay Buyer Protection cases (opened through the Resolution Center), and Unpaid Item or Cancel Transaction disputes.
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.
Call that uses GetUserCasesRequest:
caseStatusFilter ( CaseStatusFilterType ) [0..1]
Container element for case status filters. One or more caseStatus elements may be used. The caseStatusFilter field uses Boolean OR logic, which means all specified and matching case statuses are returned. There are six possible case statuses to retrieve.
See the Field Index to learn which calls use caseStatusFilter.
caseTypeFilter ( CaseTypeFilterType ) [0..1]
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.
creationDateRangeFilter ( DateRangeFilterType ) [0..1]
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 return 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.
itemFilter ( ItemFilterType ) [0..1]
This filter restricts results to cases filed against a specific item or a specific transaction involving the same item. If the itemFilter.transactionId field is specified, a maximum of one case will be returned since there can only be one case per transaction.
See the Field Index to learn which calls use itemFilter.
paginationInput ( PaginationInput ) [0..1]
Controls the pagination of the result set, including the number of cases returned per page and the page number you want returned in the output.
See the Field Index to learn which calls use paginationInput.
sortOrder ( CaseSortOrderType ) [0..1]
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.