List Work Orders

GET

https://api.fortresstech.io/v1/workOrders

GET

/v1/workOrders

$ curl -G https://api.fortresstech.io/v1/workOrders \
>      --data-urlencode fields=id,name,property.*,documents.type

200Retrieved

1 [
2   {
3     "alarmCode": "alarmCode",
4     "assignedUserId": "assignedUserId",
5     "attachmentIds": "attachmentIds",
6     "attachments": [
7       {
8         "name": "name",
9         "url": "url",
10         "type": "ISSUE",
11         "createdAt": "2024-01-15T09:30:00Z",
12         "updatedAt": "2024-01-15T09:30:00Z",
13         "workOrderId": "workOrderId",
14         "propertyId": "propertyId",
15         "organizationId": "organizationId"
16       }
17     ],
18     "completedAt": "2024-01-15T09:30:00Z",
19     "createdAt": "createdAt",
20     "customer": {
21       "firstName": "firstName",
22       "middleName": "middleName",
23       "lastName": "lastName",
24       "preferredName": "preferredName",
25       "suffix": "suffix",
26       "birthDate": "birthDate",
27       "status": "APPLICANT",
28       "email": "email",
29       "phone": "phone",
30       "gender": "gender",
31       "headOfHousehold": true,
32       "relationship": "PARTNER",
33       "id": "id",
34       "readableId": "readableId",
35       "idempotencyId": "idempotencyId",
36       "createdAt": "2024-01-15T09:30:00Z",
37       "updatedAt": "2024-01-15T09:30:00Z",
38       "deletedAt": "2024-01-15T09:30:00Z",
39       "householdId": "householdId",
40       "propertyId": "propertyId",
41       "organizationId": "organizationId"
42     },
43     "customerId": "customerId",
44     "deletedAt": "2024-01-15T09:30:00Z",
45     "description": "description",
46     "doorCode": "doorCode",
47     "dueDate": "dueDate",
48     "entryNotes": "entryNotes",
49     "entryPreference": "24_HOUR_NOTICE",
50     "hasPetAlert": true,
51     "holdReason": "holdReason",
52     "hourlyServiceRate": 1.1,
53     "household": {
54       "status": "APPLICANT",
55       "isUnderEviction": true,
56       "id": "id",
57       "readableId": "readableId",
58       "idempotencyId": "idempotencyId",
59       "createdAt": "2024-01-15T09:30:00Z",
60       "updatedAt": "2024-01-15T09:30:00Z",
61       "deletedAt": "2024-01-15T09:30:00Z",
62       "currentUnitId": "currentUnitId",
63       "currentLeaseId": "currentLeaseId",
64       "applicationId": "applicationId",
65       "organizationId": "organizationId",
66       "propertyId": "propertyId",
67       "currentCertificationId": "currentCertificationId",
68       "prospectId": "prospectId",
69       "primaryCustomerId": "primaryCustomerId",
70       "totalActiveRentAmount": 1.1,
71       "totalActiveSubsidyAmount": 1.1,
72       "totalActiveFeesAmount": 1.1,
73       "unitId": "unitId"
74     },
75     "householdId": "householdId",
76     "id": "id",
77     "idempotencyId": "idempotencyId",
78     "isAlarmActive": true,
79     "isDoorCodeActive": true,
80     "maintenanceIssue": {
81       "description": "description",
82       "type": "UNIT",
83       "id": "id",
84       "readableId": "readableId",
85       "idempotencyId": "idempotencyId",
86       "createdAt": "2024-01-15T09:30:00Z",
87       "updatedAt": "2024-01-15T09:30:00Z",
88       "deletedAt": "2024-01-15T09:30:00Z",
89       "organizationId": "organizationId",
90       "propertyId": "propertyId",
91       "categoryId": "categoryId"
92     },
93     "maintenanceIssueId": "maintenanceIssueId",
94     "maintenanceLocation": {
95       "name": "name",
96       "type": "UNIT",
97       "id": "id",
98       "readableId": "readableId",
99       "idempotencyId": "idempotencyId",
100       "createdAt": "2024-01-15T09:30:00Z",
101       "updatedAt": "2024-01-15T09:30:00Z",
102       "deletedAt": "2024-01-15T09:30:00Z",
103       "organizationId": "organizationId",
104       "propertyId": "propertyId"
105     },
106     "maintenanceLocationId": "maintenanceLocationId",
107     "organizationId": "organizationId",
108     "otherLocationDetail": "otherLocationDetail",
109     "previouslyReported": true,
110     "priority": "LOW",
111     "property": {
112       "name": "name",
113       "shortName": "shortName",
114       "email": "email",
115       "phone": "phone",
116       "physicalStreetAddress1": "physicalStreetAddress1",
117       "physicalStreetAddress2": "physicalStreetAddress2",
118       "physicalCity": "physicalCity",
119       "physicalState": "physicalState",
120       "physicalZip": "physicalZip",
121       "physicalCountry": "physicalCountry",
122       "mailingStreetAddress1": "mailingStreetAddress1",
123       "mailingStreetAddress2": "mailingStreetAddress2",
124       "mailingCity": "mailingCity",
125       "mailingState": "mailingState",
126       "mailingZip": "mailingZip",
127       "mailingCountry": "mailingCountry",
128       "phoneNumber": "phoneNumber",
129       "faxNumber": "faxNumber",
130       "timezone": "timezone",
131       "longitude": 1.1,
132       "latitude": 1.1,
133       "turnMoveOutDays": 1,
134       "organizationId": "organizationId",
135       "id": "id",
136       "readableId": "readableId",
137       "idempotencyId": "idempotencyId",
138       "createdAt": "2024-01-15T09:30:00Z",
139       "updatedAt": "2024-01-15T09:30:00Z",
140       "deletedAt": "2024-01-15T09:30:00Z",
141       "offboardedAt": "2024-01-15T09:30:00Z",
142       "countyName": "countyName",
143       "acquisitionDate": "2024-01-15T09:30:00Z"
144     },
145     "propertyId": "propertyId",
146     "readableId": "readableId",
147     "requestedStartDateFrom": "requestedStartDateFrom",
148     "requestedStartDateTo": "requestedStartDateTo",
149     "requestedStartTimeFrom": "requestedStartTimeFrom",
150     "requestedStartTimeTo": "requestedStartTimeTo",
151     "requestorEmail": "requestorEmail",
152     "requestorPhone": "requestorPhone",
153     "serviceNotes": "serviceNotes",
154     "status": "OPEN",
155     "technicianNotes": "technicianNotes",
156     "totalAmountOwedByProperty": 1.1,
157     "totalAmountOwedByResident": 1.1,
158     "totalCostOfMaterialsUsed": 1.1,
159     "totalLaborCost": 1.1,
160     "unit": {
161       "number": "number",
162       "floorLevel": "floorLevel",
163       "isADA": true,
164       "status": "VACANT_READY",
165       "floorPlanId": "floorPlanId",
166       "propertyId": "propertyId",
167       "organizationId": "organizationId",
168       "buildingId": "buildingId",
169       "currentHouseholdId": "currentHouseholdId",
170       "lastMoveOutId": "lastMoveOutId",
171       "priorLeaseId": "priorLeaseId",
172       "id": "id",
173       "readableId": "readableId",
174       "idempotencyId": "idempotencyId",
175       "createdAt": "2024-01-15T09:30:00Z",
176       "updatedAt": "2024-01-15T09:30:00Z",
177       "deletedAt": "2024-01-15T09:30:00Z",
178       "vacantSince": "2024-01-15T09:30:00Z",
179       "reportOrder": 1.1,
180       "makeReadyDate": "makeReadyDate",
181       "reportConfigurationValue": "Quoting Rent",
182       "lastVacancyStartDate": "lastVacancyStartDate",
183       "mostRecentApplicationId": "mostRecentApplicationId"
184     },
185     "unitId": "unitId",
186     "updatedAt": "2024-01-15T09:30:00Z",
187     "user": {
188       "firstName": "firstName",
189       "lastName": "lastName",
190       "email": "email",
191       "username": "username",
192       "status": "ACTIVE",
193       "hasAllProperties": true,
194       "id": "id",
195       "readableId": "readableId",
196       "idempotencyId": "idempotencyId",
197       "createdAt": "2024-01-15T09:30:00Z",
198       "updatedAt": "2024-01-15T09:30:00Z",
199       "deletedAt": "2024-01-15T09:30:00Z",
200       "organizationId": "organizationId",
201       "propertyIds": "propertyIds"
202     },
203     "vendorNotes": "vendorNotes"
204   }
205 ]

List all Work Orders

Query parameters

fieldsstringOptionalformat: "^([a-zA-Z\.],?)+$"

Specific fields requested in the response. Defaults to all fields.

sortstringOptionalformat: "^([a-zA-Z]+(:(asc|desc)+)?,?)+$"

CSV of sort value pairs by field (eg. date:asc). Sorts descending date fields by default and ascending elsewhere

filterstringOptional

Filter expression as defined by Fortress Query Language (FQL)

pageintegerOptionalDefaults to 0

the page number when used with pagination, defaults to 0

limitintegerOptionalDefaults to 10

How many items to return at one time (default 10)

Response

A paged array of work orders

alarmCodestring

assignedUserIdstringformat: "uuid"

attachmentIdsstringformat: "uuid"

attachmentslist of objects

completedAtdatetime

createdAtstring

customerobject

customerIdstringformat: "uuid"

deletedAtdatetime

descriptionstring<=500 characters

doorCodestring

dueDatestringformat: "date"

entryNotesstring<=500 characters

entryPreferenceenum

Allowed values:

hasPetAlertboolean

holdReasonstring

hourlyServiceRatedouble

The hourly service rate.

householdobject

householdIdstringformat: "uuid"

idstringformat: "uuid"

idempotencyIdstringformat: "uuid"

isAlarmActiveboolean

isDoorCodeActiveboolean

maintenanceIssueobject

maintenanceIssueIdstringformat: "uuid"

maintenanceLocationobject

maintenanceLocationIdstringformat: "uuid"

organizationIdstringformat: "uuid"

otherLocationDetailstring<=500 characters

previouslyReportedboolean

If the Issue was previously reported, this will be true.

priorityenum

Allowed values:

propertyobject

propertyIdstringformat: "uuid"

readableIdstring

requestedStartDateFromstringformat: "date"

requestedStartDateTostringformat: "date"

requestedStartTimeFromstring

requestedStartTimeTostring

requestorEmailstring

requestorPhonestring

serviceNotesstring<=2000 characters

statusenum

Allowed values:

technicianNotesstring<=500 characters

Notes to the technician.

totalAmountOwedByPropertydouble

The total amount owed by the property.

totalAmountOwedByResidentdouble

The total amount owed by the resident.

totalCostOfMaterialsUseddouble

The total cost of materials used.

totalLaborCostdouble

The total labor cost.

unitobject

unitIdstringformat: "uuid"

updatedAtdatetime

userobject

vendorNotesstring<=2000 characters