Damage waivers

Get damage waiver settings

Returns the company's damage waiver program settings. A damage waiver is not insurance: it is a monthly fee a tenant pays instead of carrying a renters policy, and this is where the fee, the grace period, and the accounts it posts to are configured.

GET
https://services.magicdoor.com/tenantinsurance/company-portal/insurance/damage-waivers/settings

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 company's settings. A company that has never touched them gets the defaults back rather than an error.

companyIdstring

The company these settings belong to.

enrolledInDamageWaiverProgramboolean

True when the company runs the damage waiver program. While it is on, MagicDoor sends the insurance notices and enrolls uninsured leases once their grace period ends.

enrollmentDatestring · date-time

When the company first turned the program on. Leases that started before this date are never enrolled automatically and need a notice campaign. Absent when the company has never enrolled.

monthlyFeenumber

The monthly damage waiver fee charged to a tenant, in dollars. Defaults to 23.00 until changed.

gracePeriodInDaysinteger

How many days a tenant gets to upload their own insurance after a notice before the waiver is applied. Defaults to 7.

recurringLeaseChargeChartOfAccountIdstring

The revenue account the monthly tenant charge is posted to.

companyExpenseChartOfAccountIdstring

The expense account used when MagicDoor bills the company for its damage waiver enrollments.

damageWaiverCostnumber

What MagicDoor charges the company per enrolled lease each month, in dollars. Compare it with monthlyFee to see the company's margin.

unitCountinteger

The unit count recorded on the company's onboarding record. 0 when there is no onboarding record.

createdstring · date-time

When the settings record was created.

updatedstring · date-time

When the settings last changed.

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