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       "organizationIssueId": "organizationIssueId",
85       "readableId": "readableId",
86       "idempotencyId": "idempotencyId",
87       "createdAt": "2024-01-15T09:30:00Z",
88       "updatedAt": "2024-01-15T09:30:00Z",
89       "deletedAt": "2024-01-15T09:30:00Z",
90       "organizationId": "organizationId",
91       "propertyId": "propertyId",
92       "categoryId": "categoryId",
93       "maintenanceLocationId": "maintenanceLocationId"
94     },
95     "maintenanceIssueId": "maintenanceIssueId",
96     "maintenanceLocation": {
97       "name": "name",
98       "type": "UNIT",
99       "id": "id",
100       "readableId": "readableId",
101       "idempotencyId": "idempotencyId",
102       "createdAt": "2024-01-15T09:30:00Z",
103       "updatedAt": "2024-01-15T09:30:00Z",
104       "deletedAt": "2024-01-15T09:30:00Z",
105       "organizationId": "organizationId",
106       "propertyId": "propertyId"
107     },
108     "maintenanceLocationId": "maintenanceLocationId",
109     "organizationId": "organizationId",
110     "otherLocationDetail": "otherLocationDetail",
111     "previouslyReported": true,
112     "priority": "LOW",
113     "property": {
114       "name": "name",
115       "shortName": "shortName",
116       "email": "email",
117       "phone": "phone",
118       "physicalStreetAddress1": "physicalStreetAddress1",
119       "physicalStreetAddress2": "physicalStreetAddress2",
120       "physicalCity": "physicalCity",
121       "physicalState": "physicalState",
122       "physicalZip": "physicalZip",
123       "physicalCountry": "physicalCountry",
124       "mailingStreetAddress1": "mailingStreetAddress1",
125       "mailingStreetAddress2": "mailingStreetAddress2",
126       "mailingCity": "mailingCity",
127       "mailingState": "mailingState",
128       "mailingZip": "mailingZip",
129       "mailingCountry": "mailingCountry",
130       "phoneNumber": "phoneNumber",
131       "faxNumber": "faxNumber",
132       "timezone": "timezone",
133       "longitude": 1.1,
134       "latitude": 1.1,
135       "turnMoveOutDays": 1,
136       "status": "ACTIVE",
137       "propertyClass": "Conventional",
138       "organizationId": "organizationId",
139       "id": "id",
140       "readableId": "readableId",
141       "idempotencyId": "idempotencyId",
142       "createdAt": "2024-01-15T09:30:00Z",
143       "updatedAt": "2024-01-15T09:30:00Z",
144       "deletedAt": "2024-01-15T09:30:00Z",
145       "offboardedAt": "2024-01-15T09:30:00Z",
146       "countyName": "countyName",
147       "acquisitionDate": "2024-01-15T09:30:00Z"
148     },
149     "propertyId": "propertyId",
150     "readableId": "readableId",
151     "requestedStartDateFrom": "requestedStartDateFrom",
152     "requestedStartDateTo": "requestedStartDateTo",
153     "requestedStartTimeFrom": "requestedStartTimeFrom",
154     "requestedStartTimeTo": "requestedStartTimeTo",
155     "requestorEmail": "requestorEmail",
156     "requestorPhone": "requestorPhone",
157     "serviceNotes": "serviceNotes",
158     "status": "OPEN",
159     "technicianNotes": "technicianNotes",
160     "totalAmountOwedByProperty": 1.1,
161     "totalAmountOwedByResident": 1.1,
162     "totalCostOfMaterialsUsed": 1.1,
163     "totalLaborCost": 1.1,
164     "unit": {
165       "number": "number",
166       "floorLevel": "floorLevel",
167       "isADA": true,
168       "streetAddress1": "streetAddress1",
169       "streetAddress2": "streetAddress2",
170       "city": "city",
171       "state": "state",
172       "zipCode": "zipCode",
173       "fullAddress": "fullAddress",
174       "status": "VACANT_READY",
175       "isOccupied": true,
176       "floorPlanId": "floorPlanId",
177       "propertyId": "propertyId",
178       "organizationId": "organizationId",
179       "buildingId": "buildingId",
180       "currentHouseholdId": "currentHouseholdId",
181       "lastMoveOutId": "lastMoveOutId",
182       "priorLeaseId": "priorLeaseId",
183       "id": "id",
184       "readableId": "readableId",
185       "idempotencyId": "idempotencyId",
186       "createdAt": "2024-01-15T09:30:00Z",
187       "updatedAt": "2024-01-15T09:30:00Z",
188       "deletedAt": "2024-01-15T09:30:00Z",
189       "vacantSince": "2024-01-15T09:30:00Z",
190       "reportOrder": 1.1,
191       "makeReadyDate": "makeReadyDate",
192       "reportConfigurationValue": "Quoting Rent",
193       "lastVacancyStartDate": "lastVacancyStartDate",
194       "mostRecentApplicationId": "mostRecentApplicationId"
195     },
196     "unitId": "unitId",
197     "updatedAt": "2024-01-15T09:30:00Z",
198     "user": {
199       "firstName": "firstName",
200       "lastName": "lastName",
201       "email": "email",
202       "username": "username",
203       "status": "ACTIVE",
204       "hasAllProperties": true,
205       "id": "id",
206       "readableId": "readableId",
207       "idempotencyId": "idempotencyId",
208       "createdAt": "2024-01-15T09:30:00Z",
209       "updatedAt": "2024-01-15T09:30:00Z",
210       "deletedAt": "2024-01-15T09:30:00Z",
211       "organizationId": "organizationId",
212       "propertyIds": "propertyIds"
213     },
214     "vendorNotes": "vendorNotes"
215   }
216 ]

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

alarmCodestringOptional

assignedUserIdstringOptionalformat: "uuid"

attachmentIdsstringOptionalformat: "uuid"

attachmentslist of objectsOptional

completedAtdatetimeOptional

createdAtstringOptional

customerobjectOptional

customerIdstringOptionalformat: "uuid"

deletedAtdatetimeOptional

descriptionstringOptional<=500 characters

doorCodestringOptional

dueDatestringOptionalformat: "date"

entryNotesstringOptional<=500 characters

entryPreferenceenumOptional

hasPetAlertbooleanOptional

holdReasonstringOptional

hourlyServiceRatedoubleOptional

The hourly service rate.

householdobjectOptional

householdIdstringOptionalformat: "uuid"

idstringOptionalformat: "uuid"

idempotencyIdstringOptionalformat: "uuid"

isAlarmActivebooleanOptional

isDoorCodeActivebooleanOptional

maintenanceIssueobjectOptional

maintenanceIssueIdstringOptionalformat: "uuid"

maintenanceLocationobjectOptional

maintenanceLocationIdstringOptionalformat: "uuid"

organizationIdstringOptionalformat: "uuid"

otherLocationDetailstringOptional<=500 characters

previouslyReportedbooleanOptional

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

priorityenumOptional

propertyobjectOptional

propertyIdstringOptionalformat: "uuid"

readableIdstringOptional

requestedStartDateFromstringOptionalformat: "date"

requestedStartDateTostringOptionalformat: "date"

requestedStartTimeFromstringOptional

requestedStartTimeTostringOptional

requestorEmailstringOptional

requestorPhonestringOptional

serviceNotesstringOptional<=2000 characters

statusenumOptional

technicianNotesstringOptional<=500 characters

Notes to the technician.

totalAmountOwedByPropertydoubleOptional

The total amount owed by the property.

totalAmountOwedByResidentdoubleOptional

The total amount owed by the resident.

totalCostOfMaterialsUseddoubleOptional

The total cost of materials used.

totalLaborCostdoubleOptional

The total labor cost.

unitobjectOptional

unitIdstringOptionalformat: "uuid"

updatedAtdatetimeOptional

userobjectOptional

vendorNotesstringOptional<=2000 characters