# leases_list

> Search the user's leases by status, lease_type, party, or free-text query.

<!-- Source: https://docs.actuallycare.com/tools/leases/leases_list -->

Search the user's leases by status, lease_type, party, or free-text query. Returns id, lease_start, lease_end, monthly_rent, status, lease_type, renter_client_id, landlord_contact_id, listing_id. Use status='expiring' or the dedicated [`leases_expiring`](/tools/leases/leases_expiring) tool to find leases ending soon — the dedicated view is more useful when looking for renewal opportunities. Pagination: total_count + has_more + offset + limit.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | No | Free-text search (reserved — not currently indexed; use specific filters instead) |
| `status` | enum | No | Filter by lease status. active=currently occupied, expiring=within renewal window, renewed=has successor lease, terminated=ended early, expired=passed lease_end with no renewal · One of: `draft`, `active`, `expiring`, `renewed`, `terminated`, `expired` |
| `lease_type` | enum | No | Filter by lease type · One of: `residential`, `commercial`, `short_term` |
| `renter_client_id` | string | No | Filter to leases for a specific renter (client). Use [`clients_list`](/tools/clients/clients_list) with client_type=tenant to find tenants first. · Format: UUID |
| `landlord_contact_id` | string | No | Filter to leases for a specific landlord (contact). Use [`contacts_list`](/tools/contacts/contacts_list) with leasing_role=landlord to find landlords first. · Format: UUID |
| `listing_id` | string | No | Filter to leases for a specific listing · Format: UUID |
| `limit` | number | No | Maximum results (default: 25) · Max: 500 · Min: 1 |
| `offset` | number | No | Skip N results for pagination (default: 0) · Min: 0 |

## Example prompts

- "List all my active residential leases with their monthly rent."
- "Show every lease tied to the 88 Calloway Ave listing."

## Safety

**Read-only.** This tool never changes your data — it only looks things up. Safe to run anytime.