Lease renewals

List a lease's renewal offers

Returns a page of renewal offers on one lease, newest work first, together with the lease, property and unit they belong to.

GET

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

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. A Snowflake id, sent as a decimal string.

example: 1830472847398404096

Query parameters

pageinteger

Which page to return. Starts at 1.

default: 1example: 1

pageSizeinteger

How many rows per page, between 1 and 100.

default: 50example: 50

statusesenum<string>[]

Only offers in any of these states.

offeredsigningfinalizedrejectedretracted

Response

200 · A page of renewal offers on this lease.

itemsLeaseRenewalOffer[]

The rows on this page.

currentPageinteger

The page you asked for. Pages start at 1.

totalPagesinteger

How many pages exist at this page size.

pageSizeinteger

How many rows a page holds.

totalCountinteger

How many rows match in total, across all pages.

chartOfAccountsChartOfAccount[]

Chart-of-account records referenced above.

leasesLease[]

The lease the offers are on.

propertiesProperty[]

The property the lease is on.

unitsUnit[]

The unit the lease is on.

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.

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

Offers and the standing policy are different things

A renewal offer is one proposal on one lease: a new end date and the rent changes that go with it. The automatic-renewal settings are a standing policy for a portfolio, a property, or the whole company, which MagicDoor uses to raise those offers for you. Changing the policy does not change offers that already exist. The two live under different endpoints — see Automatic renewals.

Request

curl --request GET \
  --url 'https://api.portal.magicdoor.com/company-app/leases/1830472847398404096/renewals?page=1&pageSize=50' \
  --header 'Authorization: Bearer <token>'

Response

{
  "items": [
    {
      "id": "1841029384756201984",
      "status": "offered",
      "requiresSigning": true,
      "recurringChargeChanges": [
        {
          "recurringChargeId": "1840193847562019840",
          "newAmount": 1950,
          "newDescription": "Monthly rent"
        }
      ],
      "newRecurringCharges": [],
      "newEndDate": "2028-02-29",
      "leaseDocumentId": "1842019384756201984",
      "finalized": false,
      "offerExpires": "2026-12-31",
      "currentCharges": [
        {
          "id": "1840193847562019840",
          "amount": 1850,
          "chargeFrequency": "monthly",
          "chartOfAccountId": "1826638475620198400",
          "description": "Monthly rent",
          "companyCharge": false,
          "startFrom": "2026-03-01",
          "end": "2027-02-28",
          "status": "active",
          "chartOfAccount": {
            "id": "1826638475620198400",
            "number": 4000,
            "type": "revenue",
            "name": "Rent income",
            "creator": {
              "type": "system",
              "source": "direct"
            },
            "isDefault": true
          }
        }
      ],
      "templates": [
        {
          "kind": "pdf",
          "id": "1843019384756201984"
        }
      ],
      "automaticallyCreated": false,
      "leaseId": "1830472847398404096",
      "propertyId": "1829933847562019840",
      "unitId": "1832019384756201984"
    }
  ],
  "currentPage": 1,
  "totalPages": 1,
  "pageSize": 50,
  "totalCount": 2,
  "chartOfAccounts": [
    {
      "id": "1826638475620198400",
      "number": 4000,
      "type": "revenue",
      "name": "Rent income",
      "creator": {
        "type": "system",
        "source": "direct"
      },
      "isDefault": true
    }
  ],
  "leases": [
    {
      "id": "1830472847398404096",
      "portfolioId": "1827741029384756224",
      "propertyId": "1829933847562019840",
      "unitId": "1832019384756201984",
      "start": "2026-03-01",
      "end": "2027-02-28",
      "ended": false,
      "monthToMonth": false,
      "eviction": false,
      "chatId": "1830472847398500000",
      "balance": 1850,
      "postedBalance": 1850,
      "currentRent": 1850,
      "securityDepositPaid": 1850,
      "securityDepositRequested": 1850,
      "securityDepositDue": 0,
      "lastPaymentDate": "2026-07-01",
      "earliestUnpaidBillDueDate": "2026-08-01",
      "pastDueDays": 16,
      "icons": [],
      "draft": false,
      "status": "lease",
      "expiringStatus": "none",
      "tenants": [
        {
          "tenantId": "1831856473920184832",
          "moveIn": "2026-03-01"
        }
      ]
    }
  ],
  "properties": [
    {
      "id": "1829933847562019840",
      "name": "Elm Street Apartments",
      "displayName": "Elm Street Apartments",
      "address": {
        "streetAddress1": "418 Elm Street",
        "city": "Portland",
        "state": "OR",
        "zipCode": "97204",
        "country": "US",
        "isValid": true
      },
      "portfolioId": "1827741029384756224",
      "type": "multiFamily",
      "unitCount": 24,
      "recentRentalApplications": 3,
      "active": true,
      "icons": []
    }
  ],
  "units": [
    {
      "id": "1832019384756201984",
      "name": "4B",
      "address": {
        "streetAddress1": "418 Elm Street",
        "city": "Portland",
        "state": "OR",
        "zipCode": "97204",
        "country": "US",
        "isValid": true
      },
      "beds": 2,
      "baths": 1,
      "unitSizeSqft": 880,
      "marketRent": 1850,
      "floor": 4,
      "propertyId": "1829933847562019840",
      "portfolioId": "1827741029384756224",
      "active": true,
      "icons": []
    }
  ]
}