Lease renewals

List renewal offer summaries

Returns a short line per renewal offer on the lease — status, new rent, new end date and expiry — for showing a list without pulling the full offer.

GET

https://api.portal.magicdoor.com/company-app/leases/{leaseId}/renewals/summaries

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 whose offers you want summarised. A Snowflake id, sent as a decimal string.

example: 1830472847398404096

Response

200 · The offer summaries.

offersLeaseRenewalOfferSummary[]

One line per offer.

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

404 · No lease matched the id, or it belongs to another company.

Request

curl --request GET \
  --url 'https://api.portal.magicdoor.com/company-app/leases/1830472847398404096/renewals/summaries' \
  --header 'Authorization: Bearer <token>'

Response

{
  "offers": [
    {
      "id": "1841029384756201984",
      "status": "offered",
      "newRent": 1950,
      "newEndDate": "2028-02-29",
      "month2Month": false,
      "offerExpires": "2026-12-31"
    }
  ]
}