> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voqo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Leased Listings

> Retain leased rentals in your Knowledge Base with weekly rent, lease term, and lease end dates — and give your AI agent accurate rental history to reference on calls.

## What are leased listings?

When a rental property you list on a connected CRM or portal is leased to a tenant, Voqo AI keeps it in your **Knowledge Base** as a leased listing. Previously, leased rentals were silently removed once the tenancy started. Now they stay — so your AI agent can answer "What's the rent on 12 King Street now that it's leased?" with real data, and you can search your leased history without leaving Voqo.

Leased listings are **opt-in per integration**. Tick **Leased listings** on your **realestate.com.au**, **Eagle MRI**, **AgentBox**, **VaultRE**, or **Domain** integration settings to enable them.

***

## The Leased badge

Leased listings display a **Leased** badge on the listing card, alongside the weekly rent (where available) and the lease start date. They appear in the **For Lease** archive tab in your Knowledge Base.

<Note>
  **Smart-list naming — `Lease Properties` vs `Leased Properties`** — these are different lists. **Lease Properties** is your current rental stock that is **available to lease right now**. **Leased Properties** is the archive of rentals that have **already been leased out** to a tenant. Pick the one that matches your use case.
</Note>

***

## What appears on a leased listing — per integration

Different integrations expose different fields on leased rentals. Voqo shows you the deepest information your data source provides, and explicitly tells you when a field is unavailable rather than hiding the gap.

| Field                   | realestate.com.au                    | Eagle MRI                   | AgentBox | VaultRE | Domain                      |
| ----------------------- | ------------------------------------ | --------------------------- | -------- | ------- | --------------------------- |
| **Leased badge**        | Yes                                  | Yes                         | Yes      | Yes     | Yes                         |
| **Lease start date**    | Listing modification date (fallback) | Yes                         | Yes      | Yes     | Yes                         |
| **Weekly rent**         | Not provided                         | Yes                         | Yes      | Yes     | Yes                         |
| **Lease term (months)** | Not provided                         | Derived (weeks ÷ 4.345)     | Yes      | Yes     | Derived (weeks ÷ 4.345)     |
| **Lease end date**      | Not provided                         | Derived (start + weeks × 7) | Yes      | Yes     | Derived (start + weeks × 7) |

If a field shows **"Not provided"** in the Knowledge Base, that means the source CRM or portal does not surface it in their feed — it is not a Voqo limitation. Your AI agent is told to phrase the leased listing without claiming a rent or end-date it doesn't actually know.

### Domain — derived lease end date caveat

Domain publishes the lease start date and weekly rent directly, plus a lease duration. Voqo derives the lease term in months and the lease end date from that duration (`start + duration`). As with Eagle MRI, the derived end date is accurate for **fresh leases** but will drift on **renewals** or **early termination** — Domain doesn't refresh the original duration when a tenancy changes. For ground-truth end dates after a renewal, check Domain directly. Your AI agent is prompted to phrase lease-end dates with appropriate caveats.

### Eagle MRI — derived lease end date caveat

Eagle MRI's API does not expose a direct lease end date. Voqo derives the end date from the original `letDate` plus `leasedDurationInWeeks × 7 days`. This is accurate for **fresh leases**, but will drift on **lease renewals** or **early termination** — Eagle doesn't update the original duration field when a tenancy is extended or cut short.

If you need ground-truth lease end dates after renewals or terminations, check Eagle directly. Your AI agent is prompted to phrase lease-end dates with appropriate caveats.

***

## Smart list behaviour with leased listings

Voqo's smart lists respond to leased state automatically.

**State-based lists** (Lease Properties, Under Offer Properties) **automatically drop a rental** when it becomes leased. Lease Properties shows your current rental inventory, so a leased property no longer belongs there.

**State-agnostic lists** (Houses, Apartments, Family Homes) **keep leased listings**. A leased apartment is still an apartment — these lists describe property attributes, not market status.

**Manual lists** (lists you build yourself) keep whatever you place in them. If you manually add a leased listing to a list, it stays there until you remove it or opt out of leased listings collection.

***

## The Leased Properties smart list template

Use the **Leased Properties** Quick Create template to build a list that automatically updates as new tenancies complete.

1. In the Knowledge Base, click **Create List**.
2. Under **Status**, select **Leased Properties**.
3. Give the list a name (for example, "Recent Bondi Rentals Leased").
4. Optionally apply sub-filters: listing agent or date range.
5. Save the list.

The list will include every leased rental in your workspace — across every connected integration where leased listings are enabled — and stay current without manual maintenance.

***

## Attaching leased listings to your AI agent

Attach a Leased Properties list to your AI agent so it can answer questions like *"What rentals have you leased recently in this suburb?"* or *"What's the rent on 12 King Street now that it's leased?"* with real data.

1. Open your **Agent Settings**.
2. Go to the knowledge list attachment section.
3. Add your Leased Properties list.
4. Save.

Your agent will now reference your leased rentals on calls, including weekly rent and (where available) lease term and end date.

***

## Visibility controls — hiding rent

If your agency needs to keep certain rents off-script (for example, confidential corporate lets), you can hide the rent from your AI agent per list without removing the listing itself.

1. Open the list in your Knowledge Base.
2. Click the **Visibility** settings for the list.
3. Toggle off **Weekly rent**.

The listing stays in the list and appears in the AI agent's context — but the rent is omitted from what the agent can quote.

***

## Enabling leased listings on each integration

Leased listings are **opt-in per integration**. To enable them on a connected integration:

1. Go to **Integrations** in the sidebar.
2. Click the integration card (or the **⋮** menu on the card).
3. Open **Settings**.
4. Tick **Leased listings**.
5. Click **Save**.

The next scheduled sync (or a manual resync) will pull your leased listings.

If you turn the toggle **off**, Voqo removes the leased listings synced from that integration from your workspace. Because this removes records, you'll see a **confirmation dialog** first — it tells you exactly how many listings will be removed and which manually managed lists they sit in before anything is deleted. **Nothing is lost permanently**: you can restore those listings any time by re-enabling the scope and running a sync.

### Choosing how far back to keep leased listings

When you enable **Leased listings** (or **Sold & off-market listings**) on **Domain**, **realestate.com.au**, or **VaultRE**, a **Historical listing window** selector appears in that integration's settings. It sets how far back Voqo keeps leased, sold, and off-market listings — **Last 1, 3, 6, 12 (default), or 24 months**, by the date each listing was last updated. Older leased listings roll off automatically once they fall outside the window; widening the window and running a sync brings them back. Your live rental stock is never affected.

For per-integration timing and behaviour:

* [realestate.com.au setup](../integrations/rea-setup)
* [Eagle MRI setup](../integrations/eagle-mri-setup)
* [AgentBox setup](../integrations/agentbox-setup)
* [VaultRE setup](../integrations/vaultre-setup)
* [Domain setup](../integrations/domain-setup)

***

## Troubleshooting

**I enabled leased listings but I don't see any in the For Lease archive.**

Leased listings appear after the next sync runs. If you just enabled the setting, click **Sync now** on the integration card or wait for the next scheduled sync.

**A leased listing shows no weekly rent.**

The source CRM or portal does not expose the rent on a leased rental. This is expected for **realestate.com.au** leased rentals. CRMs (Eagle MRI, AgentBox, VaultRE) publish the rent — if you need it, connect a CRM alongside REA.

**A leased listing's end date looks wrong after a renewal.**

If the listing is from **Eagle MRI**, the end date is derived from the original lease duration at the time the lease was created. Eagle doesn't refresh this when a tenancy is renewed or terminated early. Check Eagle directly for the ground-truth date. AgentBox and VaultRE publish the live lease end date and don't have this drift.

**A leased listing disappeared from my Lease Properties list.**

This is expected. Lease Properties shows your current rental inventory, so when a property is leased it drops out automatically. You can find it in the For Lease archive (with the Leased badge), or add it to a manual list if you want it in a specific place.

***

## Related docs

* [Sold Listings](sold-listings)
* [Pre-Market Listings](pre-market-listings)
* [realestate.com.au Setup](../integrations/rea-setup)
* [Eagle MRI Setup](../integrations/eagle-mri-setup)
* [AgentBox Setup](../integrations/agentbox-setup)
* [VaultRE Setup](../integrations/vaultre-setup)
* [Domain Setup](../integrations/domain-setup)
* [Knowledge Base Lists and Sources](../integrations/knowledge-base-integrations)
