Resident benefit packages

Get resident benefit earnings

Returns what the resident benefit program is earning the company today, and what it would earn if every active lease enrolled. Requires the resident_benefit_packages:read permission.

GET
https://services.magicdoor.com/productexperiences/company-portal/resident-benefit-packages/earnings

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 · Earnings today and the ceiling per package.

activeLeaseCountintegerrequired

How many leases on the company are neither draft nor ended. It is the base for the potential figures.

activeEnrollmentCountintegerrequired

How many enrollments are active. Enrollments still pendingActivation are not counted here.

packagesobject[]required

One entry per package the company has authored.

actualMonthlyRevenuenumber

What active enrollments actually bill each month, using each one's effective price rather than the list price.

actualMonthlyCostnumber

What MagicDoor charges for those same active enrollments each month.

actualMonthlyCustomLineCostnumber

What the custom lines on those same enrollments cost each month.

actualMonthlyProfitnumber

actualMonthlyRevenue minus actualMonthlyCost minus actualMonthlyCustomLineCost.

401 · The request carried no valid access token.

403 · The caller is not a property manager, or is missing the `resident_benefit_packages:read` permission.