Website logo

Respond to a fixed price offer

Accepts or rejects a fixed price offer.

URL: https://api.trademe.co.nz/v1/FixedPriceOffers/Respond.{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

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

POST Data

<FixedPriceOfferRequest>

ListingId Integer (required) ListingId
Accept Boolean (required) Accept
ShippingOption Integer (optional) ShippingOption
Quantity Integer (optional) Quantity
FirearmsLicence String (optional) FirearmsLicence
FirearmsLicenceHolder <FirearmsLicenceHolderDetails> (optional) FirearmsLicenceHolder
FirstName String (required) FirstName
MiddleNames String (optional) MiddleNames
LastName String (required) LastName
ReturnListingDetails Boolean (optional) ReturnListingDetails
IsBuyerOlderThan18 Boolean (optional) IsBuyerOlderThan18

Returns

<FixedPriceOfferResponse>

Details on whether the operation was successful.

Success Boolean Success
Description String or null Description
PurchaseId Integer PurchaseId

Example XML Request (switch to JSON) 

<FixedPriceOfferRequest xmlns="http://api.trademe.co.nz/v1">
  <ListingId>123</ListingId>
  <Accept>false</Accept>
  <ShippingOption>123</ShippingOption>
  <Quantity>123</Quantity>
  <FirearmsLicence>ABC</FirearmsLicence>
  <FirearmsLicenceHolder>
    <FirstName>ABC</FirstName>
    <MiddleNames>ABC</MiddleNames>
    <LastName>ABC</LastName>
  </FirearmsLicenceHolder>
  <ReturnListingDetails>false</ReturnListingDetails>
  <IsBuyerOlderThan18>false</IsBuyerOlderThan18>
</FixedPriceOfferRequest>

Example JSON Request (switch to XML) 

{
  "ListingId": 123,
  "Accept": false,
  "ShippingOption": 123,
  "Quantity": 123,
  "FirearmsLicence": "ABC",
  "FirearmsLicenceHolder": {
    "FirstName": "ABC",
    "MiddleNames": "ABC",
    "LastName": "ABC"
  },
  "ReturnListingDetails": false,
  "IsBuyerOlderThan18": false
}

Example XML Response (switch to JSON) 

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

Example JSON Response (switch to XML) 

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