v1

latestOpenAPI 3.0.02026-07-2475182625.5 KB
Products

Retrieve a product price

Retrieves prices for a specific product with the given product_path, including product discount details.

get/products/price/{product_path}

Path parameters

product_pathstring required

Unique identifier to reference a specific product, also known as the product path ID.

Query parameters

countrystring
Example:US

The country for which the product price is being requested. This helps filter pricing based on the country's specific pricing rules or regional offers (e.g., "US", "DE").

currencystring
Example:USD

The currency in which the product price should be displayed. This allows the system to return the price in a specific currency (e.g., "USD", "EUR").

Response

OK

pageinteger

The current page number of results.

limitinteger

The number of items per page.

Example response

{
  "page": 1,
  "limit": 50,
  "products": [
    {
      "action": "product.price.get",
      "result": "success",
      "product": "basic-laptop",
      "pricing": {
        "US": {
          "currency": "USD",
          "price": 600,
          "display": "$600.00",
          "quantityDiscount": {
            "5": {
              "discountPercent": 10,
              "discountValue": 60,
              "discountValueDisplay": "$60.00",
              "unitPrice": 540,
              "unitPriceDisplay": "$540.00"
            }
          },
          "discountReason": {
            "en": "New customer"
          },
          "discountPeriodCount": 3,
          "available": {
            "start": "2025-01-01",
            "end": "2025-12-31"
          },
          "setupFeePrice": 100,
          "setupFeePriceDisplay": "$100.00",
          "setupFeeReason": {
            "en": "One-time Setup Fee"
          }
        }
      }
    }
  ]
}