---
title: "List the cost breakdowns recorded for an item by the quote lines, sales order lines and jobs that costed it, newest calculatedOn first and highest id next. Breakdowns on deleted documents, and ones no document references, are left out."
method: POST
path: "/api/items/{itemId}/cost-breakdowns/list"
tags: ["Item"]
---

# List the cost breakdowns recorded for an item by the quote lines, sales order lines and jobs that costed it, newest calculatedOn first and highest id next. Breakdowns on deleted documents, and ones no document references, are left out.

`POST /api/items/{itemId}/cost-breakdowns/list`

## Request

- Base URL: `https://api.fulcrumpro.com`
- URL: `https://api.fulcrumpro.com/api/items/{itemId}/cost-breakdowns/list`
- Auth: none declared

## Path parameters

- `itemId` string, required

## Query parameters

- `Sort.Field` string
- `Sort.Dir` 'ascending' | 'descending': Specify sorting direction.
- `Skip` integer
- `Take` integer

## Request body

- ItemRequestListItemCostBreakdownsParameters: Filters for an item's cost breakdown list.
  - `types` ItemsAndInventoryRoutingsCostBreakdownType[], nullable: Only cost breakdowns of these types. Omitted or empty returns every type.

## Response `200`

The page of cost breakdowns; an empty page when the item has never been costed

- DtoPagedResultDtoCommonCostBreakdownDto: Paged result
  - `data` CommonCostBreakdownDto[], required: The data
    - `id` string, required: The id of the parent item.
    - `type` 'estimated' | 'inProgressJob' | 'completedJob' | 'cancelledJob', required
    - `quantity` integer, required: Number of units.
    - `quantityScrapped` integer, nullable: Number of units scrapped.
    - `calculatedOn` string, date-time, required: When was this cost breakdown last calculated/aggregated.
    - `time` CommonTimeDto, required: Time information
      - `labor` number, double, required: Total
      - `machine` number, double, required: Cost per unit
      - `setup` number, double, required: Cost per unit
    - `cumulative` CommonCostDto, required: Cost information
      - `total` number, double, required: Total
      - `perUnit` number, double, required: Cost per unit
    - `cumulativeMaterial` CommonCostDto, required: Cost information
      - `total` number, double, required: Total
      - `perUnit` number, double, required: Cost per unit
    - `cumulativeLabor` CommonCostDto, required: Cost information
      - `total` number, double, required: Total
      - `perUnit` number, double, required: Cost per unit
    - `cumulativeMachine` CommonCostDto, required: Cost information
      - `total` number, double, required: Total
      - `perUnit` number, double, required: Cost per unit
    - `cumulativeOutsideProcessing` CommonCostDto, required: Cost information
      - `total` number, double, required: Total
      - `perUnit` number, double, required: Cost per unit
    - `itemMaterial` CommonCostDto, required: Cost information
      - `total` number, double, required: Total
      - `perUnit` number, double, required: Cost per unit
    - `itemLabor` CommonCostDto, required: Cost information
      - `total` number, double, required: Total
      - `perUnit` number, double, required: Cost per unit
    - `itemMachine` CommonCostDto, required: Cost information
      - `total` number, double, required: Total
      - `perUnit` number, double, required: Cost per unit
    - `itemOutsideProcessing` CommonCostDto, required: Cost information
      - `total` number, double, required: Total
      - `perUnit` number, double, required: Cost per unit
    - `shopRateSetup` CommonCostDto, required: Cost information
      - `total` number, double, required: Total
      - `perUnit` number, double, required: Cost per unit
    - `shopRateRun` CommonCostDto, required: Cost information
      - `total` number, double, required: Total
      - `perUnit` number, double, required: Cost per unit
    - `shopRateMachine` CommonCostDto, required: Cost information
      - `total` number, double, required: Total
      - `perUnit` number, double, required: Cost per unit
    - `componentMaterial` CommonCostDto, required: Cost information
      - `total` number, double, required: Total
      - `perUnit` number, double, required: Cost per unit
    - `componentLabor` CommonCostDto, required: Cost information
      - `total` number, double, required: Total
      - `perUnit` number, double, required: Cost per unit
    - `componentMachine` CommonCostDto, required: Cost information
      - `total` number, double, required: Total
      - `perUnit` number, double, required: Cost per unit
    - `componentOutsideProcessing` CommonCostDto, required: Cost information
      - `total` number, double, required: Total
      - `perUnit` number, double, required: Cost per unit
    - `lines` CommonCostBreakdownLineDto[], required: Cost breakdown line details.
      - `costType` 'material' | 'labor' | 'setup' | 'machine' | 'outsideProcessing' | 'componentMaterial' | 'componentLabor' | 'componentMachine' | 'componentOutsideProcessing' | 'nestPartMaterialUsage' | 'nestPartMaterialScrap' | 'overhead' | 'unknown', required: Cost breakdown types
      - `operationType` 'labor' | 'setup' | 'machine' | 'outsideProcessing': Operation type
      - `name` string, required: Decription of this line.
      - `cost` number, double, required: Cost.
      - `quantity` number, double, nullable: Quantity (if applicable)
      - `itemId` string, nullable: Id of the item that was picked. Please reference /api/items endpoint.
      - `itemName` string, nullable: The name of the item that was picked.
      - `accountingCodeId` string, nullable: Accounting code affected. Please reference /api/accounting-codes endpoint.
      - `operationInformation` CommonCostBreakdownOperationDto: Operation information
        - `operationId` string, required: Operation id. Please reference /api/operations
        - `name` string, nullable: Operation name.
        - `timeInSeconds` number, double, nullable: Time in seconds.
        - `timeInHours` number, double, nullable: Time in hours
        - `ratePerSecond` number, double, nullable: Rate per second
        - `ratePerHour` number, double, nullable: Rate per hour
  - `page` integer, required: The 1-indexed page
  - `pageSize` integer, required: The page size
  - `totalCount` integer, required: The total count of records
  - `totalPages` integer, required: The total pages
  - `hasPreviousPage` boolean, required: True if there is a previous page
  - `hasNextPage` boolean, required: True if there is a next page

## Other responses

- `400`: Take was 0, or a sort was requested
- `404`: Item did not exist

## Changes

- **2026-10-09** `97783521397b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/changes/api/items/:itemId/cost-breakdowns/list/post.md)

---

[API](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi.md) - [All operations](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/llms.txt) - [OpenAPI document](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/revisions/c9e6f41852d1?raw)