Leases

Get the default first charge date

Works out the date MagicDoor would raise the first recurring charge for a lease starting on the date you give. Use it to prefill the charge start when you are building a lease.

GET

https://api.portal.magicdoor.com/company-app/leases/next-charge-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

leaseStartDatestring · daterequired

The lease's first day.

example: 2026-03-15

Response

200 · The date the first charge would fall on.

datestring · date

The first charge date, in the company's timezone.

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/next-charge-date?leaseStartDate=2026-03-15' \
  --header 'Authorization: Bearer <token>'

Response

{
  "date": "2026-04-01"
}