Function /buyer/auction/past/list
Function invocation
https://json.aftermarket.pl/buyer/auction/past/list
Function description
Returns the list of auctions where the user was bidding or watching.
Input parameters
This function takes the following input parameters:
| Parameter | Type | Required | Default value | Description |
|---|---|---|---|---|
| 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) | |
| future | integer | 0 | Auctions of options (0 - all, 1 - only options auctions, 2 - without options auctions) |
Return value
The list of auctions (list of structures with the following fields):
| Field name | Type | Description |
|---|---|---|
| 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) |
| future | boolean | Auction of option |
| 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 |