Retrieve work orders at a given address

GET

/v1/work-orders/by-address

Returns a paginated list of work orders matching the given address, sorted by work order date descending. Each work order includes the identifying name of its associated customer.

Required scope: workorders:read

Request

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://dev.api.fieldedge.com/open-api/v1/work-orders/by-address?addressLine1=&addressLine2=&city=&stateOrRegion=&postalCode=&offset=&limit=&sort='

Response Example

200 - response

{
    "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:00Z",
            "address": {
                "address1": "123 Main St",
                "address2": "",
                "city": "Orlando",
                "state": "FL",
                "zip": "32801"
            },
            "customer": {
                "name": "Jane Doe",
                "firstName": "Jane",
                "lastName": "Doe"
            }
        },
        {
            "workOrderId": "a2b3c4d5-e6f7-8901-bcde-fa2345678901",
            "workOrderNumber": "WO-1002",
            "customerId": "c1d2e3f4-0000-0000-0000-aabbccddeeff",
            "date": "2025-08-10T09:00:00Z",
            "address": {
                "address1": "123 Main St",
                "address2": "",
                "city": "Orlando",
                "state": "FL",
                "zip": "32801"
            },
            "customer": {
                "name": "John Smith",
                "firstName": "John",
                "lastName": "Smith"
            }
        },
        {
            "workOrderId": "b3c4d5e6-f7a8-9012-cdef-ab3456789012",
            "workOrderNumber": "WO-1001",
            "customerId": "c1d2e3f4-0000-0000-0000-aabbccddeeff",
            "date": "2024-01-05T10:00:00Z",
            "address": {
                "address1": "123 Main St",
                "address2": "",
                "city": "Orlando",
                "state": "FL",
                "zip": "32801"
            },
            "customer": {
                "name": "John Smith",
                "firstName": "John",
                "lastName": "Smith"
            }
        }
    ]
}

Modified at 2026-07-09 08:21:27

Retrieve a paginated list of work orders

Retrieve an invoice by ID