---
title: "Find materials based on search parameters."
method: POST
path: "/api/materials/list"
tags: ["Material"]
---

# Find materials based on search parameters.

`POST /api/materials/list`

## Query parameters

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

## Request body

- MaterialRequestFindParameters — Parameters used for searching/finding materials.
  - `ids` string[], nullable — Filter materials based on matching ids.
  - `materials` string[], nullable — Material names.
  - `grades` string[], nullable — Grades.
  - `forms` CommonEnumMaterialFormEnum[], nullable — Material forms.
  - `displayDimensions` string[], nullable — A list of dimension display values to include
  - `active` boolean, nullable — Indicate whether to specifically only pull active materials. If left null, all rows are included.

## Response `200`

List of materials matching the filters

- MaterialShapeDto[]
  - `id` string, required — Unique id associated to this entity.
  - `active` boolean — Indicates if this material is activated.
  - `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
  - `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.

---

[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)