• Home >
• API Reference >
• Bidding and Buying Methods >
• Place a bid

Place a bid

Place a bid (normal or auto-bid) on a listing.

URL parameters

POST Data

<BidRequest>

Returns

<AuctionBidResponse>

The details of the bid.

<BidRequest xmlns="http://api.trademe.co.nz/v1">
  <ListingId>123</ListingId>
  <Amount>123.0</Amount>
  <AutoBid>false</AutoBid>
  <ShippingOption>123</ShippingOption>
  <EmailOutBid>false</EmailOutBid>
  <FirearmsLicence>ABC</FirearmsLicence>
  <FirearmsLicenceHolder>
    <FirstName>ABC</FirstName>
    <MiddleNames>ABC</MiddleNames>
    <LastName>ABC</LastName>
  </FirearmsLicenceHolder>
  <IsBuyerOlderThan18>false</IsBuyerOlderThan18>
  <ReturnListingDetails>false</ReturnListingDetails>
  <ReferringSearchQueryId>ABC</ReferringSearchQueryId>
</BidRequest>

{
  "ListingId": 123,
  "Amount": 123.0,
  "AutoBid": false,
  "ShippingOption": 123,
  "EmailOutBid": false,
  "FirearmsLicence": "ABC",
  "FirearmsLicenceHolder": {
    "FirstName": "ABC",
    "MiddleNames": "ABC",
    "LastName": "ABC"
  },
  "IsBuyerOlderThan18": false,
  "ReturnListingDetails": false,
  "ReferringSearchQueryId": "ABC"
}

<AuctionBidResponse xmlns="http://api.trademe.co.nz/v1">
  <Success>false</Success>
  <Description>ABC</Description>
  <IsTooHigh>false</IsTooHigh>
  <IsTooLow>false</IsTooLow>
  <IsReserveMet>false</IsReserveMet>
  <MinimumNextBid>123.0</MinimumNextBid>
  <StatusCode>Success</StatusCode>
  <Listing> ... </Listing>
  <CurrentAutoBid>123.0</CurrentAutoBid>
</AuctionBidResponse>

{
  "Success": false,
  "Description": "ABC",
  "IsTooHigh": false,
  "IsTooLow": false,
  "IsReserveMet": false,
  "MinimumNextBid": 123.0,
  "StatusCode": 0,
  "Listing": { ... },
  "CurrentAutoBid": 123.0
}