Function   /buyer/auction/past/list

Function invocation

Function description

Returns the list of auctions where the user was bidding or watching.

Input parameters

This function takes the following input parameters:

ParameterTypeRequiredDefault valueDescription
name string "" String to be searched in domain names
size integer 5000 Paging: number of list elements
start integer 0 Paging: starting list element
status string "all" Auction status (one of all, canceled, finished, waiting, paid, unpaid)
mystate integer 0 Select filter of auctions to show (0 - user was observer or bidder, 1 - user was observer, 2 - user was bidder, 3 - user was a bidder but not a winner, 4 - where user was winner)
order string "endtime" List sorting (can be sorted by name, bids, endtime, starttime, price, watches)

Return value

The list of auctions (list of structures with the following fields):

Field nameTypeDescription
auctionId integer Auction identifier
bids integer Number of bids in the auction
priceBuyNow float Auction Buy It Now price
cat1 string Auction category 1
cat2 string Auction category 2
cat3 string Domain category 3
cat4 string Domain category 4
cat5 string Domain category 5
cat6 string Domain category 6
cat7 string Domain category 7
cat8 string Domain category 8
cat9 string Domain category 9
currency string Auction currency
description string Auction description
endtime integer Auction end time as a Unix timestamp
featured boolean Auction is featured
homepage boolean Auction is promoted on homepage
memberId string Winning user identifer
name string Domain name (in Punycode)
nameIDN string Domain name (internationalized)
price float Actual auction price
private boolean Auction is private
promoted boolean Auction is promoted
reserveMet boolean Minimum price is met
priceMinimum float Auction minimum price
sellerId string Auction seller identifier
priceStart float Auction starting price
saleType string Possible selling document (vat - invoice with VAT only, novat - invoice with VAT or invoice without VAT, person - invoice with VAT or sale without document)
starttime integer Auction start time as a Unix timestamp
status string Auction status (one of active, canceled, finished, waiting, paid, unpaid)
views integer Number of auction views in past 30 days
visits integer Number of domain visits in past 30 days
watched integer Number of users who are watching the auction
catch boolean Auction of a caught domain