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

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

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.

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
}