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 Long Integer (required)

The ID of the listing to make the offer on.

Price Number (required)

The price of the offer. Truncated to two decimal places.

Duration Enumeration (required)

The duration the offer is valid for (one, three or seven days).

None 0

Not valid.

One 1

One day.

Three 3

Three days.

Seven 7

Seven days.

Quantity Integer (optional)

The quantity of items available. Only applicable if the original listing was Buy Now only. The maximum is 1000.

MemberIds Collection of Integer (required)

The list of member IDs corresponding to the members to send the offer to.

Returns

<FixedPriceOfferResponse>

Details on whether the operation was successful.

Success Boolean

Indicates whether the operation was successful.

Description String or null

The description of the error, if the operation failed.

Code Integer

The result code of the offer response.

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
}