GetUserDisputes

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

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 preferences 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