---
title: "Find work orders based on search parameters."
method: POST
path: "/api/work-orders/list"
tags: ["Work Order"]
---

# Find work orders based on search parameters.

`POST /api/work-orders/list`

## Query parameters

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

## Request body

- WorkOrderRequestFindParameters — Parameters used for searching/finding work orders.
  - `workOrderIds` string[], nullable — Filter to work orders whose ids are in the list
  - `numbers` integer[], nullable — Filter to only given numbers
  - `names` string[], nullable — Filter to only given names
  - `statuses` WorkOrderStatusEnum[], nullable — Filter to match the given statuses
  - `createdBeforeUtc` string, date-time, nullable — Filters jobs created before (exclusive) this parameter in UTC time. If not 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 not time component is passed, midnight UTC will be used.

## Response `200`

List of work orders matching the filters

- WorkOrderDto[]
  - `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.
  - `createdUtc` string, date-time — The date the job was created
  - `completedOnUtc` string, date-time, nullable — The job completion datetime.
  - `cancelledOnUtc` string, date-time, nullable — The job cancelled datetime.
  - `scheduledStartUtc` string, date-time, nullable — The current scheduled start time.
  - `scheduledEndUtc` string, date-time, nullable — The current scheduled end time.
  - `status` 'needsReview' | 'approved' | 'scheduled' | 'inProgress' | 'complete' | 'cancelled', required — Work order status
  - `priority` 'low' | 'moderate' | 'high' — Job priority

---

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