Get the applications dashboard

Returns the company-wide rental-application dashboard: how many applications sit in each pipeline stage, what needs attention, throughput metrics for the last 30 days, and generated observations. Requires the rental_applications:read permission.

GET

https://services.magicdoor.com/leasing/company-portal/rental-applications/command-center

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 dashboard.

pipelineobject

How applications are spread across the four pipeline stages.

actionQueueBucket[]

Attention buckets that currently have at least one application, most urgent first. Empty buckets are left out, and the unpaid bucket is left out entirely when the company does not charge an application fee.

velocityobject

Throughput metrics. The two 30-day figures use rolling windows; the two monthly figures use calendar months in the company's timezone.

insightsInsight[]

Generated observations about the pipeline, ready to display.

401 · The access token is missing, expired, or not valid.

403 · The caller is authenticated but does not hold the `rental_applications:read` permission.

Cached for 30 seconds

The dashboard is held for 30 seconds per user, so calls made in quick succession return the same figures.

{ "pipeline": { "stages": [ { "key": "draft", "count": 12, "oldestDays": 21 }, { "key": "submitted", "count": 8, "oldestDays": 6 }, { "key": "screened", "count": 5, "oldestDays": 9 }, { "key": "decided", "count": 31, "oldestDays": 44 } ], "activeCount": 56 }, "actionQueue": [ { "kind": "decisionOverdue", "count": 2, "urgency": "critical", "topApplications": [ { "id": "1830472847398404096", "firstName": "Marisol", "lastName": "Duarte" } ] }, { "kind": "readyToConvert", "count": 3, "urgency": "positive", "topApplications": [ { "id": "1830472901847362560", "firstName": "Rowan", "lastName": "Ellis" } ] } ], "velocity": { "avgTimeToDecisionDays": 4.2, "approvalRate30d": 0.6667, "convertedThisMonth": 6, "feesCollectedMtdCents": 33000, "deltas": { "avgTimeToDecisionDays": -0.8, "approvalRate30d": 0.0417, "convertedThisMonth": 2, "feesCollectedMtdCents": 11000 } }, "insights": [ { "key": "decision-backlog", "tone": "warning", "headline": "Two applications have been waiting on a decision for over five days", "detail": "Both cleared screening last week and nothing has been recorded since." } ] }