Website logo

Make a fixed price offer

Makes a fixed price offer for an auction to the specified members. The auction must have finished closing and must have been in the closed state for less than 45 days.

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

<FixedPriceOfferToMembersRequest>

ListingId Integer (required) ListingId
Price Number (required) Price
Duration Enumeration (required) Duration
None 0 None
One 1 One
Three 3 Three
Seven 7 Seven
Quantity Integer (optional) Quantity
MemberIds Collection of Integer (required) MemberIds

Returns

<FixedPriceOfferResponse>

Details on whether the operation was successful.

Success Boolean Success
Description String or null Description
Code Integer Code

This field is always zero. Do not use.

Example XML Request (switch to JSON)

<FixedPriceOfferToMembersRequest xmlns="http://api.trademe.co.nz/v1">
  <ListingId>123</ListingId>
  <Price>123.0</Price>
  <Duration>None</Duration>
  <Quantity>123</Quantity>
  <MemberIds>
    <MemberId>123</MemberId>
    <MemberId>123</MemberId>
  </MemberIds>
</FixedPriceOfferToMembersRequest>

Example JSON Request (switch to XML)

{
  "ListingId": 123,
  "Price": 123.0,
  "Duration": 0,
  "Quantity": 123,
  "MemberIds": [
    123,
    123
  ]
}

Example XML Response (switch to JSON)

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

Example JSON Response (switch to XML)

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