What parameters does PUT /V1/products/tier-prices accept?

This endpoint accepts 1 parameter: prices (Magento\Catalog\Api\Data\TierPriceInterface[]) required.

PUTCatalog · Magento 2.4.9 Admin · Magento_Catalog::catalog

PUT /V1/products/tier-prices

Q: What does the PUT /V1/products/tier-prices endpoint do in Magento 2?

PUT /V1/products/tier-prices is a Magento 2 REST endpoint in the Catalog module. Remove existing tier prices and replace them with the new ones. If any items will have invalid price, price type, website id, sku, customer group or quantity, they will be marked as failed and excluded from replace list and \Magento\Catalog\Api\Data\PriceUpdateResultInterface[] with problem description will be returned. If there were no failed items during update empty array will be returned. If error occurred during the update exception will be thrown. Requires an admin Bearer token with ACL Magento_Catalog::catalog.

Q: What does PUT /V1/products/tier-prices return?

The endpoint returns Magento\Catalog\Api\Data\PriceUpdateResultInterface[].

Q: Does PUT /V1/products/tier-prices require authentication?

This endpoint requires an admin Bearer token with ACL: Magento_Catalog::catalog.

PUT /V1/products/tier-prices is a Magento 2 REST endpoint in the Catalog module. Remove existing tier prices and replace them with the new ones. If any items will have invalid price, price type, website id, sku, customer group or quantity, they will be marked as failed and excluded from replace list and \Magento\Catalog\Api\Data\PriceUpdateResultInterface[] with problem description will be returned. If there were no failed items during update empty array will be returned. If error occurred during the update exception will be thrown. Requires an admin Bearer token with ACL Magento_Catalog::catalog.

Last verified: 2026-05-23 against Magento 2.4.9.

Returns

Magento\Catalog\Api\Data\PriceUpdateResultInterface[]

Service contract

Magento\Catalog\Api\TierPriceStorageInterface::replace

Authorization

Admin Bearer token with ACL:

Magento_Catalog::catalog

Body parameters

prices Magento\Catalog\Api\Data\TierPriceInterface[] Required

Example request

Auto-generated from the service contract — paste-ready against your store's /rest/default base. Replace the host, store code, ACL token, and any required values before running.

Headers

application/json

Content-Type

application/json

Authorization

Bearer <ACCESS_TOKEN> admin token with ACL: Magento_Catalog::catalog

Path

/V1/products/tier-prices

Body

{
  "prices": [
    {
      "customer_group": "",
      "extension_attributes": {},
      "price": 0,
      "price_type": "",
      "quantity": 0,
      "sku": "",
      "website_id": 0
    }
  ]
}