Product Discounts

Product Discounts reduce certain Product Prices.

Product Discounts are useful for scenarios when you want to display a discounted price before adding an item to the Cart. A maximum of 500 Product Discounts can be active at the same time.

For an introduction to Product Discounts and to understand how they work in Composable Commerce, see the Product Discounts overview.

When you create, update, or delete a Product Discount, the Prices are updated in an eventually consistent manner. Both Embedded Prices and StandalonePrices associated to a ProductVariant are updated, regardless of the Product's priceMode value.

The time to update can vary—between a fraction of a second to several hours—depending on the following factors:

The number of Products and their size
The number of Products affected by Discount predicates
The number of Prices to be updated

Learn more about Product Discounts in our self-paced Product Discounts module.

Representations

ProductDiscount

ProductDiscountDraft

ProductDiscountPagedQueryResponse

ProductDiscountReference

ProductDiscountKeyReference

ProductDiscountResourceIdentifier

ProductDiscountValue -ProductDiscountValueRelative -ProductDiscountValueAbsolute -ProductDiscountValueExternal

ProductDiscountValueDraft -ProductDiscountValueRelativeDraft -ProductDiscountValueAbsoluteDraft -ProductDiscountValueExternalDraft

ProductDiscountMatchQuery -QueryPrice

ProductDiscount

`id` String	Unique identifier of the ProductDiscount.
`version` Int	Current version of the ProductDiscount.
`key` String	User-defined unique identifier of the ProductDiscount. MinLength: `2`MaxLength: `256`Pattern: `^[A-Za-z0-9_-]+$`
`name` LocalizedString	Name of the ProductDiscount.
`description` LocalizedString	Description of the ProductDiscount.
`value` ProductDiscountValue	Type of Discount and its corresponding value.
`predicate` String	Valid ProductDiscount predicate.
`sortOrder` String	Unique decimal value between 0 and 1 (stored as String literal) defining the order of Product Discounts to apply in case more than one is applicable and active. A Product Discount with a higher value is prioritized.
`isActive` Boolean	If `true` the Product Discount is applied to Products matching the `predicate`.
`references` Array of Reference	References of all the resources that are addressed in the `predicate`.
`validFrom` DateTime	Date and time (UTC) from which the Discount is effective. Take Eventual Consistency into account for calculated discount values.
`validUntil` DateTime	Date and time (UTC) until which the Discount is effective. Take Eventual Consistency into account for calculated undiscounted values.
`createdAt` DateTime	Date and time (UTC) the ProductDiscount was initially created.
`createdBy`BETA CreatedBy	IDs and references that created the ProductDiscount.
`lastModifiedAt` DateTime	Date and time (UTC) the ProductDiscount was last updated.
`lastModifiedBy`BETA LastModifiedBy	IDs and references that last modified the ProductDiscount.

Example: json

{
  "id": "{{product-discount-id}}",
  "version": 1,
  "key": "summer-sale",
  "name": {
    "en": "Summer Sale"
  },
  "description": {
    "en": "1€ off all products"
  },
  "value": {
    "type": "absolute",
    "money": [
      {
        "type": "centPrecision",
        "currencyCode": "EUR",
        "centAmount": 100,
        "fractionDigits": 2
      }
    ]
  },
  "predicate": "(product.id = \"{{product-id}}\" and variant.id = 1) or variant.key = \"{{product-variant-key}}\" or attributes.label = \"{{product-attribute-label}}\"",
  "sortOrder": "0.9534",
  "isActive": true,
  "references": [
    {
      "typeId": "product",
      "id": "{{product-id}}"
    }
  ],
  "createdAt": "2024-11-21T10:44:07.587Z",
  "lastModifiedAt": "2024-11-21T10:44:07.587Z",
  "lastModifiedBy": {
    "clientId": "{{client-id}}",
    "isPlatformClient": false
  },
  "createdBy": {
    "clientId": "{{client-id}}",
    "isPlatformClient": false
  }
}

ProductDiscountDraft

`key` String	User-defined unique identifier for the ProductDiscount. MinLength: `2`MaxLength: `256`Pattern: `^[A-Za-z0-9_-]+$`
`name` LocalizedString	Name of the ProductDiscount.
`description` LocalizedString	Description of the ProductDiscount.
`value` ProductDiscountValueDraft	Type of Discount and its corresponding value.
`predicate` String	Valid ProductDiscount predicate.
`sortOrder` String	Decimal value between 0 and 1 (passed as String literal) that defines the order of ProductDiscounts to apply in case more than one is applicable and active. A ProductDiscount with a higher `sortOrder` is prioritized. The value must be unique among all ProductDiscounts in the Project.
`isActive` Boolean	Set to `true` to activate the ProductDiscount, set to `false` to deactivate it (even though the `predicate` matches).
`validFrom` DateTime	Date and time (UTC) from which the Discount is effective. Take Eventual Consistency into account for calculated discount values.
`validUntil` DateTime	Date and time (UTC) until which the Discount is effective. Take Eventual Consistency into account for calculated undiscounted values.

Example: json

{
  "key": "summer-sale",
  "name": {
    "en": "Summer Sale"
  },
  "description": {
    "en": "1€ off all products"
  },
  "value": {
    "type": "absolute",
    "money": [
      {
        "currencyCode": "EUR",
        "centAmount": 100
      }
    ]
  },
  "predicate": "(product.id = \"{{product-id}}\" and variant.id = 1) or variant.key = \"{{product-variant-key}}\" or attributes.label = \"{{product-attribute-label}}\"",
  "sortOrder": "0.9534",
  "isActive": true
}

ProductDiscountPagedQueryResponse

PagedQueryResult with results containing an array of ProductDiscount.

`limit` Int	Number of results requested. Default: `20`Minimum: `0`Maximum: `500`
`offset` Int	Number of elements skipped. Default: `0`Maximum: `10000`
`count` Int	Actual number of results returned.
`total` Int	Total number of results matching the query. This number is an estimation that is not strongly consistent. This field is returned by default. For improved performance, calculating this field can be deactivated by using the query parameter `withTotal=false`. When the results are filtered with a Query Predicate, `total` is subject to a limit.
`results` Array of ProductDiscount	ProductDiscounts matching the query.

ProductDiscountReference

Reference to a ProductDiscount.

`id` String	Unique identifier of the referenced ProductDiscount.
`typeId` ReferenceTypeId	`product-discount` Type of referenced resource.
`obj` ProductDiscount	Contains the representation of the expanded ProductDiscount. Only present in responses to requests with Reference Expansion for ProductDiscounts.

ProductDiscountKeyReference

Used by the Import API to identify a ProductDiscount.

`key` String	User-defined unique identifier of the referenced ProductDiscount.
`typeId` ReferenceType	`product-discount` Type of referenced resource.

ProductDiscountResourceIdentifier

ResourceIdentifier to a ProductDiscount. Either id or key is required. If both are set, an InvalidJsonInput error is returned.

`id` String	Unique identifier of the referenced ProductDiscount. Required if `key` is absent.
`key` String	User-defined unique identifier of the referenced ProductDiscount. Required if `id` is absent.
`typeId` ReferenceTypeId	`product-discount` Type of referenced resource. If given, it must match the expected ReferenceTypeId of the referenced resource.

ProductDiscountValue

Abstract parent type for the specific values, distinguished by the type field - relative, absolute, or external.

ProductDiscountValueRelative

Discounts the product price by a percentage, defined by the permyriad field.

`type` String	`"relative"`
`permyriad` Int	Fraction (per ten thousand) the price is reduced by. For example, `1000` will result in a 10% price reduction.

Example: json

{
  "type": "relative",
  "permyriad": 1000
}

ProductDiscountValueAbsolute

Discounts the Product's Price by a fixed amount, defined by the money field.

`type` String	`"absolute"`
`money` Array of CentPrecisionMoney	Money values in different currencies. An absolute ProductDiscount will only match a price if this array contains a value with the same currency. For example, if it contains 10€ and 15$, the matching € price will be decreased by 10€ and the matching $ price will be decreased by 15$.

Example: json

{
  "type": "absolute",
  "money": [
    {
      "type": "centPrecision",
      "currencyCode": "EUR",
      "centAmount": 100,
      "fractionDigits": 2
    }
  ]
}

ProductDiscountValueExternal

Discounts the Product Price by allowing the client to explicitly set a discounted value. Used when setting discounts using an external service.

type

String

"external"

Example: json

{
  "type": "external"
}

ProductDiscountValueDraft

Abstract parent draft type for the specific value drafts, distinguished by the type field - relative, absolute, or external.

ProductDiscountValueRelativeDraft

Discounts the Product Price by a percentage, defined by the permyriad field.

`type` String	`"relative"`
`permyriad` Int	Fraction (per ten thousand) the price is reduced by. For example, `1000` will result in a 10% price reduction.

Example: json

{
  "type": "relative",
  "permyriad": 1000
}

ProductDiscountValueAbsoluteDraft

Discounts the Product Price by a fixed amount, defined by the money field.

type

String

"absolute"

money

Array of Money

Money values in different currencies. An absolute Product Discount will match a price only if the array contains a value with the same currency. For example, if it contains 10€ and 15$, the matching € price will be decreased by 10€ and the matching $ price will be decreased by 15$.

If the value exceeds the price of a Product Variant, the discounted price (of the Product Variant) will be a negative value.

If the array is empty or has multiple values of the same currency, the API returns an InvalidOperation error.

Example: json

{
  "type": "absolute",
  "money": [
    {
      "currencyCode": "EUR",
      "centAmount": 100
    }
  ]
}

ProductDiscountValueExternalDraft

Discounts the Product Price by allowing the client to explicitly set a discounted value. Use this when setting discounts using an external service.

type

String

"external"

Example: json

{
  "type": "external"
}

ProductDiscountMatchQuery

`productId` String	ID of the specified Product.
`variantId` Int	ID of the specified Product Variant.
`staged` Boolean	Controls which projected representation is applied for the query. Set to `true` for the `staged` Product Projection of the specified Product Variant, set to `false` for the `current` one.
`price` QueryPrice	Specified Price of the specified Product Variant.

Example: json

{
  "productId": "{{product-id}}",
  "variantId": 1,
  "staged": false,
  "price": {
    "id": "{{price-id}}",
    "value": {
      "currencyCode": "EUR",
      "centAmount": 10000
    },
    "country": "DE",
    "customerGroup": {
      "typeId": "customer-group",
      "id": "{{customer-group-id}}"
    },
    "tiers": [
      {
        "minimumQuantity": 10,
        "value": {
          "currencyCode": "EUR",
          "centAmount": 9000
        }
      }
    ]
  }
}

QueryPrice

`id` String	Unique identifier of the given Price.
`value` Money	Money value of the given Price.
`country` CountryCode	Country for which the given Price is valid. Pattern: `^[A-Z]{2}$`
`customerGroup` CustomerGroupReference	CustomerGroup for which the given Price is valid.
`channel` ChannelReference	`ProductDistribution` Channel for which the given Price is valid.
`validFrom` DateTime	Date from which the given Price is valid.
`validUntil` DateTime	Date until which the given Price is valid.
`discounted` DiscountedPriceDraft	DiscountedPrice you specify for the given Price.
`tiers` Array of PriceTierDraft	Price tier applied when the minimum quantity for the LineItem of a ProductVariant with the related Price is reached in a Cart. If `discounted` is specified, the tiered Price is ignored for a Product Variant.
`custom` CustomFields	Custom Fields for the Price.

Example: json

{
  "id": "{{price-id}}",
  "value": {
    "currencyCode": "EUR",
    "centAmount": 10000
  },
  "country": "DE",
  "customerGroup": {
    "typeId": "customer-group",
    "id": "{{customer-group-id}}"
  },
  "tiers": [
    {
      "minimumQuantity": 10,
      "value": {
        "currencyCode": "EUR",
        "centAmount": 9000
      }
    }
  ]
}

Get ProductDiscount

Get ProductDiscount by ID

GET

https://api.{region}.commercetools.com/{projectKey}/product-discounts/{id}

OAuth 2.0 Scopes:

view_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.
`id` String	`id` of the ProductDiscount.

Query parameters:

expand

Expansion

The parameter can be passed multiple times.

Response:

200

ProductDiscount

application/json

Request Example:cURL

curl --get https://api.{region}.commercetools.com/{projectKey}/product-discounts/{id} -i \
--header "Authorization: Bearer ${BEARER_TOKEN}"

200 Response Example: ProductDiscountjson

{
  "id": "{{product-discount-id}}",
  "version": 1,
  "key": "summer-sale",
  "name": {
    "en": "Summer Sale"
  },
  "description": {
    "en": "1€ off all products"
  },
  "value": {
    "type": "absolute",
    "money": [
      {
        "type": "centPrecision",
        "currencyCode": "EUR",
        "centAmount": 100,
        "fractionDigits": 2
      }
    ]
  },
  "predicate": "(product.id = \"{{product-id}}\" and variant.id = 1) or variant.key = \"{{product-variant-key}}\" or attributes.label = \"{{product-attribute-label}}\"",
  "sortOrder": "0.9534",
  "isActive": true,
  "references": [
    {
      "typeId": "product",
      "id": "{{product-id}}"
    }
  ],
  "createdAt": "2024-11-21T10:44:07.587Z",
  "lastModifiedAt": "2024-11-21T10:44:07.587Z",
  "lastModifiedBy": {
    "clientId": "{{client-id}}",
    "isPlatformClient": false
  },
  "createdBy": {
    "clientId": "{{client-id}}",
    "isPlatformClient": false
  }
}

Get ProductDiscount by Key

GET

https://api.{region}.commercetools.com/{projectKey}/product-discounts/key={key}

OAuth 2.0 Scopes:

view_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.
`key` String	`key` of the ProductDiscount.

Query parameters:

expand

Expansion

The parameter can be passed multiple times.

Response:

200

ProductDiscount

application/json

Request Example:cURL

curl --get https://api.{region}.commercetools.com/{projectKey}/product-discounts/key={key} -i \
--header "Authorization: Bearer ${BEARER_TOKEN}"

200 Response Example: ProductDiscountjson

{
  "id": "{{product-discount-id}}",
  "version": 1,
  "key": "summer-sale",
  "name": {
    "en": "Summer Sale"
  },
  "description": {
    "en": "1€ off all products"
  },
  "value": {
    "type": "absolute",
    "money": [
      {
        "type": "centPrecision",
        "currencyCode": "EUR",
        "centAmount": 100,
        "fractionDigits": 2
      }
    ]
  },
  "predicate": "(product.id = \"{{product-id}}\" and variant.id = 1) or variant.key = \"{{product-variant-key}}\" or attributes.label = \"{{product-attribute-label}}\"",
  "sortOrder": "0.9534",
  "isActive": true,
  "references": [
    {
      "typeId": "product",
      "id": "{{product-id}}"
    }
  ],
  "createdAt": "2024-11-21T10:44:07.587Z",
  "lastModifiedAt": "2024-11-21T10:44:07.587Z",
  "lastModifiedBy": {
    "clientId": "{{client-id}}",
    "isPlatformClient": false
  },
  "createdBy": {
    "clientId": "{{client-id}}",
    "isPlatformClient": false
  }
}

Query ProductDiscounts

GET

https://api.{region}.commercetools.com/{projectKey}/product-discounts

OAuth 2.0 Scopes:

view_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.

Query parameters:

`where` QueryPredicate	The parameter can be passed multiple times.
`sort` Sort	The parameter can be passed multiple times.
`expand` Expansion	The parameter can be passed multiple times.
`limit` Int	Number of results requested. Default: `20` Minimum: `0` Maximum: `500`
`offset` Int	Number of elements skipped. Default: `0` Maximum: `10000`
`withTotal` Boolean	Controls the calculation of the total number of query results. Set to `false` to improve query performance when the `total` is not needed. Default: `true`
`var.<varName>` String	Predicate parameter values. The parameter can be passed multiple times.

Response:

200

ProductDiscountPagedQueryResponse

application/json

Request Example:cURL

curl --get https://api.{region}.commercetools.com/{projectKey}/product-discounts -i \
--header "Authorization: Bearer ${BEARER_TOKEN}"

200 Response Example: ProductDiscountPagedQueryResponsejson

{
  "limit": 20,
  "offset": 0,
  "count": 1,
  "total": 1,
  "results": [
    {
      "id": "{{product-discount-id}}",
      "version": 1,
      "key": "summer-sale",
      "name": {
        "en": "Summer Sale"
      },
      "description": {
        "en": "1€ off all products"
      },
      "value": {
        "type": "absolute",
        "money": [
          {
            "type": "centPrecision",
            "currencyCode": "EUR",
            "centAmount": 100,
            "fractionDigits": 2
          }
        ]
      },
      "predicate": "(product.id = \"{{product-id}}\" and variant.id = 1) or variant.key = \"{{product-variant-key}}\"",
      "sortOrder": "0.9534",
      "isActive": true,
      "references": [
        {
          "typeId": "product",
          "id": "464af704-78f7-4d39-9a1c-d00a6f3234b3"
        }
      ],
      "createdAt": "2024-11-21T10:44:07.587Z",
      "lastModifiedAt": "2024-11-21T10:44:07.587Z",
      "lastModifiedBy": {
        "clientId": "{{client-id}}",
        "isPlatformClient": false
      },
      "createdBy": {
        "clientId": "{{client-id}}",
        "isPlatformClient": false
      }
    }
  ]
}

Check if ProductDiscount exists

Check if ProductDiscount exists by ID

HEAD

https://api.{region}.commercetools.com/{projectKey}/product-discounts/{id}

Checks if a ProductDiscount exists with the provided id. Returns a 200 status if the ProductDiscount exists, or a 404 status otherwise.

OAuth 2.0 Scopes:

view_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.
`id` String	`id` of the ProductDiscount.

Response:

200

Request Example:cURL

curl --head https://api.{region}.commercetools.com/{projectKey}/product-discounts/{id} -i \
--header "Authorization: Bearer ${BEARER_TOKEN}"

Check if ProductDiscount exists by Key

HEAD

https://api.{region}.commercetools.com/{projectKey}/product-discounts/key={key}

Checks if a ProductDiscount exists with the provided key. Returns a 200 status if the ProductDiscount exists, or a 404 status otherwise.

OAuth 2.0 Scopes:

view_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.
`key` String	`key` of the ProductDiscount.

Response:

200

Request Example:cURL

curl --head https://api.{region}.commercetools.com/{projectKey}/product-discounts/key={key} -i \
--header "Authorization: Bearer ${BEARER_TOKEN}"

Check if ProductDiscount exists by Query Predicate

HEAD

https://api.{region}.commercetools.com/{projectKey}/product-discounts

Checks if one or more ProductDiscounts exist for the provided query predicate. Returns a 200 status if any ProductDiscounts match the query predicate, or a 404 status otherwise.

OAuth 2.0 Scopes:

view_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.

Query parameters:

where

QueryPredicate

The parameter can be passed multiple times.

Response:

200

Request Example:cURL

curl --head https://api.{region}.commercetools.com/{projectKey}/product-discounts -i \
--header "Authorization: Bearer ${BEARER_TOKEN}"

Create ProductDiscount

POST

https://api.{region}.commercetools.com/{projectKey}/product-discounts

OAuth 2.0 Scopes:

manage_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.

Query parameters:

expand

Expansion

The parameter can be passed multiple times.

Request Body:ProductDiscountDraftasapplication/json

Response:

201

ProductDiscount

application/json

Request Example:cURL

curl https://api.{region}.commercetools.com/{projectKey}/product-discounts -i \
--header "Authorization: Bearer ${BEARER_TOKEN}" \
--header 'Content-Type: application/json' \
--data-binary @- << DATA 
{
  "key" : "summer-sale",
  "name" : {
    "en" : "Summer Sale"
  },
  "description" : {
    "en" : "1€ off all products"
  },
  "value" : {
    "type" : "absolute",
    "money" : [ {
      "currencyCode" : "EUR",
      "centAmount" : 100
    } ]
  },
  "predicate" : "(product.id = "{{product-id}}" and variant.id = 1) or variant.key = "{{product-variant-key}}" or attributes.label = "{{product-attribute-label}}"",
  "sortOrder" : "0.9534",
  "isActive" : true
}
DATA

201 Response Example: ProductDiscountjson

{
  "id": "{{product-discount-id}}",
  "version": 1,
  "key": "summer-sale",
  "name": {
    "en": "Summer Sale"
  },
  "description": {
    "en": "1€ off all products"
  },
  "value": {
    "type": "absolute",
    "money": [
      {
        "type": "centPrecision",
        "currencyCode": "EUR",
        "centAmount": 100,
        "fractionDigits": 2
      }
    ]
  },
  "predicate": "(product.id = \"{{product-id}}\" and variant.id = 1) or variant.key = \"{{product-variant-key}}\" or attributes.label = \"{{product-attribute-label}}\"",
  "sortOrder": "0.9534",
  "isActive": true,
  "references": [
    {
      "typeId": "product",
      "id": "{{product-id}}"
    }
  ],
  "createdAt": "2024-11-21T10:44:07.587Z",
  "lastModifiedAt": "2024-11-21T10:44:07.587Z",
  "lastModifiedBy": {
    "clientId": "{{client-id}}",
    "isPlatformClient": false
  },
  "createdBy": {
    "clientId": "{{client-id}}",
    "isPlatformClient": false
  }
}

Update ProductDiscount

Update ProductDiscount by ID

POST

https://api.{region}.commercetools.com/{projectKey}/product-discounts/{id}

OAuth 2.0 Scopes:

manage_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.
`id` String	`id` of the ProductDiscount.

Query parameters:

expand

Expansion

The parameter can be passed multiple times.

Request Body:

application/json

`version` Int	Expected version of the ProductDiscount on which the changes should be applied. If the expected version does not match the actual version, a ConcurrentModification error will be returned.
`actions` Array of ProductDiscountUpdateAction	Update actions to be performed on the ProductDiscount.

Response:

200

ProductDiscount

application/json

Request Example:cURL

curl https://api.{region}.commercetools.com/{projectKey}/product-discounts/{id} -i \
--header "Authorization: Bearer ${BEARER_TOKEN}" \
--header 'Content-Type: application/json' \
--data-binary @- << DATA 
{
  "version" : 1,
  "actions" : [ {
    "action" : "changeValue",
    "value" : {
      "type" : "absolute",
      "money" : [ {
        "currencyCode" : "EUR",
        "centAmount" : 200
      } ]
    }
  } ]
}
DATA

200 Response Example: ProductDiscountjson

{
  "id": "{{product-discount-id}}",
  "version": 2,
  "key": "summer-sale",
  "name": {
    "en": "Summer Sale"
  },
  "description": {
    "en": "1€ off all products"
  },
  "value": {
    "type": "absolute",
    "money": [
      {
        "type": "centPrecision",
        "currencyCode": "EUR",
        "centAmount": 200,
        "fractionDigits": 2
      }
    ]
  },
  "predicate": "(product.id = \"{{product-id}}\" and variant.id = 1) or variant.key = \"{{product-variant-key}}\"",
  "sortOrder": "0.9534",
  "isActive": true,
  "references": [
    {
      "typeId": "product",
      "id": "464af704-78f7-4d39-9a1c-d00a6f3234b3"
    }
  ],
  "createdAt": "2024-11-21T10:44:07.587Z",
  "lastModifiedAt": "2024-12-21T10:44:07.587Z",
  "lastModifiedBy": {
    "clientId": "{{client-id}}",
    "isPlatformClient": false
  },
  "createdBy": {
    "clientId": "{{client-id}}",
    "isPlatformClient": false
  }
}

Update ProductDiscount by Key

POST

https://api.{region}.commercetools.com/{projectKey}/product-discounts/key={key}

OAuth 2.0 Scopes:

manage_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.
`key` String	`key` of the ProductDiscount.

Query parameters:

expand

Expansion

The parameter can be passed multiple times.

Request Body:

application/json

`version` Int	Expected version of the ProductDiscount on which the changes should be applied. If the expected version does not match the actual version, a ConcurrentModification error will be returned.
`actions` Array of ProductDiscountUpdateAction	Update actions to be performed on the ProductDiscount.

Response:

200

ProductDiscount

application/json

Request Example:cURL

curl https://api.{region}.commercetools.com/{projectKey}/product-discounts/key={key} -i \
--header "Authorization: Bearer ${BEARER_TOKEN}" \
--header 'Content-Type: application/json' \
--data-binary @- << DATA 
{
  "version" : 1,
  "actions" : [ {
    "action" : "changeValue",
    "value" : {
      "type" : "absolute",
      "money" : [ {
        "currencyCode" : "EUR",
        "centAmount" : 200
      } ]
    }
  } ]
}
DATA

200 Response Example: ProductDiscountjson

{
  "id": "{{product-discount-id}}",
  "version": 2,
  "key": "summer-sale",
  "name": {
    "en": "Summer Sale"
  },
  "description": {
    "en": "1€ off all products"
  },
  "value": {
    "type": "absolute",
    "money": [
      {
        "type": "centPrecision",
        "currencyCode": "EUR",
        "centAmount": 200,
        "fractionDigits": 2
      }
    ]
  },
  "predicate": "(product.id = \"{{product-id}}\" and variant.id = 1) or variant.key = \"{{product-variant-key}}\"",
  "sortOrder": "0.9534",
  "isActive": true,
  "references": [
    {
      "typeId": "product",
      "id": "464af704-78f7-4d39-9a1c-d00a6f3234b3"
    }
  ],
  "createdAt": "2024-11-21T10:44:07.587Z",
  "lastModifiedAt": "2024-12-21T10:44:07.587Z",
  "lastModifiedBy": {
    "clientId": "{{client-id}}",
    "isPlatformClient": false
  },
  "createdBy": {
    "clientId": "{{client-id}}",
    "isPlatformClient": false
  }
}

Update actions

Set Valid From and Until

Change Name

Set Description

Change Sort Order

Set Key

`action` String	`"setKey"`
`key` String	Value to set. If empty, any existing value will be removed. MinLength: `2`MaxLength: `256`Pattern: `^[A-Za-z0-9_-]+$`

Example: json

{
  "action": "setKey",
  "key": "new-key"
}

Change Value

`action` String	`"changeValue"`
`value` ProductDiscountValueDraft	New value to set. Must not be empty.

Example: json

{
  "action": "changeValue",
  "value": {
    "type": "relative",
    "permyriad": 2000
  }
}

Change Predicate

`action` String	`"changePredicate"`
`predicate` String	New value to set. Must be a valid ProductDiscount predicate.

Example: json

{
  "action": "changePredicate",
  "predicate": "product.id = \"{{product-id}}\""
}

Change Is Active

`action` String	`"changeIsActive"`
`isActive` Boolean	New value to set. If set to `true`, the Discount will be applied to Product Prices.

Example: json

{
  "action": "changeIsActive",
  "isActive": false
}

Set Valid From

`action` String	`"setValidFrom"`
`validFrom` DateTime	Value to set. If empty, any existing value will be removed. Take Eventual Consistency into account for calculated discount values.

Example: json

{
  "action": "setValidFrom",
  "validFrom": "2025-10-12T14:05:00.000Z"
}

Set Valid Until

`action` String	`"setValidUntil"`
`validUntil` DateTime	Value to set. If empty, any existing value will be removed. Take Eventual Consistency into account for calculated undiscounted values.

Example: json

{
  "action": "setValidUntil",
  "validUntil": "2025-11-12T14:05:00.000Z"
}

Set Valid From and Until

`action` String	`"setValidFromAndUntil"`
`validFrom` DateTime	Value to set. Take Eventual Consistency into account for calculated undiscounted values.
`validUntil` DateTime	Value to set. Take Eventual Consistency into account for calculated undiscounted values.

Example: json

{
  "action": "setValidFromAndUntil",
  "validFrom": "2025-10-12T14:00:00.000Z",
  "validUntil": "2025-11-12T14:05:00.000Z"
}

Change Name

`action` String	`"changeName"`
`name` LocalizedString	New value to set. Must not be empty.

Example: json

{
  "action": "changeName",
  "name": {
    "de": "Neuer Rabatt",
    "en": "New discount"
  }
}

Set Description

`action` String	`"setDescription"`
`description` LocalizedString	Value to set. If empty, any existing value will be removed.

Example: json

{
  "action": "setDescription",
  "description": {
    "de": "Neue Beschreibung",
    "en": "New description"
  }
}

Change Sort Order

`action` String	`"changeSortOrder"`
`sortOrder` String	New value to set. Must not be empty. The string value must be a number between `0` and `1`. A Discount with a higher sortOrder is prioritized.

Example: json

{
  "action": "changeSortOrder",
  "sortOrder": "0.3"
}

Delete ProductDiscount

Delete ProductDiscount by ID

DELETE

https://api.{region}.commercetools.com/{projectKey}/product-discounts/{id}

OAuth 2.0 Scopes:

manage_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.
`id` String	`id` of the ProductDiscount.

Query parameters:

`version` Int	Last seen version of the resource.
`expand` Expansion	The parameter can be passed multiple times.

Response:

200

ProductDiscount

application/json

Request Example:cURL

curl -X DELETE https://api.{region}.commercetools.com/{projectKey}/product-discounts/{id}?version={version} -i \
--header "Authorization: Bearer ${BEARER_TOKEN}"

200 Response Example: ProductDiscountjson

{
  "id": "{{product-discount-id}}",
  "version": 1,
  "key": "summer-sale",
  "name": {
    "en": "Summer Sale"
  },
  "description": {
    "en": "1€ off all products"
  },
  "value": {
    "type": "absolute",
    "money": [
      {
        "type": "centPrecision",
        "currencyCode": "EUR",
        "centAmount": 100,
        "fractionDigits": 2
      }
    ]
  },
  "predicate": "(product.id = \"{{product-id}}\" and variant.id = 1) or variant.key = \"{{product-variant-key}}\" or attributes.label = \"{{product-attribute-label}}\"",
  "sortOrder": "0.9534",
  "isActive": true,
  "references": [
    {
      "typeId": "product",
      "id": "{{product-id}}"
    }
  ],
  "createdAt": "2024-11-21T10:44:07.587Z",
  "lastModifiedAt": "2024-11-21T10:44:07.587Z",
  "lastModifiedBy": {
    "clientId": "{{client-id}}",
    "isPlatformClient": false
  },
  "createdBy": {
    "clientId": "{{client-id}}",
    "isPlatformClient": false
  }
}

Delete ProductDiscount by Key

DELETE

https://api.{region}.commercetools.com/{projectKey}/product-discounts/key={key}

OAuth 2.0 Scopes:

manage_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.
`key` String	`key` of the ProductDiscount.

Query parameters:

`version` Int	Last seen version of the resource.
`expand` Expansion	The parameter can be passed multiple times.

Response:

200

ProductDiscount

application/json

Request Example:cURL

curl -X DELETE https://api.{region}.commercetools.com/{projectKey}/product-discounts/key={key}?version={version} -i \
--header "Authorization: Bearer ${BEARER_TOKEN}"

200 Response Example: ProductDiscountjson

{
  "id": "{{product-discount-id}}",
  "version": 1,
  "key": "summer-sale",
  "name": {
    "en": "Summer Sale"
  },
  "description": {
    "en": "1€ off all products"
  },
  "value": {
    "type": "absolute",
    "money": [
      {
        "type": "centPrecision",
        "currencyCode": "EUR",
        "centAmount": 100,
        "fractionDigits": 2
      }
    ]
  },
  "predicate": "(product.id = \"{{product-id}}\" and variant.id = 1) or variant.key = \"{{product-variant-key}}\" or attributes.label = \"{{product-attribute-label}}\"",
  "sortOrder": "0.9534",
  "isActive": true,
  "references": [
    {
      "typeId": "product",
      "id": "{{product-id}}"
    }
  ],
  "createdAt": "2024-11-21T10:44:07.587Z",
  "lastModifiedAt": "2024-11-21T10:44:07.587Z",
  "lastModifiedBy": {
    "clientId": "{{client-id}}",
    "isPlatformClient": false
  },
  "createdBy": {
    "clientId": "{{client-id}}",
    "isPlatformClient": false
  }
}

Get Matching ProductDiscount

POST

https://api.{region}.commercetools.com/{projectKey}/product-discounts/matching

This endpoint can be used to simulate which Product Discounts would be applied if a specified Product Variant had a specified Price. Given Product and Product Variant IDs and a Price, this endpoint will return the ProductDiscount that would have been applied to that Price.

If a Product Discount could not be found that could be applied to the Price of a Product Variant, a NoMatchingProductDiscountFound error is returned.

OAuth 2.0 Scopes:

view_products:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	`key` of the Project.

Request Body:ProductDiscountMatchQueryasapplication/json

Response:

200

ProductDiscount

application/json

Request Example:cURL

curl https://api.{region}.commercetools.com/{projectKey}/product-discounts/matching -i \
--header "Authorization: Bearer ${BEARER_TOKEN}" \
--header 'Content-Type: application/json' \
--data-binary @- << DATA 
{
  "productId" : "{{product-id}}",
  "variantId" : 1,
  "staged" : false,
  "price" : {
    "id" : "{{price-id}}",
    "value" : {
      "currencyCode" : "EUR",
      "centAmount" : 10000
    },
    "country" : "DE",
    "customerGroup" : {
      "typeId" : "customer-group",
      "id" : "{{customer-group-id}}"
    },
    "tiers" : [ {
      "minimumQuantity" : 10,
      "value" : {
        "currencyCode" : "EUR",
        "centAmount" : 9000
      }
    } ]
  }
}
DATA

200 Response Example: ProductDiscountjson

{
  "id": "{{product-discount-id}}",
  "version": 1,
  "key": "summer-sale",
  "name": {
    "en": "Summer Sale"
  },
  "description": {
    "en": "1€ off all products"
  },
  "value": {
    "type": "absolute",
    "money": [
      {
        "type": "centPrecision",
        "currencyCode": "EUR",
        "centAmount": 100,
        "fractionDigits": 2
      }
    ]
  },
  "predicate": "(product.id = \"{{product-id}}\" and variant.id = 1) or variant.key = \"{{product-variant-key}}\" or attributes.label = \"{{product-attribute-label}}\"",
  "sortOrder": "0.9534",
  "isActive": true,
  "references": [
    {
      "typeId": "product",
      "id": "{{product-id}}"
    }
  ],
  "createdAt": "2024-11-21T10:44:07.587Z",
  "lastModifiedAt": "2024-11-21T10:44:07.587Z",
  "lastModifiedBy": {
    "clientId": "{{client-id}}",
    "isPlatformClient": false
  },
  "createdBy": {
    "clientId": "{{client-id}}",
    "isPlatformClient": false
  }
}

Product Discounts

Representations.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ProductDiscount.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ProductDiscountDraft.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ProductDiscountPagedQueryResponse.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ProductDiscountReference.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ProductDiscountKeyReference.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ProductDiscountResourceIdentifier.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ProductDiscountValue.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ProductDiscountValueRelative.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ProductDiscountValueAbsolute.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ProductDiscountValueExternal.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ProductDiscountValueDraft.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ProductDiscountValueRelativeDraft.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ProductDiscountValueAbsoluteDraft.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ProductDiscountValueExternalDraft.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ProductDiscountMatchQuery.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

QueryPrice.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Get ProductDiscount.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Get ProductDiscount by ID.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Get ProductDiscount by Key.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Query ProductDiscounts.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Check if ProductDiscount exists.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Check if ProductDiscount exists by ID.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Check if ProductDiscount exists by Key.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Check if ProductDiscount exists by Query Predicate.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Create ProductDiscount.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Update ProductDiscount.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Update ProductDiscount by ID.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Update ProductDiscount by Key.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Update actions.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Set Key.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Change Value.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Change Predicate.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Change Is Active.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Set Valid From.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Set Valid Until.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Set Valid From and Until.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Change Name.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Set Description.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Change Sort Order.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Delete ProductDiscount.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Delete ProductDiscount by ID.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Delete ProductDiscount by Key.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Get Matching ProductDiscount.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Representations

ProductDiscount

ProductDiscountDraft

ProductDiscountPagedQueryResponse

ProductDiscountReference

ProductDiscountKeyReference

ProductDiscountResourceIdentifier

ProductDiscountValue

ProductDiscountValueRelative

ProductDiscountValueAbsolute

ProductDiscountValueExternal

ProductDiscountValueDraft

ProductDiscountValueRelativeDraft

ProductDiscountValueAbsoluteDraft

ProductDiscountValueExternalDraft

ProductDiscountMatchQuery

QueryPrice

Get ProductDiscount

Get ProductDiscount by ID

Get ProductDiscount by Key

Query ProductDiscounts

Check if ProductDiscount exists

Check if ProductDiscount exists by ID

Check if ProductDiscount exists by Key

Check if ProductDiscount exists by Query Predicate

Create ProductDiscount

Update ProductDiscount

Update ProductDiscount by ID

Update ProductDiscount by Key

Update actions

Set Key

Change Value

Change Predicate

Change Is Active

Set Valid From

Set Valid Until

Set Valid From and Until

Change Name

Set Description

Change Sort Order

Delete ProductDiscount

Delete ProductDiscount by ID

Delete ProductDiscount by Key

Get Matching ProductDiscount