---
title: "List input materials for a job's routing"
method: POST
path: "/api/jobs/{jobId}/routing/{routingId}/input-materials/list"
tags: ["Job Full Routing"]
---

# List input materials for a job's routing

`POST /api/jobs/{jobId}/routing/{routingId}/input-materials/list`

## Request

- Base URL: `https://api.fulcrumpro.com`
- URL: `https://api.fulcrumpro.com/api/jobs/{jobId}/routing/{routingId}/input-materials/list`
- Auth: none declared

## Path parameters

- `jobId` string, required
- `routingId` string, required

## Query parameters

- `skip` integer
- `take` integer

## Request body

- RoutingRequestItemFindParameters: Parameters used for searching/finding input items on an item's routing.
  - `number` string, nullable: Filter to items who's number contains the given string

## Response `200`

OK

- ItemRoutingInputMaterialDto[]
  - `id` string, uuid, required: Id of this input material in the item's routing
  - `materialId` string, required: The material id. Please reference /api/materials endpoint.
  - `materialName` string, required: The material name.
  - `materialShape` MaterialShapeDto: Material definition.
    - `id` string, required: Unique id associated to this entity.
    - `active` boolean: Indicates if this material is activated.
    - `isCustom` boolean, nullable: True for a material the account created that is not in the standard material library. Returned only by Material List and Material Get, and only when custom materials are enabled for the account.
    - `name` string, required: Identifying name.
    - `form` 'sheet' | 'plate' | 'roundBar' | 'flatBar' | 'channel' | 'squareTube' | 'angle' | 'treadPlate' | 'hexBar' | 'squareBar' | 'teeBar' | 'hBeam' | 'rectTube' | 'pipe' | 'wBeam' | 'sBeam' | 'roundTube' | 'rectBar' | 'wideBar', required: Specifies the form of the material.
    - `materialReferenceId` string, required: Material Id
    - `materialReferenceName` string, required: Material name
    - `specification` string, nullable: Specification
    - `subSpecification` string, nullable: Sub-specification
    - `finish` string, nullable: Finish
    - `grade` string, nullable: Grade
    - `dimension` string, nullable: Dimension
    - `type` string, nullable: Material type
    - `version` string, nullable: Version
    - `dimensionUnits` string, nullable: Unit the material's dimensions are in: `Inch`, `Foot`, `Yard`, `Millimeter`, `Centimeter` or `Meter`. Routing input-material nesting `d2` and `d3` are costed in this unit. A routing costs from a copy of the material's units, shape type and density taken when the input material was added, so later changes to the material may not reach it.
    - `shapeType` string, nullable: How the material is measured: `Planar` (sheet and plate, costed by length and width) or `Linear` (bar, tube and structural shapes, costed by length). A nesting's `d3` applies only to `Planar` materials.
    - `linearDensity` number, double, nullable: Weight per unit length, in `densityUnits`. Used to cost `Linear` materials.
    - `planarDensity` number, double, nullable: Weight per unit area, in `densityUnits`. Used to cost `Planar` materials.
    - `densityUnits` string, nullable: Unit of `linearDensity` and `planarDensity`: `PoundPerFoot`, `KilogramPerMeter`, `PoundPerSquareFoot` or `KilogramPerSquareMeter`. An input material whose material has no density for its `shapeType` is estimated at zero material cost.
    - `vendors` MaterialShapeVendorDto[], required: Vendors that supply this material.
      - `id` string, uuid, required: Unique id associated to this entity.
      - `vendorId` string, required: Vendor identifier. Pelase reference /api/vendors endpoint.
      - `isPrimary` boolean, required: Signifies if this is the primary vendor for this material.
      - `currencyCode` string, nullable: Currency code/denomination associated to this vendor.
      - `priceUnit` 'kilogram' | 'pound', required: Specifies how a routing input item quantity is measured.
      - `leadTimeInDays` integer, nullable: Number of days required between order and receipt
      - `priceBreaks` MaterialShapeVendorPriceBreakDto[], required: Vendor price breaks
        - `id` string, uuid, required: Unique id associated to this entity.
        - `quantity` integer, required: The minimum quantity to associate this price break to.
        - `price` number, double, required: The price per unit.
  - `costing` 'fullCost' | 'usageBased', required: Specifies the costing of the material.
  - `nestings` ItemRoutingInputMaterialNestingDto[]: Nestings associated to this material indicating bounding box dimensions and production quantities.
    - `id` string, uuid, required: Id of this input material's nesting in the item's routing material
    - `d2` number, double, required: Length of the nest's bounding box, in the material's `dimensionUnits`.
    - `d3` number, double, required: Width of the nest's bounding box, in the material's `dimensionUnits`. Still required (greater than zero) for a `Linear` material, but not used to cost it.
    - `produces` integer, required: The quantity produced, given the bounding box dimensions (D2 x D3). Each part is costed at the material weight of the bounding box (D2 x D3 for `Planar`, D2 for `Linear`) divided by this quantity.
    - `useForEstimatedCosting` boolean: Indicates if this nesting record will be used for estimated costing. A nesting generated by applying a nest to a quote takes precedence over this flag. When neither applies, the nesting with the largest `produces` not exceeding the quantity being costed is used, or the smallest `produces` when every nesting exceeds it. NOTE: Only one nesting record for a material can have this value set to true.
  - `routingStepId` string, nullable: The routing step id. This value should be the Id from the response from items/{itemId}/routing/operations/list

## Changes

- **2026-10-28** `28692655305b`: 2 info
  - added the optional property `items/materialShape/isCustom` to the response with the `200` status (media type: application/json)
  - added the optional property `items/materialShape/isCustom` to the response with the `200` status (media type: application/problem+json)
- **2026-10-02** `125d94e06273`: 10 info
  - added the optional property `items/materialShape/densityUnits` to the response with the `200` status (media type: application/json)
  - added the optional property `items/materialShape/densityUnits` to the response with the `200` status (media type: application/problem+json)
  - added the optional property `items/materialShape/dimensionUnits` to the response with the `200` status (media type: application/json)
  - added the optional property `items/materialShape/dimensionUnits` to the response with the `200` status (media type: application/problem+json)
  - …6 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/changes/api/jobs/:jobId/routing/:routingId/input-materials/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)