Website logo

Buy an auction using Buy Now

Buys an item using Buy Now.

URL: https://api.trademe.co.nz/v1/bidding/buynow.{file_format}
HTTP Method: POST
Requires Authentication? Yes
Permission Required: BiddingAndBuying: Place bids, and complete purchases using Buy Now & Fixed Price Offers.
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

<BuyNowRequest>

ListingId Integer (required) ListingId
ShippingOption Integer (required) 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
IsBuyerOlderThan18 Boolean (optional) IsBuyerOlderThan18
ReturnListingDetails Boolean (optional) ReturnListingDetails
ReferringSearchQueryId String (optional) ReferringSearchQueryId

Returns

<BuyNowResponse>

The details of the Buy Now request.

Success Boolean Success
Description String or null Description
StatusCode Enumeration StatusCode
Success 0 Success
None 1 None
ReserveMet 2 ReserveMet
ErrorAccountDisabled 3 ErrorAccountDisabled
ReserveNotMet 4 ReserveNotMet
ErrorBadMemberDetails 5 ErrorBadMemberDetails
ReserveMetAutoBidGreaterThanReserve 6 ReserveMetAutoBidGreaterThanReserve
ErrorHeavyQuarantine 7 ErrorHeavyQuarantine
ReserveMetAutoBidIncreased 8 ReserveMetAutoBidIncreased
ReserveNotMetAutoBid 9 ReserveNotMetAutoBid
ReserveMetExistingAutoBidGreaterThanBid 10 ReserveMetExistingAutoBidGreaterThanBid
ErrorOwnAuction 11 ErrorOwnAuction
ReserveNotMetExistingAutoBidGreaterThanBid 12 ReserveNotMetExistingAutoBidGreaterThanBid
ErrorBlacklisted 13 ErrorBlacklisted
ReserveMetExistingAutoBidEqualToBid 14 ReserveMetExistingAutoBidEqualToBid
ErrorAuthenticatedMembersOnlyAuction 15 ErrorAuthenticatedMembersOnlyAuction
ReserveNotMetExistingAutoBidEqualToBid 16 ReserveNotMetExistingAutoBidEqualToBid
ErrorAccountIndebt 17 ErrorAccountIndebt
ReserveMetAutoBid 18 ReserveMetAutoBid
ErrorBidTooHigh 19 ErrorBidTooHigh
ErrorBidLessThanMinimumNextBid 21 ErrorBidLessThanMinimumNextBid
ErrorBidLessThanFiftyCents 23 ErrorBidLessThanFiftyCents
ErrorBidLessThanStartPrice 25 ErrorBidLessThanStartPrice
ErrorTooManyBids 27 ErrorTooManyBids
ErrorHasTopAutoBid 29 ErrorHasTopAutoBid
ErrorAuctionClosed 30 ErrorAuctionClosed
ErrorDatabase 31 ErrorDatabase
ErrorListingAcceptsBuyNowOnly 34 ErrorListingAcceptsBuyNowOnly
ErrorQuantityInvalid 35 ErrorQuantityInvalid
ErrorListingIsAClassified 36 ErrorListingIsAClassified
ErrorInvalidShipping 37 ErrorInvalidShipping
ErrorInvalidFirearmsLicense 38 ErrorInvalidFirearmsLicense
ErrorAgeConfirmationRequired 39 ErrorAgeConfirmationRequired
ErrorListingAcceptsPayNowOnly 40 ErrorListingAcceptsPayNowOnly
ErrorBuyProcessBan 41 ErrorBuyProcessBan
AutoBidDecreased 42 AutoBidDecreased
PurchaseId Integer PurchaseId
Listing <ListedItemDetail> or null Listing
(This type is defined elsewhere)

Example XML Request (switch to JSON)

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

Example JSON Request (switch to XML)

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

Example XML Response (switch to JSON)

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

Example JSON Response (switch to XML)

{
  "Success": false,
  "Description": "ABC",
  "StatusCode": 0,
  "PurchaseId": 123,
  "Listing": { ... }
}