Leases

List expiring leases

Returns a page of leases whose fixed term is coming to an end, so you can decide what to offer as a renewal. Each row carries its expiringStatus, which says how close the end date is.

GET

https://api.portal.magicdoor.com/company-app/leases/expiring

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

pageinteger

Which page to return. Starts at 1.

default: 1example: 1

pageSizeinteger

How many rows per page, between 1 and 100.

default: 50example: 50

portfolioIdsstring[]

Only leases in any of these portfolios.

propertyIdsstring[]

Only leases on any of these properties.

unitIdsstring[]

Only leases on any of these units.

Response

200 · A page of expiring leases.

itemsHydratedLease[]

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.

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/expiring?page=1&pageSize=50' \
  --header 'Authorization: Bearer <token>'

Response

{
  "items": [
    {
      "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": [
        {
          "tenant": {
            "id": "1831856473920184832",
            "active": true,
            "email": "dana.whitfield@example.com",
            "firstName": "Dana",
            "lastName": "Whitfield",
            "phone": "(503) 555-0142",
            "created": "2025-11-02T09:14:00",
            "updated": "2026-07-19T16:40:12",
            "portalStatus": "active",
            "language": "en",
            "icons": []
          },
          "moveIn": "2026-03-01",
          "isMovedOut": false
        }
      ],
      "unit": {
        "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": []
      },
      "property": {
        "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": []
      }
    }
  ],
  "currentPage": 1,
  "totalPages": 1,
  "pageSize": 50,
  "totalCount": 12
}