eBay Trading API Call Reference Version 821 Support     Knowledge Base     Forums     All Tutorials     All Code Samples Users Guide Call Reference Making an API Call Tutorials Release Notes

Call Index Field Index Enumeration Index Type Index Deprecated Objects Errors by Number Input Output Detail Controls Samples Change History Top Errors for GetItemsAwaitingFeedback User Notes

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.

See also the reference documentation for these calls:

• GetMyeBayBuying - Returns items from the Buying section of the user's My eBay account, including items that the user is watching, bidding on, has won, has not won, and has made Best Offers on.
• GetMyeBaySelling - Returns items from the Selling section of the user's My eBay account, including items that the user is currently selling (the Active list), items that have bids, sold items, and unsold items.
• GetMyeBayReminders - Requests totals for the Buying and Selling reminders from the user's My eBay account.

Back to top

GetItemsAwaitingFeedback Input

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 Samples.

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>

Back to top

GetItemsAwaitingFeedback Output

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 Samples.

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>

Back to top

GetItemsAwaitingFeedback Detail Controls

Detail Control: DetailLevel

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

Back to top

GetItemsAwaitingFeedback Samples

New to making API calls? Please see Routing the Request.

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 (HTTP POST). Also available is the .txt version of this XML.

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

Output

XML format. Also available is the .txt version of this XML.

<GetItemsAwaitingFeedbackResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2010-02-26T19:56:55.402Z</Timestamp>
  <Ack>Success</Ack>
  <Version>657</Version>
  <Build>E657_CORE_BUNDLED_10708779_R1</Build>
  <ItemsAwaitingFeedback>
    <TransactionArray>
      <Transaction>
        <Buyer>
          <UserID>bigbuyer</UserID>
        </Buyer>
        <Item>
          <ItemID>110043699861</ItemID>
          <ListingDetails>
            <EndTime>2010-02-18T18:55:28.000Z</EndTime>
          </ListingDetails>
          <Title>Harry Potter and the Goblet of Fire</Title>
        </Item>
        <TransactionID>0</TransactionID>
      </Transaction>
      <Transaction>
        <Buyer>
          <UserID>bookbuyer</UserID>
        </Buyer>
        <Item>
          <ItemID>110043617838</ItemID>
          <ListingDetails>
            <EndTime>2010-02-18T00:48:39.000Z</EndTime>
          </ListingDetails>
          <Title>Harry Potter Book Set !!</Title>
        </Item>
        <TransactionID>0</TransactionID>
      </Transaction>
      <Transaction>
        <Buyer>
          <UserID>bountifulbuyer</UserID>
        </Buyer>
        <Item>
          <ItemID>110043566072</ItemID>
          <ListingDetails>
            <EndTime>2010-02-10T21:42:11.000Z</EndTime>
          </ListingDetails>
          <Title>Harry Potter and the Philosopher's Stone</Title>
        </Item>
        <TransactionID>0</TransactionID>
        <FeedbackLeft>
          <CommentType>Positive</CommentType>
        </FeedbackLeft>
      </Transaction>
    </TransactionArray>
    <PaginationResult>
      <TotalNumberOfPages>1</TotalNumberOfPages>
      <TotalNumberOfEntries>3</TotalNumberOfEntries>
    </PaginationResult>
  </ItemsAwaitingFeedback>
</GetItemsAwaitingFeedbackResponse>

Back to top

GetItemsAwaitingFeedback Change History

Back to top

User-Contributed Notes

Copyright © 2005–2013 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.