GetMemberMessages

Use this call to retrieve a list of messages from buyers. The messages pertain to the active listings of the authenticated caller.

A buyer can ask a question on the eBay site. The seller can respond to the "Ask Seller a Question" (ASQ) message using calls from the AddMemberMessage family of calls. See Communication Between Members for conceptual information about messaging.

GetMemberMessages retrieves messages sent between buyers and sellers about a particular item listing or order line item. The response contains an Item container for each returned message, which includes the relevant ItemID.

GetMemberMessages returns more nodes per message than GetMyMessages. GetMyMessages returns more types of messages than GetMemberMessages.

Usage Details

You can get all the messages sent within a specific time range by providing StartCreationTime and EndCreationTime in your request. Or you can specify an item's ItemID to get messages about an item.

GetMemberMessages supports pagination. Use the Pagination.EntriesPerPage and Pagination.PageNumber input fields. EntriesPerPage establishes the maximum number of detail entries returned per call. Set this to one of the four following values: 25 (the default), 50, 100, or 200. If a value of zero or less or a value greater than 200 is specified, the call fails with an error. A specified value of 1-24 is automatically rounded up to 25 (and the call does not fail). Values between 26 and 199 that are not one of the accepted values are automatically rounded down to the nearest accepted value.

After calling GetMemberMessages, inspect the children of the MemberMessages container. For instance, if you want to know whether a message was previously answered, inspect the MessageStatus field.

Testing GetMemberMessages

You can test GetMemberMessages in the Sandbox.

Related Information

See also the reference documentation for this call:

• GetMyMessages - Retrieves information about the messages sent to a user.

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"?>
<GetMemberMessagesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
 <!-- Call-specific Input Fields -->
 <DisplayToPublic> boolean </DisplayToPublic>
 <EndCreationTime> dateTime </EndCreationTime>
 <ItemID> ItemIDType (string) </ItemID>
 <MailMessageType> MessageTypeCodeType </MailMessageType>
 <MemberMessageID> string </MemberMessageID>
 <MessageStatus> MessageStatusTypeCodeType </MessageStatus>
 <Pagination> PaginationType
 <EntriesPerPage> int </EntriesPerPage>
 <PageNumber> int </PageNumber>
 </Pagination>
 <SenderID> UserIDType (string) </SenderID>
 <StartCreationTime> dateTime </StartCreationTime>
 <!-- Standard Input Fields -->
 <ErrorLanguage> string </ErrorLanguage>
 <MessageID> string </MessageID>
 <OutputSelector> string </OutputSelector>
 <!-- ... more OutputSelector values allowed here ... -->
 <Version> string </Version>
 <WarningLevel> WarningLevelCodeType </WarningLevel>
</GetMemberMessagesRequest>

 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"?>
<GetMemberMessagesResponse xmlns="urn:ebay:apis:eBLBaseComponents">
 <!-- Call-specific Output Fields -->
 <HasMoreItems> boolean </HasMoreItems>
 <MemberMessage> MemberMessageExchangeArrayType
 <MemberMessageExchange> MemberMessageExchangeType
 <Item> ItemType
 <ItemID> ItemIDType (string) </ItemID>
 <ListingDetails> ListingDetailsType
 <EndTime> dateTime </EndTime>
 <StartTime> dateTime </StartTime>
 </ListingDetails>
 <SellingStatus> SellingStatusType
 <CurrentPrice currencyID="CurrencyCodeType"> AmountType (double) </CurrentPrice>
 </SellingStatus>
 <Title> string </Title>
 </Item>
 <LastModifiedDate> dateTime </LastModifiedDate>
 <MessageMedia> MessageMediaType
 <MediaName> string </MediaName>
 <MediaURL> anyURI </MediaURL>
 </MessageMedia>
 <!-- ... more MessageMedia nodes allowed here ... -->
 <MessageStatus> MessageStatusTypeCodeType </MessageStatus>
 <Question> MemberMessageType
 <Body> string </Body>
 <DisplayToPublic> boolean </DisplayToPublic>
 <MessageID> string </MessageID>
 <MessageMedia> MessageMediaType
 <MediaName> string </MediaName>
 <MediaURL> anyURI </MediaURL>
 </MessageMedia>
 <!-- ... more MessageMedia nodes allowed here ... -->
 <MessageType> MessageTypeCodeType </MessageType>
 <QuestionType> QuestionTypeCodeType </QuestionType>
 <RecipientID> string </RecipientID>
 <!-- ... more RecipientID values allowed here ... -->
 <SenderEmail> string </SenderEmail>
 <SenderID> string </SenderID>
 <Subject> string </Subject>
 </Question>
 <Response> string </Response>
 <!-- ... more Response values allowed here ... -->
 </MemberMessageExchange>
 <!-- ... more MemberMessageExchange nodes allowed here ... -->
 </MemberMessage>
 <PaginationResult> PaginationResultType
 <TotalNumberOfEntries> int </TotalNumberOfEntries>
 <TotalNumberOfPages> int </TotalNumberOfPages>
 </PaginationResult>
 <!-- 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>
</GetMemberMessagesResponse>

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 Ask the Seller a Question messages for a given date range.

Description

Seller m***************r wants to review the new messages that users might have sent regarding the items she has listed. She uses several controls in the request to specify the particular messages she wants returned.

Input

To get just the latest set of messages, m***************r specifies a time range with StartCreationTime and EndCreationTime values. Times are specfied in GMT. MessageStatus is set to Unanswered so that the response contains only new messages and MailMessageType is set to AskSellerQuestion.

Sellers with multiple listings will often have many questions posed by potential buyers. To control the volume of the response, m***************r uses Pagination values to control which messages are returned from the result set.

XML format.
<?xml version="1.0" encoding="utf-8"?>
<GetMemberMessagesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
 <RequesterCredentials>
 <eBayAuthToken>A*******3</eBayAuthToken>
 </RequesterCredentials>
 <WarningLevel>High</WarningLevel>
 <MailMessageType>AskSellerQuestion</MailMessageType>
 <MessageStatus>Unanswered</MessageStatus>
 <StartCreationTime>2019年09月01日T00:00:00.000Z</StartCreationTime>
 <EndCreationTime>2019年09月30日T19:23:13.821Z</EndCreationTime>
 <Pagination>
 <EntriesPerPage>5</EntriesPerPage>
 <PageNumber>1</PageNumber>
 </Pagination>
</GetMemberMessagesRequest>

Output

The output details a single message that was sent within the last few days.

XML format.
<GetMemberMessagesResponse xmlns="urn:ebay:apis:eBLBaseComponents">
 <Timestamp>2019年11月04日T21:58:44.514Z</Timestamp>
 <Ack>Success</Ack>
 <Version>1127</Version>
 <Build>E1127_CORE_APIMSG_19083139_R1</Build>
 <MemberMessage>
 <MemberMessageExchange>
 <Item>
 <ItemID>1**********2</ItemID>
 <ListingDetails>
 <StartTime>2019年09月16日T18:52:41.000Z</StartTime>
 <EndTime>2019年09月23日T18:52:41.000Z</EndTime>
 <ViewItemURL>http://cgi.sandbox.ebay.com/ws/eBayISAPI.dll?ViewItem&item=1**********2&category=3*7</ViewItemURL>
 </ListingDetails>
 <Seller>
 <UserID>m***************r</UserID>
 </Seller>
 <SellingStatus>
 <CurrentPrice currencyID="USD">1.0</CurrentPrice>
 </SellingStatus>
 <TimeLeft>P6DT23H28M49S</TimeLeft>
 <Title>Harry Potter and the Philosopher's Stone</Title>
 </Item>
 <Question>
 <MessageType>AskSellerQuestion</MessageType>
 <QuestionType>CustomizedSubject</QuestionType>
 <DisplayToPublic>false</DisplayToPublic>
 <SenderID>b************r</SenderID>
 <SenderEmail>B*************@*****.com</SenderEmail>
 <RecipientID>m***************r</RecipientID>
 <Subject>
 b************r has sent a question about :General question about this item for item #1**********2,
 ending on Sep-23-19 10:52:41 PST - Harry Potter and the Philosopher's Stone
 </Subject>
 <Body>
 I thought the first book in the Harry Potter series was titled "Harry Potter and the Sorcerer's Stone".
 Is this a different book?
 </Body>
 <MessageID>7****6</MessageID>
 </Question>
 <MessageStatus>Unanswered</MessageStatus>
 <CreationDate>2019年09月16日T19:22:26.000Z</CreationDate>
 <LastModifiedDate>2019年09月16日T19:22:26.000Z</LastModifiedDate>
 </MemberMessageExchange>
 </MemberMessage>
 <PaginationResult>
 <TotalNumberOfPages>1</TotalNumberOfPages>
 <TotalNumberOfEntries>1</TotalNumberOfEntries>
 </PaginationResult>
 <HasMoreItems>false</HasMoreItems>
</GetMemberMessagesResponse>

Change History