Website logo

Send an email to the property seller

Sends an email to the seller of a property classified. If possible, the listing will be added to the authenticated member's watchlist.

URL: https://api.trademe.co.nz/v1/listings/{listingId}/EmailPropertySeller.{file_format}
HTTP Method: POST
Requires Authentication? Yes
Permission Required: MyTradeMeWrite: Maintain your watchlist, answer questions and post comments.
Supported Formats: XML, JSON
Rate Limited? Yes

URL parameters

listingId Integer (required)

The ID of the listing the question is about.
file_format Enumeration (required) The format of the response.
xml Serialize responses into XML.
json Serialize responses into JSON.

POST Data

<EmailPropertyRequest>

Message String (optional) Message
CopyToSelf Boolean (optional) CopyToSelf
PhoneNumber String (optional) PhoneNumber
EmailAddress String (optional) EmailAddress
FirstName String (optional) FirstName
LastName String (optional) LastName
EnquiryType Enumeration (optional) EnquiryType
Unknown 0

Default option when the EnquiryType is not known
General 1

General question
Finance 2

Finance options for the listing
TradeIn 3

Questions about Trade-In of a vehicle
TestDrive 4

Questions about a Test Drive
SpecialOffer 5

Questions about a special offer
InTransit 6

Questions about a listing that is in transit from the factory
Warranty 7

Questions about the Warranty
Insurance 8

Questions about Insurance
AvailableToOrder 9

Questions about a listing this is available to order
CertifiedPreOwned 10

Questions about a certified pre owned listin
CallTracking 11

Placeholder to align integer values with EventPlatform.Schema.Motors. Not wired into any flow yet.
VirEnquiry 12

Questions about a Vehicle Information Report
ReferringSearchId String (optional) ReferringSearchId
IsAppraisalRequested Boolean (optional)

Whether an appraisal is requested alongside the enquiry
PropertyFilesUnlocked Boolean (optional)

Whether the inquiry unlocks one or more property files
BuyingSituation Enumeration (optional)

The buying situation of the property user submitting an enquiry
Unknown 0

Default option when the situation is not known.
FirstTimeBuyer 1

First-time buyer
InvestorOrLandlord 2

Investor or landlord
NothingToSell 3

Buying without needing to sell a pre-existing property
HasAPropertyToSell 4

Has a property to sell
SoldOrUnderOffer 5

Property is sold or under offer
Other 6

Other
FinanceStatus Enumeration (optional)

The finance status of the property user submitting an enquiry
Unknown 0

Default option when the situation is not known or when the user has selected 'prefer not to say'.
HasFinance 1

Finance is arranged
FinanceNotConfirmed 2

Has not applied for finance yet
CashBuyer 3

Buying the property with cash

Returns

<EmailResponse>

Success Boolean

Indicates whether the operation was successful.
Description String or null

The description of the error, if the operation failed.

Example XML Request (switch to JSON) 

<EmailPropertyRequest xmlns="http://api.trademe.co.nz/v1">
  <Message>ABC</Message>
  <CopyToSelf>false</CopyToSelf>
  <PhoneNumber>ABC</PhoneNumber>
  <EmailAddress>ABC</EmailAddress>
  <FirstName>ABC</FirstName>
  <LastName>ABC</LastName>
  <EnquiryType>Unknown</EnquiryType>
  <ReferringSearchId>ABC</ReferringSearchId>
  <IsAppraisalRequested>false</IsAppraisalRequested>
  <PropertyFilesUnlocked>false</PropertyFilesUnlocked>
  <BuyingSituation>Unknown</BuyingSituation>
  <FinanceStatus>Unknown</FinanceStatus>
</EmailPropertyRequest>

Example JSON Request (switch to XML) 

{
  "Message": "ABC",
  "CopyToSelf": false,
  "PhoneNumber": "ABC",
  "EmailAddress": "ABC",
  "FirstName": "ABC",
  "LastName": "ABC",
  "EnquiryType": 0,
  "ReferringSearchId": "ABC",
  "IsAppraisalRequested": false,
  "PropertyFilesUnlocked": false,
  "BuyingSituation": 0,
  "FinanceStatus": 0
}

Example XML Response (switch to JSON) 

<EmailResponse xmlns="http://api.trademe.co.nz/v1">
  <Success>false</Success>
  <Description>ABC</Description>
</EmailResponse>

Example JSON Response (switch to XML) 

{
  "Success": false,
  "Description": "ABC"
}