Retrieve work orders at a given address, most recent first

GET

/v1/work-orders/search/by-address

Returns a paginated list of work orders matching the given address, sorted by work order date descending (most recent first). Each work order includes the identifying name of its associated customer. Used by Online Booking's existing-customer recognition flow — the frontend uses only the customer on the first item.

Required scope: workorders:read

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Query Params

Responses

🟢200

application/json

Work orders retrieved successfully.

Bodyapplication/json

🟠400

🟠401

🟠403

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.fieldedge.com/open-api/v1/work-orders/search/by-address?addressLine1=&addressLine2=&city=&stateOrRegion=&postalCode=&offset=&limit=&sort=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Work orders at an address, most recent first

{
    "total": 3,
    "limit": 20,
    "offset": 0,
    "data": [
        {
            "workOrderId": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
            "workOrderNumber": "WO-1003",
            "customerId": "d2e3f4a5-0000-0000-0000-bbccddee0011",
            "date": "2026-03-15T08:00:00.0000000Z",
            "address": {
                "address1": "123 Main St",
                "address2": "",
                "city": "Orlando",
                "state": "FL",
                "zip": "32801"
            },
            "customer": {
                "name": "Jane Doe",
                "firstName": "Jane",
                "lastName": "Doe",
                "email": "jane.doe@example.com"
            }
        },
        {
            "workOrderId": "a2b3c4d5-e6f7-8901-bcde-fa2345678901",
            "workOrderNumber": "WO-1002",
            "customerId": "c1d2e3f4-0000-0000-0000-aabbccddeeff",
            "date": "2025-08-10T09:00:00.0000000Z",
            "address": {
                "address1": "123 Main St",
                "address2": "",
                "city": "Orlando",
                "state": "FL",
                "zip": "32801"
            },
            "customer": {
                "name": "John Smith",
                "firstName": "John",
                "lastName": "Smith",
                "email": "john.smith@example.com"
            }
        },
        {
            "workOrderId": "b3c4d5e6-f7a8-9012-cdef-ab3456789012",
            "workOrderNumber": "WO-1001",
            "customerId": "c1d2e3f4-0000-0000-0000-aabbccddeeff",
            "date": "2024-01-05T10:00:00.0000000Z",
            "address": {
                "address1": "123 Main St",
                "address2": "",
                "city": "Orlando",
                "state": "FL",
                "zip": "32801"
            },
            "customer": {
                "name": "John Smith",
                "firstName": "John",
                "lastName": "Smith",
                "email": "john.smith@example.com"
            }
        }
    ]
}

Modified at 2026-08-27 11:27:00

Retrieve a work order by ID

Retrieve list of agreements