Website logo

Retrieve all enquiries made for a specific listing

Retrieve all enquiries made for a specific listing.

URL: https://api.trademe.co.nz/v1/listings/{listingId}/enquiries.{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 listing to get enquiries for.
file_format Enumeration (required) The format of the response.
xml Serialize responses into XML.
json Serialize responses into JSON.

Query String parameters

endTime DateTime (optional)

The end datetime to return enquiries until. Optional.
page Integer (optional)

The page number of the set of results to return, starting from 1. Defaults to 1.
rows Integer (optional)

The number of results per page; also the maximum number of results to return. Defaults to 50.
startTime DateTime (optional)

The start datetime to return enquiries from. Optional.

Returns

<Enquiries>

A collection of enquiries

TotalCount Integer TotalCount
Page Integer Page
PageSize Integer PageSize
List Collection of <Enquiry> or null InnerList
Body String or null Body
Date DateTime Date
Enquirer <Member> or null Enquirer
MemberId Integer MemberId
Nickname String or null Nickname
DateAddressVerified DateTime DateAddressVerified
DateJoined DateTime DateJoined
Email String or null Email
UniqueNegative Integer UniqueNegative
UniquePositive Integer UniquePositive
FeedbackCount Integer FeedbackCount
IsAddressVerified Boolean IsAddressVerified
IsDealer Boolean IsDealer
IsAuthenticated Boolean IsAuthenticated
FirstName String or null FirstName
LastName String or null LastName
PhoneNumber String or null PhoneNumber

Example XML Response (switch to JSON) 

<Enquiries xmlns="http://api.trademe.co.nz/v1">
  <TotalCount>123</TotalCount>
  <Page>123</Page>
  <PageSize>123</PageSize>
  <List>
    <Enquiry>
      <Body>ABC</Body>
      <Date>2018-01-01T00:00:00Z</Date>
      <Enquirer>
        <MemberId>123</MemberId>
        <Nickname>ABC</Nickname>
        <DateAddressVerified>2018-01-01T00:00:00Z</DateAddressVerified>
        <DateJoined>2018-01-01T00:00:00Z</DateJoined>
        <Email>ABC</Email>
        <UniqueNegative>123</UniqueNegative>
        <UniquePositive>123</UniquePositive>
        <FeedbackCount>123</FeedbackCount>
        <IsAddressVerified>false</IsAddressVerified>
        <IsDealer>false</IsDealer>
        <IsAuthenticated>false</IsAuthenticated>
        <FirstName>ABC</FirstName>
        <LastName>ABC</LastName>
        <PhoneNumber>ABC</PhoneNumber>
      </Enquirer>
    </Enquiry>
    <Enquiry>
      <Body>ABC</Body>
      <Date>2018-01-01T00:00:00Z</Date>
      <Enquirer>
        <MemberId>123</MemberId>
        <Nickname>ABC</Nickname>
        <DateAddressVerified>2018-01-01T00:00:00Z</DateAddressVerified>
        <DateJoined>2018-01-01T00:00:00Z</DateJoined>
        <Email>ABC</Email>
        <UniqueNegative>123</UniqueNegative>
        <UniquePositive>123</UniquePositive>
        <FeedbackCount>123</FeedbackCount>
        <IsAddressVerified>false</IsAddressVerified>
        <IsDealer>false</IsDealer>
        <IsAuthenticated>false</IsAuthenticated>
        <FirstName>ABC</FirstName>
        <LastName>ABC</LastName>
        <PhoneNumber>ABC</PhoneNumber>
      </Enquirer>
    </Enquiry>
  </List>
</Enquiries>

Example JSON Response (switch to XML) 

{
  "TotalCount": 123,
  "Page": 123,
  "PageSize": 123,
  "List": [
    {
      "Body": "ABC",
      "Date": "\/Date(1514764800)\/",
      "Enquirer": {
        "MemberId": 123,
        "Nickname": "ABC",
        "DateAddressVerified": "\/Date(1514764800)\/",
        "DateJoined": "\/Date(1514764800)\/",
        "Email": "ABC",
        "UniqueNegative": 123,
        "UniquePositive": 123,
        "FeedbackCount": 123,
        "IsAddressVerified": false,
        "IsDealer": false,
        "IsAuthenticated": false,
        "FirstName": "ABC",
        "LastName": "ABC",
        "PhoneNumber": "ABC"
      }
    },
    {
      "Body": "ABC",
      "Date": "\/Date(1514764800)\/",
      "Enquirer": {
        "MemberId": 123,
        "Nickname": "ABC",
        "DateAddressVerified": "\/Date(1514764800)\/",
        "DateJoined": "\/Date(1514764800)\/",
        "Email": "ABC",
        "UniqueNegative": 123,
        "UniquePositive": 123,
        "FeedbackCount": 123,
        "IsAddressVerified": false,
        "IsDealer": false,
        "IsAuthenticated": false,
        "FirstName": "ABC",
        "LastName": "ABC",
        "PhoneNumber": "ABC"
      }
    }
  ]
}