---
title: "Get all priceReductions"
method: GET
path: "/v1/price-reductions"
tags: ["Price Reductions V1"]
---

# Get all priceReductions

`GET /v1/price-reductions`

This API can be used to fetch the price reduction for a single positionItemId by providing positionId as a query parameter in the request. If the positionItemId is not specified, then this api would list the price reductions for all your products.

## Query parameters

- `positionItemId` string, uuid
- `page` integer
- `limit` integer

## Response `200`

Successfully retrieved price reductions

- PriceReductionsResponsePriceReductionsV1
  - `results` PriceReductionResponsePriceReductionsV1[] — The list of queried resources. In this case partner reductions.
    - `salesOrderId` string, uuid — salesOrderId for an item
    - `totalPriceReduction` object — sum of all the price reductions for a positionItemId.
      - `amount` number — Holds the value of the monetary amount expressed in a currency, e.g. euros. The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, e.g. 10 is taken as 10 euros
      - `currency` string — Holds the currency of the monetary amount expressed as a shortcut according to ISO 4217 and http://publications.europa.eu/code/de/de-5000700.htm. Currently Only EUR is supported as a currency
    - `invoicePrice` object — the price of the positionItemId as per the invoice generated for the order.
      - `amount` number — Holds the value of the monetary amount expressed in a currency, e.g. euros. The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, e.g. 10 is taken as 10 euros
      - `currency` string — Holds the currency of the monetary amount expressed as a shortcut according to ISO 4217 and http://publications.europa.eu/code/de/de-5000700.htm. Currently Only EUR is supported as a currency
    - `priceReductions` PriceReductionDetailPriceReductionsV1[] — all price reductions applied for an item
      - `receiptNumber` string — receiptNumber of the receipt generated for the price reduction. The receiptNumber would be null is the status of the price reduction is Initiated
      - `priceReduction` object — the price reduction amount for a positionItemId.
        - `amount` number — Holds the value of the monetary amount expressed in a currency, e.g. euros. The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, e.g. 10 is taken as 10 euros
        - `currency` string — Holds the currency of the monetary amount expressed as a shortcut according to ISO 4217 and http://publications.europa.eu/code/de/de-5000700.htm. Currently Only EUR is supported as a currency
      - `creationDateTime` string
      - `status` 'PROCESSED' | 'INITIATED' | 'REJECTED' — Status of the price reduction. - INITIATED: This status implies that the reduction are pending for receipt generation, and receiptId and receiptNumber would be null for INITIATED reductions. - PROCESSED: This status implies that the reductions for which receipts are generated. - REJECTED: This status implies that the reductions which failed validations and were not processed. eg. reductions applied on the positionItemId after it is marked as returned.
    - `positionItemId` string, uuid — positionItemId for an item
  - `links` LinkPriceReductionsV1[] — Links related to the list. E.g. the link to the successive list used during paging.
    - `href` string — The url of the link
    - `rel` string — The relation type of the link. See also https://www.iana.org/assignments/link-relations/link-relations.xhtml. The relation type 'next' is used for paging

## Other responses

- `401` — Unauthorized Access
- `403` — Forbidden Access
- `404` — Price reductions Not Found
- `424` — Unable to retrieve price discounts due to internal errors with downstream systems. Please try again later.

---

[API](https://skmtc.dev/otto/apis/otto-market-api.md) · [All operations](https://skmtc.dev/otto/apis/otto-market-api/llms.txt) · [OpenAPI document](https://skmtc.dev/otto/apis/otto-market-api/revisions/29ca75cdb016?raw)