Leases

Get a suggested lease end date

Returns the end date MagicDoor suggests for a lease starting on the date you give, so a new lease form can prefill it. Nothing is stored by this call.

GET

https://api.portal.magicdoor.com/company-app/leases/suggested-end-date

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.

Query parameters

startDatestring · daterequired

The lease's first day.

example: 2026-03-01

Response

200 · The suggested end date.

suggestedEndDatestring · date

The suggested last day of the term.

400 · The request failed validation. `errors` maps each field name to what was wrong with it.

401 · The access token is missing, expired, or not for this company.

Request

curl --request GET \
  --url 'https://api.portal.magicdoor.com/company-app/leases/suggested-end-date?startDate=2026-03-01' \
  --header 'Authorization: Bearer <token>'

Response

{
  "suggestedEndDate": "2027-02-28"
}