---
title: "List purchase price breaks for an item."
method: POST
path: "/api/items/{itemId}/purchase-price-breaks/list"
tags: ["Item PriceBreaks"]
---

# List purchase price breaks for an item.

`POST /api/items/{itemId}/purchase-price-breaks/list`

## Path parameters

- `itemId` string, required

## Request body

- PriceBreakListPurchasePriceBreaksDto — Filters for listing purchase price breaks.
  - `vendorId` string, nullable — Restrict to price breaks for the given vendor.
  - `currencyCode` string, nullable — Restrict to price breaks in the given currency.

## Response `200`

List of purchase price breaks for the given item.

- PriceBreakPurchasePriceBreakDto[]
  - `id` string, required — Identifier of the price break.
  - `itemId` string, required — Identifier of the item this price break applies to.
  - `vendorId` string, required — Identifier of the vendor this price break applies to.
  - `currencyCode` string, nullable — ISO 4217 currency code. Null indicates the company's primary currency.
  - `unitOfMeasureName` string, nullable — Purchasing unit of measure for this price break. Null indicates the item's default unit of measure.
  - `unitPrice` number, double, nullable — The unit price at quantity 1.
  - `vendorItemNumber` string, nullable — The vendor's part number for this item, if different from the internal number.
  - `vendorItemName` string, nullable — The vendor's part description for this item.
  - `breakPoints` PriceBreakItemPriceBreakPointDto[], required — Quantity break points beyond quantity 1.
    - `id` string, nullable — Identifier for this break point. Server-generated; ignored on write.
    - `quantity` integer — The quantity at which this break point becomes active. Must be greater than 1 (the unit/base price covers quantity 1).
    - `price` number, double, nullable — The price per unit at this break point. Required for Price-type sales breaks and all purchase (Cost) breaks.
    - `margin` number, double, nullable — The margin percentage at this break point. Used when the price break is calculated by Margin.
    - `showOnPdf` boolean — Whether this break point should be displayed on customer-facing PDFs (quotes, sales orders). Has no effect for purchase price breaks.
  - `modifiedUtc` string, date-time — When this price break was last modified.

## Other responses

- `404` — An item with the given id was not found.

---

[API](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fulcrumpro/fulcrum-publicapi/versions/1b5649cff14a/schema)