Field NationDeveloper Platform
Field NationDeveloper Platform
IntroductionQuick StartAPI Playground

Getting Started

API Reference

Overview
Create Work OrderSearch & FilterUpdate & Cancel
Work OrdersBasics

Search & Filter

Find work orders using powerful search, filtering, and sorting parameters.


Search & Filter

Effectively finding work orders is critical for managing large volumes of work. The API provides a robust search endpoint with extensive filtering and sorting capabilities.

List Work Orders

GET /workorders

Pagination

Results are paginated by default.

  • page: (Integer) Page number (default: 1).
  • per_page: (Integer) Items per page (default: 25, max: 100).
GET /workorders?page=2&per_page=50

Filtering

Filters are query parameters prefixed with f_. You can combine multiple filters to narrow down results.

Common Filters

ParameterDescriptionExample
f_work_order_idSpecific ID(s), comma-separated.f_work_order_id=1005
f_projectFilter by Project ID or name.f_project=55
f_clientFilter by Client ID or name.f_client=20
f_assignmentFilter by assignment type or Provider ID.f_assignment=12345
f_createdDate range (Start, End).f_created=2025-01-01,2025-02-01
f_scheduleService date range.f_schedule=2025-01-01,2025-01-31

Location Filters

ParameterDescription
f_cityCity name.
f_stateState code (e.g., MN).
f_postal_codeZip code.

Sorting

Order your results using sort and order.

ParameterDescription
sortColumn ID to sort results by (e.g., work_order_id, created, service_window_start)
orderSort direction: asc (Ascending) or desc (Descending)

Example Request

Find all jobs in California, sorted by Service Date:

GET /workorders?f_state=CA&sort=service_window_start&order=asc

Work Order Statuses

Common work order status stages:

StatusDescription
DraftNot yet published
PublishedAvailable in marketplace
RoutedSent to specific providers
AssignedProvider assigned
In ProgressWork started
Work DoneAwaiting approval
ApprovedPayment processing
PaidComplete
CancelledWork cancelled

Related

  • Create Work Order - Creating new work orders
  • Update & Cancel - Managing work orders
  • Workflow - Understanding states

Last updated on

Create Work Order

Comprehensive guide to creating work orders via the API.

Update & Cancel

Updating, canceling, and managing work orders.

On this page

Search & Filter
List Work Orders
Pagination
Filtering
Common Filters
Location Filters
Sorting
Example Request
Work Order Statuses
Related