GetUserDisputes

Use this call to retrieve a list of Unpaid Item cases that the user is involved in as a buyer or seller.

You can filter the response according to DisputeFilter values that you supply. Use a DetailLevel of ReturnAll to return all data about each dispute, including the DisputeResolution and DisputeMessage containers.

The GetUserDisputes response might contain a large number of records, as the maximum number of records returned per page is 200. Pagination fields, filters, and sorting can be used to control the number of cases returned per page, and which page to return from the result set.

If you know the DisputeID value of specific case, you can use the GetDispute call to retrieve information only on the specified case.

The response from GetUserDisputes contains each case that involves the user as a buyer or seller, and that matches any filtering criteria that may have been used. Within each Dispute record, you can parse for information such as DisputeID, DisputeRecord, DisputeState, DisputeStatus, DisputeReason, and DisputeExplanation.

See Unpaid Item Cases.

See also the reference documentation for these calls:

• AddDispute - Creates an Unpaid Item case against a buyer.
• AddDisputeResponse - This call is used by a seller to update an Unpaid Item case.
• GetDispute - This call retrieves the details of an Unpaid Item case.
• SellerReverseDispute - Enables a seller to "reverse" an Unpaid Item case that has been closed if a buyer and seller reach an agreement. The seller's Final Value Fee credit and the buyer's strike are both reversed. if applicable.

Input

See also Samples.

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 the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are (or soon will be) non-operational.

The XML prototype does not include requester credentials. This is a documentation limitation only (see Standard Requester Credentials for Making Calls).

<?xml version="1.0" encoding="utf-8"?>
<GetUserDisputesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Input Fields -->
  <DisputeFilterType> DisputeFilterTypeCodeType </DisputeFilterType>
  <DisputeSortType> DisputeSortTypeCodeType </DisputeSortType>
  <ModTimeFrom> dateTime </ModTimeFrom>
  <ModTimeTo> dateTime </ModTimeTo>
  <Pagination> PaginationType
    <EntriesPerPage> int </EntriesPerPage>
    <PageNumber> int </PageNumber>
  </Pagination>
  <!-- Standard Input Fields -->
  <DetailLevel> DetailLevelCodeType </DetailLevel>
  <!-- ... more DetailLevel values allowed here ... -->
  <ErrorLanguage> string </ErrorLanguage>
  <MessageID> string </MessageID>
  <Version> string </Version>
  <WarningLevel> WarningLevelCodeType </WarningLevel>
</GetUserDisputesRequest>

Output

See also Samples.

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 the Deprecated Objects link above. Fields presented in this color are deprecated, and fields presented in this color are not returned (or soon will not be returned) or are not operational (or soon will be non-operational).

<?xml version="1.0" encoding="utf-8"?>
<GetUserDisputesResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Output Fields -->
  <DisputeArray> DisputeArrayType
    <Dispute> DisputeType
      <DisputeCreatedTime> dateTime </DisputeCreatedTime>
      <DisputeCreditEligibility> DisputeCreditEligibilityCodeType </DisputeCreditEligibility>
      <DisputeExplanation> DisputeExplanationCodeType </DisputeExplanation>
      <DisputeID> DisputeIDType (string) </DisputeID>
      <DisputeMessage> DisputeMessageType
        <MessageCreationTime> dateTime </MessageCreationTime>
        <MessageID> int </MessageID>
        <MessageSource> DisputeMessageSourceCodeType </MessageSource>
        <MessageText> string </MessageText>
      </DisputeMessage>
      <!-- ... more DisputeMessage nodes allowed here ... -->
      <DisputeModifiedTime> dateTime </DisputeModifiedTime>
      <DisputeReason> DisputeReasonCodeType </DisputeReason>
      <DisputeRecordType> DisputeRecordTypeCodeType </DisputeRecordType>
      <DisputeResolution> DisputeResolutionType
        <DisputeResolutionReason> DisputeResolutionReasonCodeType </DisputeResolutionReason>
        <DisputeResolutionRecordType> DisputeResolutionRecordTypeCodeType </DisputeResolutionRecordType>
        <ResolutionTime> dateTime </ResolutionTime>
      </DisputeResolution>
      <!-- ... more DisputeResolution nodes allowed here ... -->
      <DisputeState> DisputeStateCodeType </DisputeState>
      <DisputeStatus> DisputeStatusCodeType </DisputeStatus>
      <Item> ItemType
        <ItemID> ItemIDType (string) </ItemID>
      </Item>
      <OrderLineItemID> string </OrderLineItemID>
      <OtherPartyName> string </OtherPartyName>
      <OtherPartyRole> TradingRoleCodeType </OtherPartyRole>
      <TransactionID> string </TransactionID>
      <UserRole> TradingRoleCodeType </UserRole>
    </Dispute>
    <!-- ... more Dispute nodes allowed here ... -->
  </DisputeArray>
  <DisputeFilterCount> DisputeFilterCountType
    <DisputeFilterType> DisputeFilterTypeCodeType </DisputeFilterType>
    <TotalAvailable> int </TotalAvailable>
  </DisputeFilterCount>
  <!-- ... more DisputeFilterCount nodes allowed here ... -->
  <EndingDisputeID> DisputeIDType (string) </EndingDisputeID>
  <ItemsPerPage> int </ItemsPerPage>
  <PageNumber> int </PageNumber>
  <PaginationResult> PaginationResultType
    <TotalNumberOfPages> int </TotalNumberOfPages>
  </PaginationResult>
  <StartingDisputeID> DisputeIDType (string) </StartingDisputeID>
  <!-- Standard Output Fields -->
  <Ack> AckCodeType </Ack>
  <Build> string </Build>
  <CorrelationID> string </CorrelationID>
  <Errors> ErrorType
    <ErrorClassification> ErrorClassificationCodeType </ErrorClassification>
    <ErrorCode> token </ErrorCode>
    <ErrorParameters ParamID="string"> ErrorParameterType
      <Value> string </Value>
    </ErrorParameters>
    <!-- ... more ErrorParameters nodes allowed here ... -->
    <LongMessage> string </LongMessage>
    <SeverityCode> SeverityCodeType </SeverityCode>
    <ShortMessage> string </ShortMessage>
  </Errors>
  <!-- ... more Errors nodes allowed here ... -->
  <HardExpirationWarning> string </HardExpirationWarning>
  <Timestamp> dateTime </Timestamp>
  <Version> string </Version>
</GetUserDisputesResponse>

Detail Controls

DetailLevel

The DetailLevel input field influences which call-specific fields may be returned. (All standard output fields are returned regardless of DetailLevel.)

The none column indicates the fields that are returned when you do not specify a DetailLevel.

Samples

New to making API calls? Please see Making a Call.

Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.

The following sample shows all disputes that the user is involved in both as a buyer and seller (whichever are applicable).

Input

The user wants to retrieved all disputes they have been, or are currently involved in, both as a buyer and/or seller. Disputes are sorted by dispute creation time in descending order (most recent returned first).

XML format.

<?xml version="1.0" encoding="utf-8"?>
<GetUserDisputesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <RequesterCredentials>
    <eBayAuthToken>A*******3</eBayAuthToken>
  </RequesterCredentials>
  <WarningLevel>High</WarningLevel>
  <DisputeFilterType>AllInvolvedDisputes</DisputeFilterType>
  <DisputeSortType>DisputeCreatedTimeDescending</DisputeSortType>
  <Pagination>
    <EntriesPerPage>5</EntriesPerPage>
    <PageNumber>1</PageNumber>
  </Pagination>
</GetUserDisputesRequest>

Output

Two disputes are found for the user. One of the disputes is an Unpaid Item case in which the user was the buyer. In this case, the user paid for the item after the Unpaid Item case was opened, but ultimately, the item was returned for a refund, and the user did not get an Unpaid Item strike. In the other dispute, the user was the seller, and an Unpaid Item case was opened up against the buyer automatically with the Unpaid Item Assistant feature. The item was never shipped, and the case was eventually closed. The different dispute types (and applicable counts) are shown at the end of the response.

XML format.
<?xml version="1.0" encoding="UTF-8"?>
<GetUserDisputesResponse 
  xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2019-11-06T17:03:58.384Z</Timestamp>
  <Ack>Success</Ack>
  <Version>1131</Version>
  <Build>E1131_UNI_API5_19098188_R1</Build>
  <StartingDisputeID>1</StartingDisputeID>
  <EndingDisputeID>*</EndingDisputeID>
  <DisputeArray>
    <Dispute>
      <DisputeID>7*******2</DisputeID>
      <DisputeRecordType>UnpaidItem</DisputeRecordType>
      <DisputeState>Closed</DisputeState>
      <DisputeStatus>ClosedFVFCreditNoStrike</DisputeStatus>
      <OtherPartyRole>Seller</OtherPartyRole>
      <OtherPartyName>d***o</OtherPartyName>
      <UserRole>Buyer</UserRole>
      <TransactionID>9**********3</TransactionID>
      <Item>
        <ItemID>3**********0</ItemID>
        <ConditionID>1000</ConditionID>
        <ConditionDisplayName>New</ConditionDisplayName>
      </Item>
      <DisputeReason>TransactionMutuallyCanceled</DisputeReason>
      <DisputeExplanation>BuyerReturnedItemForRefund</DisputeExplanation>
      <DisputeCreditEligibility>InEligible</DisputeCreditEligibility>
      <DisputeCreatedTime>2019-02-16T23:25:16.000Z</DisputeCreatedTime>
      <DisputeModifiedTime>2019-02-24T12:02:43.000Z</DisputeModifiedTime>
      <OrderLineItemID>3**********0-9***********3</OrderLineItemID>
    </Dispute>
    <Dispute>
      <DisputeID>7*******5</DisputeID>
      <DisputeRecordType>UnpaidItem</DisputeRecordType>
      <DisputeState>Closed</DisputeState>
      <DisputeStatus>ClosedFVFCreditStrike</DisputeStatus>
      <OtherPartyRole>Buyer</OtherPartyRole>
      <OtherPartyName>j***4</OtherPartyName>
      <UserRole>Seller</UserRole>
      <TransactionID>1***********2</TransactionID>
      <Item>
        <ItemID>1**********7</ItemID>
        <ConditionID>1000</ConditionID>
        <ConditionDisplayName>New</ConditionDisplayName>
      </Item>
      <DisputeReason>BuyerHasNotPaid</DisputeReason>
      <DisputeExplanation>UPIAssistance</DisputeExplanation>
      <DisputeCreditEligibility>InEligible</DisputeCreditEligibility>
      <DisputeCreatedTime>2019-06-18T18:46:41.000Z</DisputeCreatedTime>
      <DisputeModifiedTime>2019-06-22T18:47:20.000Z</DisputeModifiedTime>
      <OrderLineItemID>1**********7-1***********2</OrderLineItemID>
    </Dispute>
  </DisputeArray>
  <ItemsPerPage>200</ItemsPerPage>
  <PageNumber>1</PageNumber>
  <DisputeFilterCount>
    <DisputeFilterType>AllInvolvedDisputes</DisputeFilterType>
  </DisputeFilterCount>
  <DisputeFilterCount>
    <DisputeFilterType>DisputesAwaitingMyResponse</DisputeFilterType>
    <TotalAvailable>0</TotalAvailable>
  </DisputeFilterCount>
  <DisputeFilterCount>
    <DisputeFilterType>DisputesAwaitingOtherPartyResponse</DisputeFilterType>
    <TotalAvailable>0</TotalAvailable>
  </DisputeFilterCount>
  <DisputeFilterCount>
    <DisputeFilterType>AllInvolvedClosedDisputes</DisputeFilterType>
    <TotalAvailable>2</TotalAvailable>
  </DisputeFilterCount>
  <DisputeFilterCount>
    <DisputeFilterType>EligibleForCredit</DisputeFilterType>
    <TotalAvailable>0</TotalAvailable>
  </DisputeFilterCount>
  <DisputeFilterCount>
    <DisputeFilterType>UnpaidItemDisputes</DisputeFilterType>
    <TotalAvailable>2</TotalAvailable>
  </DisputeFilterCount>
  <DisputeFilterCount>
    <DisputeFilterType>ItemNotReceivedDisputes</DisputeFilterType>
    <TotalAvailable>0</TotalAvailable>
  </DisputeFilterCount>
  <PaginationResult>
    <TotalNumberOfPages>1</TotalNumberOfPages>
  </PaginationResult>
</GetUserDisputesResponse>

Change History