List leases
Leases with status, dates, rent and residents.
GET https://cotlet.dev/api/v1/resman/properties/{property_id}/leases
read
Returns one record per set of residents, with the lease in effect now: unit, status, start and end dates, rent and the main contacts. A set of residents that renewed shows its current lease, not each past one.
Parameters
| Name | Type | Description |
|---|---|---|
| property_id string required | string | Property id from list_properties. |
| status string | string | Pending, Pending Renewal, Pending Transfer, Denied, Cancelled, Current, Notice to Vacate, Month to Month, Under Eviction, Former, Evicted or Renewed. |
| ends_before string | string | Only leases that end before this date, YYYY-MM-DD. |
| modified_since string | string | Only leases changed since this date, YYYY-MM-DD. |
Request
curl https://cotlet.dev/api/v1/resman/properties/property_8c41d2/leases \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("resman", "list_leases", {"property_id":"property_8c41d2"})const result = await cotlet.call('resman', 'list_leases', {"property_id":"property_8c41d2"});cotlet call resman list_leases --data '{"property_id":"property_8c41d2"}'Example response
{
"leases": [
{
"lease_id": "550c2838-1fe5-443f-b1f0-4306e341601d",
"billing_account_id": "918f8290-5101-437f-8bd3-5cd846b6a964",
"unit_number": "214",
"status": "Notice to Vacate",
"lease_start_date": "2025-12-01",
"lease_end_date": "2026-11-30",
"rent": 2150,
"residents": [
"Tomas Weber"
]
}
]
}