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.)

Deprecation Warning: Some of these price models have now been deprecated (see below) and are due to be removed on or after April 17th 2025. At that time, all existing advertisements using the removed price models will be automatically converted to see description. Attempts to place new advertisements with the removed price models will fail with a validation-failure, error code invalid-field-value. See Field Errors.

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
see description	Information about price is available in the item description

fixed

Seller requests fixed price.

field	type	constraints	default	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	default	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
}
...

see description

Information about price is available in the item description

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

Field errors

field	error code	error value	description
priceModel.modelType	input-invalid		A required price model type is missing
priceModel.retailPrice	input-invalid		It is only allowed to set or update the retailPrice when the user has retail_price privileges.
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.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.modelType	invalid-field-value	“fixed|bidding|see description”	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)