Website logo

Retrieve unanswered questions on a single listing

Retrieves all of the unanswered questions for a single listing.

URL: https://api.trademe.co.nz/v1/Listings/{listingId}/questions/unansweredquestions.{file_format}
HTTP Method: GET
Requires Authentication? Yes
Permission Required: MyTradeMeRead: Read your membership & listing data.
Supported Formats: XML, JSON
Rate Limited? Yes

URL parameters

listingId Integer (required)

The ID of the listing whose questions are to be returned.

file_format Enumeration (required) The format of the response.
xml Serialize responses into XML.
json Serialize responses into JSON.

Returns

<Questions>

The unanswered questions for the listing identified by listingId.

TotalCount Integer

The total number of results in the collection. Can be larger than the number of returned results.

Page Integer

The index of the current page of results (starts at 1).

PageSize Integer

The number of results in the current page.

List Collection of <Question> or null

A list of the results in the current page.

ListingId Long Integer

The ID of the listing this question belongs to.

ListingQuestionId Long Integer

The question ID.

Comment String or null

The text of the question.

CommentDate DateTime

The date and time the question was asked.

Answer String or null

The answer given to the question by the owner of the listing.

AnswerDate DateTime

The date the question was answered.

IsSellerComment Boolean

Indicates whether this is a comment from the seller rather than a question.

AskingMember <Member> or null

The member details for the member asking the question.

MemberId Integer

The ID of the member. This may be 0, if we determine it is necessary to protect the member's privacy.

Nickname String or null

The nickname of the member. Some characters may be changed, if we determine it is necessary to protect the member's privacy.

DateAddressVerified DateTime

The date the member was address verified.

DateJoined DateTime

The date the member joined.

UniqueNegative Integer

The number of distinct members who have placed negative feedback against this member.

UniquePositive Integer

The number of distinct members who have placed positive feedback against this member.

FeedbackCount Integer

The member's total feedback (UniquePositive minus UniqueNegative).

IsAddressVerified Boolean

Indicates whether the member has been address verified.

IsDealer Boolean

Indicates whether the member is a car dealer.

IsAuthenticated Boolean

Indicates whether the member is authenticated.

Photo String or null

The profile photo URL of the member

Example XML Response (switch to JSON)

<Questions xmlns="http://api.trademe.co.nz/v1">
  <TotalCount>123</TotalCount>
  <Page>123</Page>
  <PageSize>123</PageSize>
  <List>
    <Question>
      <ListingId>123</ListingId>
      <ListingQuestionId>123</ListingQuestionId>
      <Comment>ABC</Comment>
      <CommentDate>2018-01-01T00:00:00Z</CommentDate>
      <Answer>ABC</Answer>
      <AnswerDate>2018-01-01T00:00:00Z</AnswerDate>
      <IsSellerComment>false</IsSellerComment>
      <AskingMember>
        <MemberId>123</MemberId>
        <Nickname>ABC</Nickname>
        <DateAddressVerified>2018-01-01T00:00:00Z</DateAddressVerified>
        <DateJoined>2018-01-01T00:00:00Z</DateJoined>
        <UniqueNegative>123</UniqueNegative>
        <UniquePositive>123</UniquePositive>
        <FeedbackCount>123</FeedbackCount>
        <IsAddressVerified>false</IsAddressVerified>
        <IsDealer>false</IsDealer>
        <IsAuthenticated>false</IsAuthenticated>
        <Photo>ABC</Photo>
      </AskingMember>
    </Question>
    <Question>
      <ListingId>123</ListingId>
      <ListingQuestionId>123</ListingQuestionId>
      <Comment>ABC</Comment>
      <CommentDate>2018-01-01T00:00:00Z</CommentDate>
      <Answer>ABC</Answer>
      <AnswerDate>2018-01-01T00:00:00Z</AnswerDate>
      <IsSellerComment>false</IsSellerComment>
      <AskingMember>
        <MemberId>123</MemberId>
        <Nickname>ABC</Nickname>
        <DateAddressVerified>2018-01-01T00:00:00Z</DateAddressVerified>
        <DateJoined>2018-01-01T00:00:00Z</DateJoined>
        <UniqueNegative>123</UniqueNegative>
        <UniquePositive>123</UniquePositive>
        <FeedbackCount>123</FeedbackCount>
        <IsAddressVerified>false</IsAddressVerified>
        <IsDealer>false</IsDealer>
        <IsAuthenticated>false</IsAuthenticated>
        <Photo>ABC</Photo>
      </AskingMember>
    </Question>
  </List>
</Questions>

Example JSON Response (switch to XML)

{
  "TotalCount": 123,
  "Page": 123,
  "PageSize": 123,
  "List": [
    {
      "ListingId": 123,
      "ListingQuestionId": 123,
      "Comment": "ABC",
      "CommentDate": "\/Date(1514764800)\/",
      "Answer": "ABC",
      "AnswerDate": "\/Date(1514764800)\/",
      "IsSellerComment": false,
      "AskingMember": {
        "MemberId": 123,
        "Nickname": "ABC",
        "DateAddressVerified": "\/Date(1514764800)\/",
        "DateJoined": "\/Date(1514764800)\/",
        "UniqueNegative": 123,
        "UniquePositive": 123,
        "FeedbackCount": 123,
        "IsAddressVerified": false,
        "IsDealer": false,
        "IsAuthenticated": false,
        "Photo": "ABC"
      }
    },
    {
      "ListingId": 123,
      "ListingQuestionId": 123,
      "Comment": "ABC",
      "CommentDate": "\/Date(1514764800)\/",
      "Answer": "ABC",
      "AnswerDate": "\/Date(1514764800)\/",
      "IsSellerComment": false,
      "AskingMember": {
        "MemberId": 123,
        "Nickname": "ABC",
        "DateAddressVerified": "\/Date(1514764800)\/",
        "DateJoined": "\/Date(1514764800)\/",
        "UniqueNegative": 123,
        "UniquePositive": 123,
        "FeedbackCount": 123,
        "IsAddressVerified": false,
        "IsDealer": false,
        "IsAuthenticated": false,
        "Photo": "ABC"
      }
    }
  ]
}