Maintenance requests

Get maintenance request counts

Returns how many of the company's maintenance requests sit in each state, for a dashboard tile. The numbers are cached for 15 minutes, so a request you just filed may not be counted yet — cacheDate tells you when they were taken. Requires the maintenance_requests:read permission.

GET
https://services.magicdoor.com/maintenance/company-portal/maintenance-requests/stats

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.

Response

200 · The counts.

allOpenintegerrequired

Requests in any state other than closed.

newRequestsintegerrequired

Requests that are not closed and were filed inside the company's recent-requests window.

waitingForWorkOrderintegerrequired

Requests triaged but with no job scheduled yet.

aiProcessingintegerrequired

Requests MagicDoor is still reading.

inProgressintegerrequired

Requests being worked on.

pendingintegerrequired

Requests waiting to be looked at.

closedintegerrequired

Requests that are closed.

cacheDatestring · date-timerequired

When these numbers were counted. Unlike most timestamps in this API, this one carries a UTC offset.

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.