Maintenance requests

Get a maintenance request's history

Returns a page of the audit trail for one maintenance request — who changed what, and when. Requires the maintenance_requests:read permission.

GET

https://services.magicdoor.com/maintenance/company-portal/maintenance-requests/{maintenanceRequestId}/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

maintenanceRequestIdstringrequired

The maintenance request to act on. A Snowflake id, sent as a decimal string.

example: 1841003948572119040

Query parameters

pageinteger

Which page to return. Counting starts at 1.

default: 1

pageSizeinteger

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

default: 50

Response

200 · One page of results.

itemsobject[]required

The history entries on this page.

totalCountintegerrequired

How many records match in total, across all pages.

totalPagesintegerrequired

How many pages there are at this page size.

pageintegerrequired

The page that was returned. Counting starts at 1.

pageSizeintegerrequired

How many records 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 `maintenance_requests:read` permission.

404 · No such maintenance request, or it belongs to another company.

Request

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

Response

{
  "items": [
    {
      "id": "1841300948572119040",
      "entityType": "maintenanceRequest",
      "type": "updated",
      "actor": {
        "type": "propertyManager",
        "id": "1799442038571110400",
        "name": "Dana Whitcomb"
      },
      "changes": [
        {
          "field": "Status",
          "oldValue": "Pending",
          "newValue": "InProgress",
          "changedAt": "2026-08-16T11:03:19"
        }
      ],
      "created": "2026-08-16T11:03:19"
    }
  ],
  "totalCount": 137,
  "totalPages": 3,
  "page": 1,
  "pageSize": 50
}