Function   /buyer/counteroffer/list

Function invocation

Function description

Returns the list of received counteroffers. The seller can propose a higher price to the buyer, and such proposition is called a counteroffer. Fuction retrieves counteroffer from seller to buyer (for buyer).

Input parameters

This function takes the following input parameters:

ParameterTypeRequiredDefault valueDescription
name string "" String to be searched in domain names
order string "name" List sorting (can be sorted by name, price, time, expires)
search_domain string "" Return received counteroffers for single domain (deprecated and unused, please use 'name' parameter)
size integer 5000 Page size
start integer 0 List start (for paging)

Return value

The list of received counteroffers (list of structures with the following fields):

Field nameTypeDescription
buyType string Selling document selected by the buyer (vat - invoice from, novat - invoice without vat from seller company, person - without document)
counterOfferId integer Counteroffer identifier
currency string Counteroffer currency
expires integer Counteroffer expiration time as a Unix timestamp
listingId integer Offer listing identifier
memberId string Buyer identifier
message string Message to the buyer
name string Domain name
nameIDN string Domain name (internationalized)
price float Counteroffer amount
sellerId string Seller identifier
status string Counteroffer status (one of offer, accept, buynow, reject, expire, paid, unpaid, withdraw, close)
time integer Offer time as a Unix timestamp
utfname string Domain name in unicode (deprecated, this value is given in 'nameIDN' field)