Basic information
GET /{shopId}/products/{productId}/lowest-price
Returns the lowest price of all variations of a product that can currently be purchased.
Returns 404 Not Found if the product does not have any variation with an independent price, e.g. if all variations share the same price. Also depends on the shop setting to display “from” prices.
Authorisation
OAuth 2.0 Token required with scopes:
products_read
URI parameters
| Name | Type | Description |
|---|---|---|
shopId |
string |
The unique identifier of the shop. Required:
true
Example:
DemoShop
|
productId |
string |
The unique identifier of the product. Required:
true
Example:
52F221E0-36F6-DC4E-384A-AC1504050C04
|
Query parameters
| Name | Type | Description |
|---|---|---|
locale |
string |
Represents the language code according to ISO 639-1 and the country code according to ISO 3166-1. If not provided, the shop’s default language is used. We recommend to always send this parameter with your request. If the default language had been changed in the administration, it might take up to 1 day until this change affects the shop. Required:
false
Example:
en_US
|
currency |
string |
Represents the currency code according to ISO 4217. Required:
false
Example:
EUR
|
Response attributes
| Name | Type | Description |
|---|---|---|
priceInfo |
object of simplePriceInfo |
Price information on the lowest price of the product variation. |
links |
array of link |
The link to the product variation with the lowest price. |
Response
HTTP 200
Media type application/json
{
"priceInfo": {
"price": {
"taxType": "GROSS",
"formatted": "149.99 €",
"amount": 149.99,
"currency": "EUR"
},
"quantity": {
"amount": 1,
"unit": "piece(s)"
}
},
"bulkPriceInfo": [
{
"quantity": {
"amount": 2,
"unit":"piece(s)"
},
"price": {
"taxType": "GROSS",
"formatted": "117.00 €",
"amount": 117,
"currency": "EUR"
},
"basePrice": null,
"priceSavings": {
"percent": {
"formatted": "10 %",
"percentage": 10.0
},
"regularBulkPrice": {
"taxType": "GROSS",
"formatted": "130.00 €",
"amount": 130,
"currency": "EUR"
}
}
},
{
"quantity": {
"amount": 1,
"unit":"piece(s)"
},
"price": {
"taxType": "GROSS",
"formatted": "135.00 €",
"amount": 135,
"currency": "EUR"
},
"basePrice": null,
"priceSavings": {
"percent": {
"formatted": "10 %",
"percentage": 10.0
},
"regularBulkPrice": {
"taxType": "GROSS",
"formatted": "150.00 €",
"amount": 150,
"currency": "EUR"
}
}
}
],
"customerSpecificPriceInfo": [
{
"customerGroup" : "KG1",
"customerGroupId": "63E4F781-CDA5-327F-B72B-C0A802027724",
"priceInfo": [
{
"quantity": {
"amount": 1,
"unit":"piece(s)"
},
"price": {
"taxType": "GROSS",
"formatted": "135.00 €",
"amount": 135,
"currency": "EUR"
},
"basePrice": null,
"priceSavings": {
"percent": {
"formatted": "10 %",
"percentage": 10.0
},
"regularBulkPrice": {
"taxType": "GROSS",
"formatted": "150.00 €",
"amount": 150,
"currency": "EUR"
}
}
},
{
"quantity": {
"amount": 5,
"unit": "piece(s)"
},
"price": {
"taxType": "GROSS",
"formatted": "120.00 €",
"amount": 120,
"currency": "EUR"
},
"basePrice": null,
"priceSavings": {
"percent": {
"formatted": "0 %",
"percentage": 0.0
},
"regularBulkPrice": {
"taxType": "GROSS",
"formatted": "120.00 €",
"amount": 120,
"currency": "EUR"
}
}
}
]
}
],
"links": [
{
"rel": "product",
"href": "https://pm.epages.com/rs/shops/apidocu/products/54EAF9A4-F2ED-BCBF-372B-0A0C05E6CF70"
}
]
}