Price Models

Each advertisement has a price model which determines the type of transaction the seller would like to perform. Model type must be specified for each price model. It should have one of the allowed values.

There are some price models which have required and optional fields. And there are price models without any additional fields. In the documentation below, if a field is not mentioned in a model specific field table then it is not allowed. Note that ‘modelType’ is mandatory for all price models (and not mentioned in a field tables.)

The following table lists the valid price model types and their descriptions.

Price model types Description
fixed Seller requests fixed price
bidding Seller requests bidding
to be discussed Price needs to be discussed between seller and buyer
by request Price is given on request
trade Item can be traded for another item
see description Information about price is available in the item description
buy it now Item can be bought directly from Marktplaats
reserved The item has been reserved

fixed

Seller requests fixed price.

field type constraints Req W U
askingPrice long non-negative yes yes yes
retailPrice long non-negative, only writeable with retail_price privilege no no no

askingPrice

The price in cents which seller asks for an item.

retailPrice

The retail price of the item in cents. Only writable and updateable when the client has outlet privilege.

...
"priceModel" : {
     "modelType" : "fixed",
     "askingPrice" : 1550
}
...

bidding

Seller requests bidding. Leave both minimalBid and askingPrice empty if you do not want to specify an asking price. but still allow bidding

field type constraints Req W U
minimalBid int non negative no yes yes
askingPrice int non negative no yes yes
retailPrice long non-negative, only writeable with retail_price privilege no no no

minimalBid

The minimum bid accepted by a seller. The minimal bid is set to the askingPrice if it is missing. If minimalBid is provided, it is also required to specify an askingPrice.

askingPrice

The asking price for an item. If askingPrice is not provided, the displayed price on the website will be ‘bieden’. If minimalBid is provided, it is also mandatory to provide an askingPrice.

retailPrice

The retail price of the item in cents. Only writable and updateable when the client has retail_price privilege.

...
"priceModel" : {
     "modelType" : "bidding",
     "minimalBid" : 2000,
     "askingPrice" : 5550,
     "retailPrice" : 6000
}
...

to be discussed

Price needs to be discussed between seller and buyer.

...
"priceModel" : {
     "modelType" : "to be discussed"
}
...

by request

Seller provides price by a request.

...
"priceModel" : {
     "modelType" : "by request"
}
...

trade

Item can be traded for another item.

...
"priceModel" : {
     "modelType" : "trade"
}
...

see description

Information about price is available in the item description

...
"priceModel" : {
     "modelType" : "see description"
}
...

buy it now

Item can be bought directly from Marktplaats. May only be used by selected sellers.

field type constraints Req W U
askingPrice long non-negative yes yes yes
shippingCosts long non-negative no yes yes
retailPrice long non-negative, only writeable with retail_price privilege no no no

askingPrice

The price in cents which seller asks for an item.

shippingCosts

The price in cents which seller asks for shipping an item.

retailPrice

The retail price of the item in cents. Only writable and updateable when the client has retail_price privilege.

...
"priceModel" : {
     "modelType" : "buy it now",
     "askingPrice" : 5550,
     "shippingCosts" : 695
}
...

reserved

The item has been reserved, meaning that in principle the item has been sold to a buyer.

...
"priceModel" : {
     "modelType" : "reserved"
}
...

Field errors

field error code error value description
priceModel.retailPrice input-invalid It is only allowed to set or update the retailPrice when the user has retail_price privileges.
priceModel.type input-invalid A required price model type is missing
priceModel.askingPrice input-not-allowed The asking price is not allowed for the selected model type
priceModel.minimalBid input-not-allowed The minimal bid is not allowed for the selected model type
priceModel.type input-not-allowed “buy it now” User is not allowed to use this model type
priceModel.shippingCosts input-too-low The specified shipping costs are too low
priceModel.askingPrice input-too-short The specified asking price is too short
priceModel.minimalBid input-too-short The specified asking price is too short
priceModel.type invalid-field-value “fixed|bidding|trade|see description|by request|to be discussed|buy it now|reserved” Model type doesn’t contain any of the allowed values
priceModel.askingPrice invalid-input The required asking price field is missing
priceModel.askingPrice invalid-input The required asking price field is missing
priceModel.minimalBid value-too-high The minimal bid is too high (it is higher then the asking price)