Recurring work orders

List recurring work orders

Returns a page of recurring work orders — the schedules that raise a work order automatically every so often, for jobs like quarterly filter changes. These are the schedules, not the work orders they produce. Requires the work_orders:read permission.

GET

https://services.magicdoor.com/maintenance/company-portal/work-orders/recurring

Authorization

Authorizationstringrequired

Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Query parameters

pageinteger

Which page to return. Counting starts at 1.

default: 1

pageSizeinteger

How many schedules to return per page. Between 1 and 100.

default: 50

portfolioIdsstring[]

Only schedules in these portfolios. Repeat the parameter for more than one.

propertyIdsstring[]

Only schedules on these properties.

unitIdsstring[]

Only schedules on these units.

vendorIdsstring[]

Only schedules sending work to these vendors.

activeboolean

true returns only schedules still raising work; false only stopped ones.

searchstring

Free-text search across the schedule.

Response

200 · One page of recurring work orders.

itemsobject[]required

The schedules on this page.

totalCountintegerrequired

How many schedules match in total.

totalPagesintegerrequired

How many pages there are at this page size.

pageintegerrequired

The page that was returned. Counting starts at 1.

pageSizeintegerrequired

How many schedules were asked for per page.

401 · The request carried no valid access token.

403 · The token is not a property manager token, or it lacks the `work_orders:read` permission.

Request

curl --request GET \
  --url 'https://services.magicdoor.com/maintenance/company-portal/work-orders/recurring' \
  --header 'Authorization: Bearer <token>'

Response

{
  "items": [
    {
      "id": "1838400938471029248",
      "portfolioId": "1819900472910049280",
      "propertyId": "1820045738291004416",
      "unitId": "1820045738291004928",
      "vendor": {
        "id": "1826110384726355968",
        "name": "Harbor Plumbing Co.",
        "active": true,
        "contact": {
          "phone": "+13105550142",
          "email": "dispatch@harborplumbing.example"
        }
      },
      "location": {
        "propertyName": "Sunset Apartments",
        "unitName": "Unit 4B",
        "address": {
          "streetAddress1": "418 Harbor View Drive",
          "city": "Santa Monica",
          "state": "CA",
          "zipCode": "90401",
          "country": "US",
          "isValid": true
        }
      },
      "assignedPropertyManagerId": "1799442038571110400",
      "title": "Quarterly HVAC filter change",
      "description": "Replace the filters on the roof-top unit and log the reading.",
      "urgency": "low",
      "permissionToEnter": true,
      "frequency": "monthly",
      "interval": 3,
      "weekdays": [],
      "workSessionTemplates": [
        {
          "timeOfDay": "09:00:00",
          "durationMinutes": 60
        }
      ],
      "startsFrom": "2026-01-05",
      "nextDueDate": "2026-10-05",
      "lastCreatedOn": "2026-07-05T00:03:12",
      "active": true,
      "created": "2025-12-18T16:20:04"
    }
  ],
  "totalCount": 8,
  "totalPages": 1,
  "page": 1,
  "pageSize": 50
}