This is the early access documentation preview for Custom Views. This documentation might not be in sync with our official documentation.

Standalone Prices

A Standalone Price assigns a Price to a Product Variant for a given scope.

The Standalone Prices API provides an alternative way to store your product prices as standalone resources. In comparison to Prices embedded inside the Product, this approach allows going beyond the limit of 100 prices per ProductVariant. It also brings a more flexible way to query and manage your Prices, separately from your Products, which contributes to better query performance.

The differences between the two approaches are explained below:

To specify where the Prices of a particular Product are located, you need to set the ProductPriceMode accordingly. You can set the priceMode field on the ProductDraft when creating a Product or afterwards by the Set PriceMode update action. When priceMode is not set, the API treats the Product as having the Embedded ProductPriceMode.

A Product can have Embedded Prices as well as Standalone Prices at the same time, but the priceMode on a Product determines which Price the API uses for LineItem Price selection and Product Price selection.

Learn more about Standalone Prices in our self-paced Pricing setup module.

Representations

StandalonePrice

id
String

Unique identifier of the StandalonePrice.

version
Int

Current version of the StandalonePrice.

key
String

User-defined unique identifier of the StandalonePrice.

MinLength: 2MaxLength: 256Pattern: ^[A-Za-z0-9_-]+$
sku
String

SKU of the ProductVariant to which this Price is associated.

value

Money value of this Price.

country

Country for which this Price is valid.

Pattern: ^[A-Z]{2}$
customerGroup

CustomerGroup for which this Price is valid.

channel

Product distribution Channel for which this Price is valid.

validFrom

Date from which the Price is valid.

validUntil

Date until the Price is valid. Standalone Prices that are no longer valid are not automatically deleted, but they can be deleted if necessary.

tiers
Array of PriceTier

Price tiers if any are defined.

If discounted is present, the tiered Price is ignored for a Product Variant.

discounted

Set if a matching ProductDiscount exists. If set, the API uses the discounted value for the LineItem Price selection. When a relative discount is applied and the fraction part of the discounted price is 0.5, the discounted price is rounded in favor of the customer with the half down rounding.

Staged changes of the StandalonePrice. Only present if the StandalonePrice has some changes staged.

active
Boolean

If set to true, the StandalonePrice is considered during price selection. If set to false, the StandalonePrice is not considered during price selection.

Default: true
custom

Custom Fields for the StandalonePrice.

createdAt

Date and time (UTC) the StandalonePrice was initially created.

createdByBETA

Present on resources created after 1 February 2019 except for events not tracked.

lastModifiedAt

Date and time (UTC) the StandalonePrice was last updated.

lastModifiedByBETA

Present on resources created after 1 February 2019 except for events not tracked.

StandalonePriceDraft

Standalone Prices are defined with a scope consisting of currency and optionally country, customerGroup, and channel and/or a validity period (validFrom and/or validTo). For more information see price selection.

Creating a Standalone Price for an SKU which has a Standalone Price with exactly the same price scope, or with overlapping validity periods within the same price scope returns the DuplicateStandalonePriceScope and OverlappingStandalonePriceValidity errors, respectively. A Price without validity period does not conflict with a Price defined for a time period.

key
String

User-defined unique identifier for the StandalonePrice.

MinLength: 2MaxLength: 256Pattern: ^[A-Za-z0-9_-]+$
sku
String

Specifies to which ProductVariant the API associates this Price. It is not validated to exist in product variants.

value

Sets the money value of this Price.

country

Sets the country for which this Price is valid.

Pattern: ^[A-Z]{2}$

Sets the CustomerGroup for which this Price is valid.

Sets the product distribution Channel for which this Price is valid.

validFrom

Sets the date from which the Price is valid. Must be at least 1 ms earlier than validUntil.

validUntil

Sets the date until the Price is valid. Must be at least 1 ms later than validFrom. Standalone Prices that are no longer valid are not automatically deleted, but they can be deleted if necessary.

tiers
Array of PriceTierDraft

Sets price tiers.

If discounted is set, the tiered Price is ignored for a Product Variant.

discounted

Sets a discounted price for this Price that is different from the base price with value.

staged

Staged changes for the StandalonePrice.

active
Boolean

Set to false, if the StandalonePrice should not be considered during price selection.

Default: true
custom

Custom Fields for the StandalonePrice.

StandalonePricePagedQueryResponse

limit
Int

Number of requested results.

offset
Int

Offset supplied by the client or server default. It is the number of elements skipped, not a page number.

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 StandalonePrice

StandalonePrices matching the query.

StandalonePriceReference

id
String

Unique ID of the referenced resource.

typeId
String
"standalone-price"

References a StandalonePrice.

Contains the representation of the expanded StandalonePrice. Only present in responses to requests with Reference Expansion for StandalonePrice.

StandalonePriceResourceIdentifier

id
String

Unique identifier of the referenced resource. Required if key is absent.

key
String

User-defined unique identifier of the referenced resource. Required if id is absent.

typeId
String
"standalone-price"

References a StandalonePrice.

StagedStandalonePrice

Staged changes on a Standalone Price. To update the value property of a Staged Standalone Price, use the Change Value update action. To apply all staged changes to the Standalone Price, use the Apply Staged Changes update action.

value

Money value of the StagedStandalonePrice.

discounted

Discounted price for the StagedStandalonePrice.

StagedPriceDraft

value

Money value for the StagedPriceDraft.

Get StandalonePrice

Get StandalonePrice by ID

GET
https://api.{region}.commercetools.com/{projectKey}/standalone-prices/{id}
OAuth 2.0 Scopes:
view_standalone_prices:{projectKey}
Path parameters:
region
String

Region in which the Project is hosted.

projectKey
String

key of the Project.

id
String

id of the StandalonePrice.

Query parameters:
expand
The parameter can be passed multiple times.
Response:
200StandalonePriceasapplication/json
Request Example:cURL
curl --get https://api.{region}.commercetools.com/{projectKey}/standalone-prices/{id} -i \
--header 'Authorization: Bearer ${BEARER_TOKEN}'
200 Response Example: StandalonePricejson
{
"id": "3f8812c6-88e8-11ec-a8a3-0242ac120002",
"version": 1,
"sku": "PT974SKT",
"value": {
"type": "centPrecision",
"currencyCode": "EUR",
"centAmount": 10000,
"fractionDigits": 2
},
"staged": {
"value": {
"type": "centPrecision",
"currencyCode": "EUR",
"centAmount": 20000,
"fractionDigits": 2
}
},
"active": true,
"createdAt": "2022-05-09T08:29:13.253Z",
"lastModifiedAt": "2022-05-09T12:36:55.401Z"
}

Get StandalonePrice by Key

GET
https://api.{region}.commercetools.com/{projectKey}/standalone-prices/key={key}
OAuth 2.0 Scopes:
view_standalone_prices:{projectKey}
Path parameters:
region
String

Region in which the Project is hosted.

projectKey
String

key of the Project.

key
String

key of the StandalonePrice.

Query parameters:
expand
The parameter can be passed multiple times.
Response:
200StandalonePriceasapplication/json
Request Example:cURL
curl --get https://api.{region}.commercetools.com/{projectKey}/standalone-prices/key={key} -i \
--header 'Authorization: Bearer ${BEARER_TOKEN}'
200 Response Example: StandalonePricejson
{
"id": "3f8812c6-88e8-11ec-a8a3-0242ac120002",
"version": 1,
"sku": "PT974SKT",
"value": {
"type": "centPrecision",
"currencyCode": "EUR",
"centAmount": 10000,
"fractionDigits": 2
},
"staged": {
"value": {
"type": "centPrecision",
"currencyCode": "EUR",
"centAmount": 20000,
"fractionDigits": 2
}
},
"active": true,
"createdAt": "2022-05-09T08:29:13.253Z",
"lastModifiedAt": "2022-05-09T12:36:55.401Z"
}

Query StandalonePrices

GET
https://api.{region}.commercetools.com/{projectKey}/standalone-prices
OAuth 2.0 Scopes:
view_standalone_prices:{projectKey}
Path parameters:
region
String

Region in which the Project is hosted.

projectKey
String

key of the Project.

Query parameters:
where
The parameter can be passed multiple times.
/^var[.][a-zA-Z0-9]+$/
Any string parameter matching this regular expression

Predicate parameter values.

The parameter can be passed multiple times.
sort
The parameter can be passed multiple times.
expand
The parameter can be passed multiple times.
limit
Int
offset
Int

Number of elements skipped.

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.

Response:
Request Example:cURL
curl --get https://api.{region}.commercetools.com/{projectKey}/standalone-prices -i \
--header 'Authorization: Bearer ${BEARER_TOKEN}'
200 Response Example: StandalonePricePagedQueryResponsejson
{
"limit": 20,
"offset": 0,
"count": 2,
"total": 2,
"results": [
{
"id": "3f8812c6-88e8-11ec-a8a3-0242ac120002",
"version": 1,
"sku": "PT974SKT",
"value": {
"type": "centPrecision",
"currencyCode": "EUR",
"centAmount": 10000,
"fractionDigits": 2
},
"active": true,
"createdAt": "2022-05-09T08:29:13.253Z",
"lastModifiedAt": "2022-05-09T12:36:55.401Z"
},
{
"id": "9d73608c-88ea-11ec-a8a3-0242ac120002",
"version": 1,
"key": "random-key-12345",
"sku": "PT562ZTB",
"value": {
"type": "centPrecision",
"currencyCode": "USD",
"centAmount": 15000,
"fractionDigits": 2
},
"country": "DE",
"channel": {
"typeId": "channel",
"id": "2ae21284-88ea-11ec-a8a3-0242ac120002"
},
"customerGroup": {
"typeId": "customer-group",
"id": "15a1678a-88ea-11ec-a8a3-0242ac120002"
},
"active": true,
"createdAt": "2022-05-09T09:29:13.253Z",
"lastModifiedAt": "2022-05-09T10:36:55.401Z"
}
]
}

Check if StandalonePrice exists

Check if StandalonePrice exists by ID

HEAD
https://api.{region}.commercetools.com/{projectKey}/standalone-prices/{id}

Checks if a StandalonePrice exists for a given id. Returns a 200 OK status if the StandalonePrice exists or a 404 Not Found otherwise.

OAuth 2.0 Scopes:
view_standalone_prices:{projectKey}
Path parameters:
region
String

Region in which the Project is hosted.

projectKey
String

key of the Project.

id
String

id of the StandalonePrice.

Response:
200
Request Example:cURL
curl --head https://api.{region}.commercetools.com/{projectKey}/standalone-prices/{id} -i \
--header 'Authorization: Bearer ${BEARER_TOKEN}'

Check if StandalonePrice exists by Key

HEAD
https://api.{region}.commercetools.com/{projectKey}/standalone-prices/key={key}

Checks if a StandalonePrice exists for a given key. Returns a 200 OK status if the StandalonePrice exists or a 404 Not Found otherwise.

OAuth 2.0 Scopes:
view_standalone_prices:{projectKey}
Path parameters:
region
String

Region in which the Project is hosted.

projectKey
String

key of the Project.

key
String

key of the StandalonePrice.

Response:
200
Request Example:cURL
curl --head https://api.{region}.commercetools.com/{projectKey}/standalone-prices/key={key} -i \
--header 'Authorization: Bearer ${BEARER_TOKEN}'

Check if StandalonePrice exists by Query Predicate

HEAD
https://api.{region}.commercetools.com/{projectKey}/standalone-prices

Checks if a StandalonePrice exists for a given Query Predicate. Returns a 200 OK status if any StandalonePrices match the Query Predicate, or a 404 Not Found otherwise.

OAuth 2.0 Scopes:
view_standalone_prices:{projectKey}
Path parameters:
region
String

Region in which the Project is hosted.

projectKey
String

key of the Project.

Query parameters:
where
The parameter can be passed multiple times.
Response:
200
Request Example:cURL
curl --head https://api.{region}.commercetools.com/{projectKey}/standalone-prices -i \
--header 'Authorization: Bearer ${BEARER_TOKEN}'

Create StandalonePrice

POST
https://api.{region}.commercetools.com/{projectKey}/standalone-prices

Produces the StandalonePriceCreated Message.

OAuth 2.0 Scopes:
manage_standalone_prices:{projectKey}
Path parameters:
region
String

Region in which the Project is hosted.

projectKey
String

key of the Project.

Query parameters:
expand
The parameter can be passed multiple times.
Request Body:StandalonePriceDraftasapplication/json
Response:
201StandalonePriceasapplication/json
Request Example:cURL
curl https://api.{region}.commercetools.com/{projectKey}/standalone-prices -i \
--header 'Authorization: Bearer ${BEARER_TOKEN}' \
--header 'Content-Type: application/json' \
--data-binary @- << DATA
{
"sku" : "PT974SKT",
"value" : {
"currencyCode" : "EUR",
"centAmount" : 10000
}
}
DATA
201 Response Example: StandalonePricejson
{
"id": "3f8812c6-88e8-11ec-a8a3-0242ac120002",
"version": 1,
"sku": "PT974SKT",
"value": {
"type": "centPrecision",
"currencyCode": "EUR",
"centAmount": 10000,
"fractionDigits": 2
},
"staged": {
"value": {
"type": "centPrecision",
"currencyCode": "EUR",
"centAmount": 20000,
"fractionDigits": 2
}
},
"active": true,
"createdAt": "2022-05-09T08:29:13.253Z",
"lastModifiedAt": "2022-05-09T12:36:55.401Z"
}

Update StandalonePrice

Update StandalonePrice by ID

POST
https://api.{region}.commercetools.com/{projectKey}/standalone-prices/{id}
OAuth 2.0 Scopes:
manage_standalone_prices:{projectKey}
Path parameters:
region
String

Region in which the Project is hosted.

projectKey
String

key of the Project.

id
String

id of the StandalonePrice.

Query parameters:
expand
The parameter can be passed multiple times.
Request Body:
application/json
version
Int

Expected version of the StandalonePrice on which the changes should be applied. If the expected version does not match the actual version, a ConcurrentModification error will be returned.

actions

Update actions to be performed on the StandalonePrice.

Response:
200StandalonePriceasapplication/json
Request Example:cURL
curl https://api.{region}.commercetools.com/{projectKey}/standalone-prices/{id} -i \
--header 'Authorization: Bearer ${BEARER_TOKEN}' \
--header 'Content-Type: application/json' \
--data-binary @- << DATA
{
"version" : 1,
"actions" : [ {
"action" : "changeValue",
"value" : {
"currencyCode" : "EUR",
"centAmount" : 10000
}
} ]
}
DATA
200 Response Example: StandalonePricejson
{
"id": "3f8812c6-88e8-11ec-a8a3-0242ac120002",
"version": 1,
"sku": "PT974SKT",
"value": {
"type": "centPrecision",
"currencyCode": "EUR",
"centAmount": 10000,
"fractionDigits": 2
},
"staged": {
"value": {
"type": "centPrecision",
"currencyCode": "EUR",
"centAmount": 20000,
"fractionDigits": 2
}
},
"active": true,
"createdAt": "2022-05-09T08:29:13.253Z",
"lastModifiedAt": "2022-05-09T12:36:55.401Z"
}

Update StandalonePrice by Key

POST
https://api.{region}.commercetools.com/{projectKey}/standalone-prices/key={key}
OAuth 2.0 Scopes:
manage_standalone_prices:{projectKey}
Path parameters:
region
String

Region in which the Project is hosted.

projectKey
String

key of the Project.

key
String

key of the StandalonePrice.

Query parameters:
expand
The parameter can be passed multiple times.
Request Body:
application/json
version
Int

Expected version of the StandalonePrice on which the changes should be applied. If the expected version does not match the actual version, a ConcurrentModification error will be returned.

actions

Update actions to be performed on the StandalonePrice.

Response:
200StandalonePriceasapplication/json
Request Example:cURL
curl https://api.{region}.commercetools.com/{projectKey}/standalone-prices/key={key} -i \
--header 'Authorization: Bearer ${BEARER_TOKEN}' \
--header 'Content-Type: application/json' \
--data-binary @- << DATA
{
"version" : 1,
"actions" : [ {
"action" : "changeValue",
"value" : {
"currencyCode" : "EUR",
"centAmount" : 10000
}
} ]
}
DATA
200 Response Example: StandalonePricejson
{
"id": "3f8812c6-88e8-11ec-a8a3-0242ac120002",
"version": 1,
"sku": "PT974SKT",
"value": {
"type": "centPrecision",
"currencyCode": "EUR",
"centAmount": 10000,
"fractionDigits": 2
},
"staged": {
"value": {
"type": "centPrecision",
"currencyCode": "EUR",
"centAmount": 20000,
"fractionDigits": 2
}
},
"active": true,
"createdAt": "2022-05-09T08:29:13.253Z",
"lastModifiedAt": "2022-05-09T12:36:55.401Z"
}

Update actions

Change Value

Updating the value of a StandalonePrice produces the StandalonePriceValueChangedMessage.

action
String
"changeValue"
value

New value to set. Must not be empty.

staged
Boolean

If set to true the update action applies to the StagedStandalonePrice. If set to false, the update action applies to the current StandalonePrice.

Default: false
Example: json
{
"action": "changeValue",
"staged": false,
"value": {
"currencyCode": "EUR",
"centAmount": 10000
}
}

Change Active

Updating the value of a StandalonePrice produces the StandalonePriceActiveChanged Message.

action
String
"changeActive"
active
Boolean

New value to set for the active field of the StandalonePrice.

Example: json
{
"action": "changeActive",
"active": false
}

Set Key

Sets the key on a Standalone Price. Produces the StandalonePriceKeySet Message.

action
String
"setKey"
key
String

Value to set. Must be unique. If empty, any existing value will be removed.

MinLength: 2MaxLength: 256Pattern: ^[A-Za-z0-9_-]+$
Example: json
{
"action": "setKey",
"key": "new-key"
}

Set Custom Type

action
String
"setCustomType"

Defines the Type that extends the StandalonePrice with Custom Fields. If absent, any existing Type and Custom Fields are removed from the StandalonePrice.

fields

Sets the Custom Fields fields for the StandalonePrice.

Example: json
{
"action": "setCustomType",
"type": {
"id": "{{type-id}}",
"typeId": "type"
},
"fields": {
"exampleStringTypeField": "TextString"
}
}

Set Custom Field

action
String
"setCustomField"
name
String

Name of the Custom Field.

value

If value is absent or null, this field will be removed if it exists. Removing a field that does not exist returns an InvalidOperation error. If value is provided, it is set for the field defined by name.

Example: json
{
"action": "setCustomField",
"name": "ExampleStringTypeField",
"value": "TextString"
}

Set Discounted Price

Discounts a Standalone Price. The referenced ProductDiscount in the discounted field must be of type external, active, and its predicate must match the referenced Price. Produces the StandalonePriceExternalDiscountSet Message.

action
String
"setDiscountedPrice"
discounted

Value to set. If empty, any existing value will be removed.

Example: json
{
"action": "setDiscountedPrice",
"discounted": {
"value": {
"type": "centPrecision",
"currencyCode": "EUR",
"centAmount": 2990,
"fractionDigits": 2
},
"discount": {
"typeId": "product-discount",
"id": "{{product-discount-id}}"
}
}
}

Add Price Tier

Adding a PriceTier to a StandalonePrice produces the Standalone Price Tier Added Message.

action
String
"addPriceTier"
tier

The PriceTier to be added to the tiers field of the StandalonePrice. The action returns an InvalidField error in the following cases:

  • Trying to add a PriceTier with minimumQuantity < 2.
  • Trying to add a PriceTier with minimumQuantity that already exists for the StandalonePrice.
Example: json
{
"action": "addPriceTier",
"tier": {
"minimumQuantity": 100,
"value": {
"centAmount": 4200,
"currencyCode": "EUR",
"type": "centPrecision"
}
}
}

Remove Price Tier

Removing a PriceTier from a StandalonePrice produces the Standalone Price Tier Removed Message.

action
String
"removePriceTier"
tierMinimumQuantity
Int

The minimumQuantity of the PriceTier to be removed from the tiers field of the StandalonePrice.

Example: json
{
"action": "removePriceTier",
"tierMinimumQuantity": 100
}

Set Price Tiers

Sets all PriceTiers for a StandalonePrice in one action, produces the Standalone Price Tiers Set Message.

action
String
"setPriceTiers"
tiers
Array of PriceTierDraft

Value to set. If empty, any existing value will be removed. The minimumQuantity of the PriceTiers must be unique and greater than 1, otherwise an InvalidField error is returned.

Example: json
{
"action": "setPriceTiers",
"tiers": [
{
"minimumQuantity": 100,
"value": {
"centAmount": 4200,
"currencyCode": "EUR",
"type": "centPrecision"
}
},
{
"minimumQuantity": 1000,
"value": {
"centAmount": 4000,
"currencyCode": "EUR",
"type": "centPrecision"
}
}
]
}

Apply Staged Changes

Applies all staged changes to the StandalonePrice by overwriting all current values with the values in the StagedStandalonePrice. After successfully applied, the StagedStandalonePrice will be removed from the StandalonePrice. An applyStagedChanges update action on a StandalonePrice that does not contain any staged changes will return a 400 Bad Request error. Applying staged changes successfully will produce the StandalonePriceStagedChangesApplied Message.

action
String
"applyStagedChanges"
Example: json
{
"action": "applyStagedChanges"
}

Remove Staged Changes

Removes all staged changes from the StandalonePrice. Removing staged changes successfully produces the StandalonePriceStagedChangesRemoved Message.

action
String
"removeStagedChanges"
Example: json
{
"action": "removeStagedChanges"
}

Set Valid From

Updating the validFrom value generates the StandalonePriceValidFromSet Message.

As the validity dates are part of the price scope and are not allowed to overlap, this update might return the DuplicateStandalonePriceScope and OverlappingStandalonePriceValidity errors, respectively. A Price without validity period does not conflict with a Price defined for a time period.

action
String
"setValidFrom"
validFrom

Value to set. If empty, any existing value is removed.

Example: json
{
"action": "setValidFrom",
"validFrom": "2019-03-30T20:30:00.000Z"
}

Set Valid Until

Updating the validUntil value generates the StandalonePriceValidUntilSet Message.

As the validity dates are part of the price scope and are not allowed to overlap, this update might return the DuplicateStandalonePriceScope and OverlappingStandalonePriceValidity errors, respectively. A Price without validity period does not conflict with a Price defined for a time period.

action
String
"setValidUntil"
validUntil

Value to set. If empty, any existing value is removed.

Example: json
{
"action": "setValidUntil",
"validUntil": "2019-04-21T20:30:00.000Z"
}

Set Valid From and Until

Updating the validFrom and validUntil values generates the StandalonePriceValidFromAndUntilSet Message.

As the validity dates are part of the price scope and are not allowed to overlap, this update might return the DuplicateStandalonePriceScope and OverlappingStandalonePriceValidity errors, respectively. A Price without validity period does not conflict with a Price defined for a time period.

action
String
"setValidFromAndUntil"
validFrom

Value to set. If empty, any existing value is removed.

validUntil

Value to set. If empty, any existing value is removed.

Example: json
{
"action": "setValidFromAndUntil",
"validFrom": "2019-03-30T20:30:00.000Z",
"validUntil": "2019-04-21T20:30:00.000Z"
}

Delete StandalonePrice

Delete StandalonePrice by ID

DELETE
https://api.{region}.commercetools.com/{projectKey}/standalone-prices/{id}

Produces the StandalonePriceDeleted Message.

OAuth 2.0 Scopes:
manage_standalone_prices:{projectKey}
Path parameters:
region
String

Region in which the Project is hosted.

projectKey
String

key of the Project.

id
String

id of the StandalonePrice.

Query parameters:
version
Int

Last seen version of the resource.

expand
The parameter can be passed multiple times.
Response:
200StandalonePriceasapplication/json
Request Example:cURL
curl -X DELETE https://api.{region}.commercetools.com/{projectKey}/standalone-prices/{id}?version={version} -i \
--header 'Authorization: Bearer ${BEARER_TOKEN}'
200 Response Example: StandalonePricejson
{
"id": "3f8812c6-88e8-11ec-a8a3-0242ac120002",
"version": 1,
"sku": "PT974SKT",
"value": {
"type": "centPrecision",
"currencyCode": "EUR",
"centAmount": 10000,
"fractionDigits": 2
},
"staged": {
"value": {
"type": "centPrecision",
"currencyCode": "EUR",
"centAmount": 20000,
"fractionDigits": 2
}
},
"active": true,
"createdAt": "2022-05-09T08:29:13.253Z",
"lastModifiedAt": "2022-05-09T12:36:55.401Z"
}

Delete StandalonePrice by Key

DELETE
https://api.{region}.commercetools.com/{projectKey}/standalone-prices/key={key}

Produces the StandalonePriceDeleted Message.

OAuth 2.0 Scopes:
manage_standalone_prices:{projectKey}
Path parameters:
region
String

Region in which the Project is hosted.

projectKey
String

key of the Project.

key
String

key of the StandalonePrice.

Query parameters:
version
Int

Last seen version of the resource.

expand
The parameter can be passed multiple times.
Response:
200StandalonePriceasapplication/json
Request Example:cURL
curl -X DELETE https://api.{region}.commercetools.com/{projectKey}/standalone-prices/key={key}?version={version} -i \
--header 'Authorization: Bearer ${BEARER_TOKEN}'
200 Response Example: StandalonePricejson
{
"id": "3f8812c6-88e8-11ec-a8a3-0242ac120002",
"version": 1,
"sku": "PT974SKT",
"value": {
"type": "centPrecision",
"currencyCode": "EUR",
"centAmount": 10000,
"fractionDigits": 2
},
"staged": {
"value": {
"type": "centPrecision",
"currencyCode": "EUR",
"centAmount": 20000,
"fractionDigits": 2
}
},
"active": true,
"createdAt": "2022-05-09T08:29:13.253Z",
"lastModifiedAt": "2022-05-09T12:36:55.401Z"
}