MagicDoorAPI
SupportOpen MagicDoor
Damage waivers

Opt a lease out of the damage waiver

Takes a lease out of the damage waiver program, cancels any waiver in force, and drops any fee set for the lease. Because a property manager is doing it, the final pro-rata charge that a tenant-initiated opt-out would produce is skipped. Calling it on a lease that is already opted out changes nothing. Requires the leasing_insurance:write permission.

POST
https://services.magicdoor.com/tenantinsurance/company-portal/insurance/damage-waivers/leases/{leaseId}/opt-out

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

leaseIdstringrequired

The lease to opt out.

example: 1842910736482304512

Response

200 · The lease's damage waiver settings after the change.

leaseIdstring

The lease these settings are for.

isOptedOutboolean

True when this lease has been opted out of the damage waiver program.

statusenum<string>

Where the lease sits in the damage waiver flow. none is the resting state, including after the tenant produced their own insurance. inGracePeriod means a notice went out and the tenant still has time to upload proof of insurance. enrolled means the waiver is in force and being charged. cancelled means the waiver was called off, usually because other coverage took over.

noneinGracePeriodenrolledoptedOutcancelled
effectiveMonthlyFeenumber

The monthly fee this lease is actually charged, in dollars: the lease's own fee when it has one, otherwise the company's.

customMonthlyFeenumber

A fee set for this lease alone, in dollars. Absent when the lease uses the company fee.

companyMonthlyFeenumber

The company-wide damage waiver fee, in dollars.

recurringLeaseChargeChartOfAccountobject

The company's revenue account the monthly damage waiver charge is posted to.

gracePeriodEndsAtstring · date-time

When the tenant's window to upload their own insurance closes, after which the lease is enrolled in the waiver automatically. Absent when no grace period is running.

latestNoticeSentAtstring · date-time

When the most recent damage waiver notice went out. Absent when none has been sent.

noticeTypestring

Why the most recent notice was sent: Initial for a lease with no insurance, Expired when previous insurance ran out, Rejected when uploaded proof was turned down. Absent when no notice has been sent. Sent capitalised, unlike the enum values elsewhere in this API.

InitialExpiredRejected
nextChargeDatestring · date-time

When the next monthly damage waiver charge is due. Absent when no waiver is currently in force.

policyStartDatestring · date-time

When the current waiver started. Absent when none is in force.

policyEndDatestring · date-time

When the current waiver ends. Absent when none is in force or it has no end date.

401 · The access token is missing, expired, or not a company portal token.

403 · The token is valid but the caller does not hold the `leasing_insurance:write` permission.

404 · No such lease, or the lease belongs to another company.