GetItemsAwaitingFeedback

Use this call to retrieve a list of order line items in which the user was involved and for which feedback is still needed from either the buyer or the seller.

You can specify the sort order of the returned list using one of the following Sort values:

• Title
• TitleDescending
• UserID
• UserIDDescending
• EndTime
• EndTimeDescending
• FeedbackReceived
• FeedbackReceivedDescending
• FeedbackLeft
• FeedbackLeftDescending

If GetItemsAwaitingFeedback execution is successful, it returns an ItemsAwaitingFeedback container. Within this contaier is a TransactionArray that contains a Transaction container for each item that is awaiting feedback.

Parse each Transaction to get the information that you need for your application. Values that you might want to store include values in the Buyer and Item containers. The Item container does not return a complete set of item values, however it does return an ItemID, ListingDetails, and Title. In addition, the response also contains a PaginationResult that details the number of pages and order line items contained in the response.

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"?>
<GetItemsAwaitingFeedbackRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Input Fields -->
  <Pagination> PaginationType
    <EntriesPerPage> int </EntriesPerPage>
    <PageNumber> int </PageNumber>
  </Pagination>
  <Sort> ItemSortTypeCodeType </Sort>
  <!-- Standard Input Fields -->
  <ErrorLanguage> string </ErrorLanguage>
  <MessageID> string </MessageID>
  <OutputSelector> string </OutputSelector>
  <!-- ... more OutputSelector values allowed here ... -->
  <Version> string </Version>
  <WarningLevel> WarningLevelCodeType </WarningLevel>
</GetItemsAwaitingFeedbackRequest>

 If the following output selectors are used: 

...
 <OutputSelector>ViewItemURL</OutputSelector>
 <OutputSelector>BuyItNowPrice</OutputSelector> 
... 

 ...the response might look like the following 

  <Item>
 <BuyItNowPrice currencyID="USD">0.0</BuyItNowPrice>
 <ListingDetails>
 <ViewItemURL>http://www.ebay.com/itm/Tag-Heuer-Mens-Watch/182879833261</ViewItemURL>
 </ListingDetails>
 </Item>  

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"?>
<GetItemsAwaitingFeedbackResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Output Fields -->
  <ItemsAwaitingFeedback> PaginatedTransactionArrayType
    <PaginationResult> PaginationResultType
      <TotalNumberOfEntries> int </TotalNumberOfEntries>
      <TotalNumberOfPages> int </TotalNumberOfPages>
    </PaginationResult>
    <TransactionArray> TransactionArrayType
      <Transaction> TransactionType
        <Buyer> UserType
          <UserID> UserIDType (string) </UserID>
        </Buyer>
        <FeedbackReceived> FeedbackInfoType
          <CommentType> CommentTypeCodeType </CommentType>
        </FeedbackReceived>
        <Item> ItemType
          <ItemID> ItemIDType (string) </ItemID>
          <ListingDetails> ListingDetailsType
            <EndTime> dateTime </EndTime>
          </ListingDetails>
          <Seller> UserType </Seller>
          <Title> string </Title>
        </Item>
        <OrderLineItemID> string </OrderLineItemID>
        <TransactionID> string </TransactionID>
      </Transaction>
      <!-- ... more Transaction nodes allowed here ... -->
    </TransactionArray>
  </ItemsAwaitingFeedback>
  <!-- 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>
</GetItemsAwaitingFeedbackResponse>

Detail Controls

DetailLevel

This call does not support varying Detail Levels. You do not need to pass DetailLevel in the request.

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.

Retrieves current completed item listing for which the authenticated user needs to leave feedback.

Description

This basic call requires only the user's eBayAuthToken. If needed, include a Sort value to sort the items in the response.

Input

XML format.

<?xml version="1.0" encoding="utf-8"?>
<GetItemsAwaitingFeedbackRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <RequesterCredentials>
    <eBayAuthToken>A*******3</eBayAuthToken>
  </RequesterCredentials>
  <WarningLevel>High</WarningLevel>
</GetItemsAwaitingFeedbackRequest>

Output

XML format.
<GetItemsAwaitingFeedbackResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2019-11-04T21:30:52.330Z</Timestamp>
    <Ack>Success</Ack>
    <Version>1125</Version>
    <Build>E1125_CORE_API_19070409_R1</Build>
    <ItemsAwaitingFeedback>
      <TransactionArray>
        <Transaction>
          <Buyer>
            <UserID>s********1</UserID>
          </Buyer>
          <Item>
            <ItemID>1**********0</ItemID>
            <ListingDetails>
              <EndTime>2018-10-24T18:33:17.000Z</EndTime>
            </ListingDetails>
            <Title>Jonathon Byron Floating Swans 3-D Hand-Painted Porcelain Collector Plate</Title>
            <ConditionID>1000</ConditionID>
            <ConditionDisplayName>New</ConditionDisplayName>
          </Item>
          <TransactionID>0</TransactionID>
          <FeedbackReceived>
            <CommentType>Positive</CommentType>
          </FeedbackReceived>
          <OrderLineItemID>1**********0-0</OrderLineItemID>
        </Transaction>
        <Transaction>
          <Item>
            <ItemID>1**********6</ItemID>
            <ListingDetails>
              <EndTime>2018-10-17T21:16:49.000Z</EndTime>
            </ListingDetails>
            <Seller>
              <UserID>a********2</UserID>
            </Seller>
            <Title>NEW Ooma Telo Free Home Phone Service (VoIP)</Title>
            <ConditionID>1000</ConditionID>
            <ConditionDisplayName>New</ConditionDisplayName>
          </Item>
          <TransactionID>1***********7</TransactionID>
          <OrderLineItemID>1**********6-1***********7</OrderLineItemID>
        </Transaction>
        <Transaction>
          <Buyer>
            <UserID>o********3</UserID>
          </Buyer>
          <Item>
            <ItemID>1**********2</ItemID>
            <ListingDetails>
              <EndTime>2018-10-12T18:00:06.000Z</EndTime>
            </ListingDetails>
            <Title>Mira Golden Line Collection 1:18 Diecast White 1964 1/2 Ford Mustang Convertible</Title>
            <ConditionID>1000</ConditionID>
            <ConditionDisplayName>New</ConditionDisplayName>
          </Item>
          <TransactionID>0</TransactionID>
          <FeedbackLeft>
            <CommentType>Positive</CommentType>
          </FeedbackLeft>
          <OrderLineItemID>1**********2-0</OrderLineItemID>
        </Transaction>
        <Transaction>
          <Buyer>
            <UserID>y********4</UserID>
          </Buyer>
          <Item>
            <ItemID>1**********8</ItemID>
            <ListingDetails>
              <EndTime>2018-10-05T19:11:12.000Z</EndTime>
            </ListingDetails>
            <Title>Anson Red 1972 Ferrari Dino 246 GT Die-Cast Metal 1/18 Scale NIB</Title>
            <ConditionID>1000</ConditionID>
            <ConditionDisplayName>New</ConditionDisplayName>
          </Item>
          <TransactionID>0</TransactionID>
          <FeedbackReceived>
            <CommentType>Positive</CommentType>
          </FeedbackReceived>
          <OrderLineItemID>1**********8-0</OrderLineItemID>
        </Transaction>
        <Transaction>
          <Buyer>
            <UserID>l********5</UserID>
          </Buyer>
          <Item>
            <ItemID>1**********2</ItemID>
            <ListingDetails>
              <EndTime>2018-09-03T22:57:04.000Z</EndTime>
            </ListingDetails>
            <Title>JOE PAVELSKI 2015-16 BOBBLEHEAD NHL SAN JOSE SHARKS 25TH ANNIVERSARY  </Title>
            <ConditionID>1000</ConditionID>
            <ConditionDisplayName>New</ConditionDisplayName>
          </Item>
          <TransactionID>1***********2</TransactionID>
          <FeedbackReceived>
            <CommentType>Positive</CommentType>
          </FeedbackReceived>
          <OrderLineItemID>1**********2-1***********2</OrderLineItemID>
        </Transaction>
      </TransactionArray>
      <PaginationResult>
        <TotalNumberOfPages>1</TotalNumberOfPages>
        <TotalNumberOfEntries>5</TotalNumberOfEntries>
      </PaginationResult>
  </ItemsAwaitingFeedback>
</GetItemsAwaitingFeedbackResponse>

Change History