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

# Find jobs based on search parameters.

`POST /api/jobs/list`

## Query parameters

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

## Request body

- JobRequestFindParameters — Parameters used for searching/finding jobs.
  - `jobIds` string[], nullable — Filter to jobs whose ids are in the list
  - `numbers` integer[], nullable — Filter jobs to only given numbers
  - `jobNames` string[], nullable — Filter jobs to only given names
  - `status` 'draft' | 'needsReview' | 'approved' | 'engineering' | 'scheduled' | 'inProgress' | 'complete' | 'cancelled' | 'hold' — Job status
  - `statuses` JobStatusEnum[], nullable — Filter jobs to match the given statuses
  - `parentItemId` string, nullable — Filter jobs based on the id of the parent item they produce
  - `hasIncompleteOperations` boolean, nullable — Filters jobs to have those that have at least 1 incomplete operation. Note that this will filter out jobs that haven't been approved yet because they technically have no operations on them until approved.
  - `salesOrderId` string, nullable — Filters for jobs that are for this sales order id. Please reference /api/sales-orders endpoint.
  - `createdBeforeUtc` string, date-time, nullable — Filters jobs created before (exclusive) this parameter in UTC time. If no time component is passed, midnight UTC will be used.
  - `createdAfterUtc` string, date-time, nullable — Filters jobs created after (exclusive) this parameter in UTC time. If no time component is passed, midnight UTC will be used.
  - `modifiedBeforeUtc` string, date-time, nullable — Filters jobs modified before (exclusive) this parameter in UTC time. If no time component is passed, midnight UTC will be used.
  - `modifiedAfterUtc` string, date-time, nullable — Filters jobs modified after (exclusive) this parameter in UTC time. If no time component is passed, midnight UTC will be used. Useful for polling incrementally instead of re-syncing every job.

## Response `200`

List of jobs matching the filters

- JobDto[]
  - `id` string, required — Unique Id associated to this entity
  - `number` integer, required — Job number
  - `name` string, required — Job name, defaults to number unless otherwise specified.
  - `parentItemId` string, required — Unique identifier of the parent item produced by this job. Please reference api/items endpoint.
  - `quantityToMake` number, double, required — Quantity of parent item produced by this job
  - `productionDueDate` string, date-time, nullable — Due date
  - `earliestStartDate` string, date-time, nullable — If set, this is the earliest date that the job should be scheduled to begin.
  - `salesOrderId` string, nullable — Identifier of sales order fulfilled by this job, if applicable. Please reference api/sales-orders endpoint.
  - `salesOrderLineItemId` string, nullable — Identifier of sales order line item fulfilled by this job, if applicable. Please reference endpoints nested under api/sales-orders.
  - `createdUtc` string, date-time — The date the job was created
  - `originalScheduledStartUtc` string, date-time, nullable — The first scheduled start time.
  - `originalScheduledEndUtc` string, date-time, nullable — The first scheduled end time.
  - `scheduledStartUtc` string, date-time, nullable — The current scheduled start time.
  - `scheduledEndUtc` string, date-time, nullable — The current scheduled end time.
  - `completedOnUtc` string, date-time, nullable — The job completion datetime.
  - `cancelledOnUtc` string, date-time, nullable — The job cancelled datetime.
  - `revenue` number, double, nullable — Revenue
  - `notes` string, nullable — Job level internal notes
  - `workOrderIds` string[], required — Identifier of work order(s) that this job is associated to, if applicable. Please reference api/work-orders endpoint.
  - `workOrders` WorkOrderReferenceDto[], required — Work order information, if applicable.
    - `id` string, required — Identifier of work order. Please reference api/work-orders endpoint for additional information.
    - `number` integer, required — Number
    - `name` string, required — Work order name, defaults to number unless otherwise specified.
  - `status` 'draft' | 'needsReview' | 'approved' | 'engineering' | 'scheduled' | 'inProgress' | 'complete' | 'cancelled' | 'hold', required — Job status
  - `priority` 'low' | 'moderate' | 'high', required — Job priority
  - `customFields` object, nullable — Custom fields that have been defined on this entity.

---

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