---
title: "Finds NCRs based on search parameters"
method: POST
path: "/api/ncrs/list"
tags: ["NCRs"]
---

# Finds NCRs based on search parameters

`POST /api/ncrs/list`

## Query parameters

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

## Request body

- NCRRequestNcrListParameters — Parameters used for searching NCRs
  - `status` string, nullable — Filter NCRs by a specific status Accepted Values: Closed, Hold, New, Quality Review, Engineering Review
  - `type` string, nullable — Filter NCRs by a specific type. Available values are configured per tenant in Quality settings (NCR dropdowns).
  - `cause` string, nullable — Filter NCRs by a specific cause. Available values are configured per tenant in Quality settings (NCR dropdowns).
  - `reason` string, nullable — Filter NCRs by a specific reason. Available values are configured per tenant in Quality settings (NCR dropdowns).
  - `createdUtc` string, date-time, nullable — Filter NCRs created after a certain date

## Response `200`

OK

- DtoPagedResultDtoNCRNcrDto — Paged result
  - `data` NCRNcrDto[], required — The data
    - `id` string, required — Unique id associated to this entity.
    - `number` integer, required — Number
    - `type` string, required — NCR Type
    - `cause` string, required — Cause
    - `detail` string, required — Detail - required notes on the NCR
    - `departmentId` string, nullable — Department key identifier. Please reference /api/departments endpoint.
    - `department` CommonReferenceDto — Represents a reference to a document in a DB collection
      - `id` string, nullable — Unique Id associated to the referenced object
      - `name` string, nullable — Descriptive name associated to the object
    - `vendorId` string, nullable — Vendor key identifier. Please reference /api/vendors endpoint.
    - `vendor` CommonReferenceDto — Represents a reference to a document in a DB collection
      - `id` string, nullable — Unique Id associated to the referenced object
      - `name` string, nullable — Descriptive name associated to the object
    - `workCenters` string, nullable — The work centers assigned to this NCR.
    - `scheduledEquipment` string, nullable — Affected Equipment
    - `reason` string, nullable — Reason
    - `operator` CommonReferenceDto — Represents a reference to a document in a DB collection
      - `id` string, nullable — Unique Id associated to the referenced object
      - `name` string, nullable — Descriptive name associated to the object
    - `status` string, nullable — NCR Status
    - `quantityImpacted` number, double, nullable — Quantity Impacted
    - `incrementalCost` number, double, nullable — Incremental Cost
    - `createdUtc` string, date-time, nullable — Created Date
    - `completedUtc` string, date-time, nullable — Completed Date
    - `jobIds` string[] — Impacted Job IDs
    - `customFields` object, nullable — Custom fields that have been defined on this entity.
    - `completedBy` CommonReferenceDto — Represents a reference to a document in a DB collection
      - `id` string, nullable — Unique Id associated to the referenced object
      - `name` string, nullable — Descriptive name associated to the object
    - `analyzedBy` CommonReferenceDto — Represents a reference to a document in a DB collection
      - `id` string, nullable — Unique Id associated to the referenced object
      - `name` string, nullable — Descriptive name associated to the object
    - `impacts` CommonImpactDto[], nullable — Impact information.
      - `id` string, uuid, required — The ID for this object.
      - `operation` CommonReferenceDto — Represents a reference to a document in a DB collection
        - `id` string, nullable — Unique Id associated to the referenced object
        - `name` string, nullable — Descriptive name associated to the object
      - `workCenter` CommonReferenceDto — Represents a reference to a document in a DB collection
        - `id` string, nullable — Unique Id associated to the referenced object
        - `name` string, nullable — Descriptive name associated to the object
      - `scheduledEquipment` CommonReferenceDto — Represents a reference to a document in a DB collection
        - `id` string, nullable — Unique Id associated to the referenced object
        - `name` string, nullable — Descriptive name associated to the object
      - `job` CommonReferenceDto — Represents a reference to a document in a DB collection
        - `id` string, nullable — Unique Id associated to the referenced object
        - `name` string, nullable — Descriptive name associated to the object
      - `salesOrder` CommonReferenceDto — Represents a reference to a document in a DB collection
        - `id` string, nullable — Unique Id associated to the referenced object
        - `name` string, nullable — Descriptive name associated to the object
      - `quantityImpacted` number, double, nullable — Quantity Impacted
      - `incrementalCost` number, double, nullable — Incremental Cost
  - `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

---

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