Work orders

Get a work order's history

Returns a page of the audit trail for one work order — who changed what, and when. Requires the work_orders:read permission.

GET

https://services.magicdoor.com/maintenance/company-portal/work-orders/{workOrderId}/history

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.

Path parameters

workOrderIdstringrequired

The work order to act on. A Snowflake id, sent as a decimal string.

example: 1841200938471029248

Query parameters

pageinteger

Which page to return. Counting starts at 1.

default: 1

pageSizeinteger

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

default: 50

Response

200 · One page of history entries.

itemsobject[]required

The history entries on this page.

totalCountintegerrequired

How many entries there are in total.

totalPagesintegerrequired

How many pages there are at this page size.

pageintegerrequired

The page that was returned.

pageSizeintegerrequired

How many entries 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.

404 · No such work order, or it belongs to another company.

Request

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

Response

{
  "items": [
    {
      "id": "1841700938471029248",
      "entityType": "workOrder",
      "type": "statusChanged",
      "actor": {
        "type": "propertyManager",
        "id": "1799442038571110400",
        "name": "Dana Whitcomb"
      },
      "changes": [
        {
          "field": "Status",
          "oldValue": "Pending",
          "newValue": "InProgress",
          "changedAt": "2026-08-16T11:20:55"
        }
      ],
      "created": "2026-08-16T11:20:55"
    }
  ],
  "totalCount": 6,
  "totalPages": 1,
  "page": 1,
  "pageSize": 50
}