List saved service order lists
List the caller's own saved service order lists, in the order given by position. Saved lists are personal: only the user who created a list ever sees it, and this endpoint never returns anyone else's lists. A list holds filters in the same shape as a service order search request — send them to the tenant-level service order search endpoint to open the list, or to the service order counts endpoint to get the number on its dashboard card. Both reach every service order of the tenant and run the same filters, so a card's number and the list it opens always agree; a list that is to cover only some stores says so with storeUids in its own filters, or with createdFromStoreUids when it is to hold what a store took in rather than what it owns. The filters are semantic rather than a raw query, so a list keeps working when the configuration changes underneath it: one filtering on a status that has since been deactivated still returns whatever is on that status. The same lists are there on every device the user signs in on or unlocks.
Required permissions: SERVICE_ORDER
Access token recevied after user login with a deviceToken
Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a specific page in a result set.
The number of items per page in a result set.
Example response
GET /v2/tenants/{tenantUid}/serviceorders/savedlists HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Example response
{
"items": [
{
"savedListUid": "text",
"tenantUid": "text",
"tenantUserUid": "text",
"name": "text",
"filters": {
"customerName": "text",
"customerMobile": "text",
"customerEmail": "text",
"title": "text",
"serviceNumber": "text",
"query": "text",
"fromCreatedDate": "2026-01-01",
"toCreatedDate": "2026-01-01",
"assignedUserUids": [
"text"
],
"createdFromStoreUids": [
"text"
],
"priorities": [
"HIGHEST"
],
"serviceStates": [
"AWAITING_PRODUCT"
],
"open": true,
"serviceTypeUids": [
"text"
],
"storeUids": [
"text"
],
"serviceStatusUids": [
"text"
],
"fromReadyAtEstimate": "2026-01-01T00:00:00.000Z",
"toReadyAtEstimate": "2026-01-01T00:00:00.000Z",
"overdue": true,
"serial": "text",
"serviceJobTypeUids": [
"text"
],
"externalServiceNumber": "text",
"claimNumber": "text",
"externalSalesOrderNumber": "text",
"customerNumber": "text",
"customerUids": [
"text"
],
"productUids": [
"text"
],
"coverages": [
"PAYABLE"
],
"fromFinishedDate": "2026-01-01",
"toFinishedDate": "2026-01-01",
"formValueFilters": [
{
"fieldKey": "text",
"value": "text"
}
]
},
"sortBy": "text",
"sortDirection": "ASC",
"position": 1,
"showAsCard": true,
"createdAt": "2026-01-01T00:00:00.000Z",
"createdBy": "text",
"lastModifiedAt": "2026-01-01T00:00:00.000Z",
"lastModifiedBy": "text"
}
],
"paging": {
"pageNumber": 1,
"pageSize": 1,
"totalCount": 1
}
}Last updated
Was this helpful?

