FieldEdge Open API
dev
  • production
  • dev
DocsAPIs
DocsAPIs
dev
  • production
  • dev
dev
  • production
  • dev
  1. Assignments
  • Lead
    • Creates a new lead with customer details, appointment preferences, and service information.
      POST
    • Fetches lead details based on the provided lead identifier.
      GET
  • Customer
    • Creates a new customer
      POST
    • Updates an existing customer
      PUT
    • Retrieve customer by phone number
      GET
    • Search customers with optional filters
      GET
    • Retrieve customers based on address details.
      GET
    • Retrieve customer details by ID
      GET
  • CustomerAttachments
    • Upload a file attachment to a customer record
      POST
    • Retrieve attachments for a customer
      GET
  • CustomerNotes
    • Create a note on a customer record
      POST
    • Retrieve all notes for a customer
      GET
    • Update an existing customer note
      PATCH
  • CustomerTags
    • Associate a tag with a customer
      POST
    • Remove a tag from a customer
      DELETE
    • Create a reusable customer tag
      POST
    • Retrieve tags
      GET
  • Item
    • Creates a new inventory item
      POST
    • Retrieve a paginated list of inventory items with optional filters
      GET
    • Bulk update inventory items
      PATCH
    • Updates an existing inventory item
      PATCH
    • Retrieve an inventory item by ID
      GET
    • Retrieve availability of an item across one or more warehouses
      GET
  • ItemCategory
    • Retrieve list of item categories
    • Create a new item category
    • Retrieve item category by id.
    • Partially update an item category
  • SalesTaxCode
    • Retrieve list of sales tax codes
  • WorkOrder
    • Retrieve a paginated list of work orders
    • Retrieve a work order by ID
    • Retrieve work orders at a given address, most recent first
    • Create a new work order
    • Update an existing work order
    • Retrieve list of business units
    • Retrieve business unit by id.
    • Retrieve list of lead sources
    • Retrieve lead source by id.
  • Assignments
    • Retrieve all technician assignments for a work order
      GET
    • Assign a technician to a work order
      POST
  • Agreement
    • Retrieve list of agreements
    • Retrieve agreement by id.
  • Invoice
    • Retrieve a paginated list of invoices
    • Retrieve an invoice by ID
  • Quote
    • Retrieve a paginated list of quotes
    • Retrieve a quote by ID
  • Task
    • Retrieve a task bundle by ID
    • Retrieve a list of tasks
  • Warehouse
    • Create a new warehouse
    • Retrieve a paginated list of warehouses
    • Update an existing warehouse
    • Retrieve a warehouse by ID
  • Employee
    • Retrieve a paginated list of employees
    • Retrieve an employee by ID
  • Company
    • Retrieve company name by ID
  • Webhook
    • Register a webhook endpoint to receive event notifications.
    • Delete the registered webhook for the authenticated account.
    • Rotate the HMAC signing secret for the registered webhook.
  1. Assignments

Retrieve all technician assignments for a work order

GET
/v1/work-orders/{workOrderId}/assignments
Returns a paginated and sortable list of technician assignments for the specified work order. Use technicianId, assignmentStatus, scheduleDateFrom/scheduleDateTo to filter within the work order (useful on multi-assign jobs with several technicians). Use sort to control ordering.
Required scope: workorders:read

Request

Authorization
or
Path Params

Query Params

Responses

🟢200
application/json
Work order's assignments retrieved successfully (data is [] if none exist).
Bodyapplication/json

🟠400
🟠401
🟠403
🟠404
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://dev.api.fieldedge.com/open-api/v1/work-orders//assignments?offset=&limit=&sort=&technicianId=&assignmentStatus=&scheduleDateFrom=&scheduleDateTo='
Response Response Example
200 - Paginated list of technician assignments
{
    "total": 2,
    "limit": 20,
    "offset": 0,
    "data": [
        {
            "assignmentId": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
            "workOrderId": "a1b2c3d4-0000-0000-0000-111111111111",
            "taskId": "b2c3d4e5-0000-0000-0000-222222222222",
            "taskName": "HVAC Maintenance",
            "technicianId": "c3d4e5f6-0000-0000-0000-333333333333",
            "technicianName": "John Smith",
            "scheduleDateTime": "2026-06-10T08:00:00.0000000Z",
            "estCompleteDateTime": "2026-06-10T10:00:00.0000000Z",
            "promisedWindowStart": "2026-06-10T08:00:00.0000000Z",
            "promisedWindowEnd": "2026-06-10T10:00:00.0000000Z",
            "assignmentStatus": "TechTraveling",
            "taskStatus": "Scheduled",
            "completed": false,
            "cancelNote": null,
            "helper": false,
            "primaryTask": true,
            "multiAssign": false
        },
        {
            "assignmentId": "a2b3c4d5-e6f7-8901-bcde-fa2345678901",
            "workOrderId": "a1b2c3d4-0000-0000-0000-111111111111",
            "taskId": "b2c3d4e5-0000-0000-0000-222222222222",
            "taskName": "HVAC Maintenance",
            "technicianId": "d4e5f6a7-0000-0000-0000-444444444444",
            "technicianName": "Jane Doe",
            "scheduleDateTime": "2026-06-10T08:00:00.0000000Z",
            "estCompleteDateTime": "2026-06-10T10:00:00.0000000Z",
            "promisedWindowStart": "2026-06-10T08:00:00.0000000Z",
            "promisedWindowEnd": "2026-06-10T10:00:00.0000000Z",
            "assignmentStatus": "AssignmentPending",
            "taskStatus": "Scheduled",
            "completed": false,
            "cancelNote": null,
            "helper": true,
            "primaryTask": false,
            "multiAssign": true
        }
    ]
}
Modified at 2026-08-27 11:28:01
Previous
Retrieve lead source by id.
Next
Assign a technician to a work order
Built with