Understanding Lease Audit Results


Result Types

Lease Auditor compares each field in a lease with the rent roll and the control lease. Each field gets one of four results:

Result What it means What to do
Match Both sources have a value, and the values agree. For amounts, a blank and a zero count as the same value, so a blank and a zero, or two blanks, are a Match. No action needed.
Error Both sources have a value, but the values do not agree. Check the lease and the rent roll to find which value is correct.
Omission One source has a value and the other does not. For example, the rent roll charges a pet fee but the lease has no pet fee, or the lease has a fee that the rent roll does not bill. Check whether the charge is missing from the lease or from the rent roll. A missing addendum is a common cause.
Uncertain Pivott AI reads a value from the lease but is not confident it read it correctly. Open the lease and check the value by hand.

A flag only means two sources disagree. The wrong value could be in the lease, the rent roll, or the control lease.

How addresses are compared

Lease Auditor ignores formatting differences in addresses:

  • Common abbreviations count as the same word, for example Fl and Floor, Ste and Suite, Blvd and Boulevard, Apt and Apartment.
  • An address with a unit, suite or floor number matches the same address without one.
  • If both addresses have a unit, suite or floor number and the numbers are different, the field is still an Error.

Unit Status

Each unit in an audit gets a status:

  • Okay: every field is a Match. There are no Errors, Omissions, or Uncertain results.
  • Needs Review: the unit has at least one Error, Omission, or Uncertain result.
  • No Data: Pivott found no fields to compare for this unit.
  • Wrong Lease: the lease file probably belongs to a different resident or lease term. See Wrong Lease.
  • No lease on file: the unit is on the rent roll, but the audit has no lease file for it. You can't change this status. See Units With No Lease on File.

Your company may also have custom statuses. You can change a unit's status in two places:

  • On the Audits tab, open an audit and select a status in the unit's Status cell.
  • Open the unit and select a status from the menu at the top right.

Anyone with access to the property can change a unit's status.

Results from audits that ran before October 2, 2026 do not change on their own. To apply the new rules to an older audit, click Re-Run Audit.


Wrong Lease

Lease Auditor sets a unit to Wrong Lease when the lease file in the audit probably isn't the right lease for that unit. This lets you spot a wrong file from the unit list, without opening each unit.

When the audit sets Wrong Lease

The audit can set a unit to Wrong Lease in these cases:

  • The resident name doesn't match. The resident name on the lease is different from the resident name on the rent roll. Only the resident name counts. Pet names and other names on the lease don't. If the audit couldn't read a name from the lease, it doesn't count as a mismatch.
  • Both lease dates don't match. The lease begin date and the lease end date are both different from the rent roll. If only one of the two dates is different, the unit isn't set to Wrong Lease.

When the audit sets Wrong Lease, it replaces the Okay or Needs Review status the unit would otherwise get.

What you see

  • Wrong Lease shows in red in the Status cell. Hover over it to see why the audit set it: a name mismatch, a date mismatch, or both. The tooltip doesn't show resident names.
  • The audit status mix on the Overview tab shows Wrong Lease units as their own red entry.
  • A unit set to Wrong Lease still counts toward the overcharged and undercharged totals.
  • Your company may use a different name for this status.

Timing and manual changes

  • The status can change to Wrong Lease a short time after the audit completes, once Pivott has finished checking the resident names.
  • If you change a unit's status yourself before then, Pivott keeps the status you chose.
  • You can also select Wrong Lease yourself, in the unit's Status cell or from the menu at the top right of the unit page.
  • When you click Re-Run Audit, Pivott checks again and can set or clear Wrong Lease based on the new results.

To fix a Wrong Lease unit, open the unit and check the lease file against the Resident Name, Lease Begin and Lease End on the rent roll. If the file is wrong, upload the correct lease and click Re-Run Audit.


Units With No Lease on File

Lease Auditor uses the rent roll as the list of units. If a unit is on the rent roll but the audit has no lease file for it, the unit still appears in the audit with the status No lease on file. This helps you find leases that are missing from the audit.

  • These rows show the unit and the resident name from the rent roll. The other columns show a dash.
  • You can't open these units or change their status.
  • To show only these units, click Add Filter, choose Status and select No lease on file.
  • To hide them, turn off Show units not audited above the table. The toggle shows how many units have no lease on file, and appears only when there is at least one.

The Audits list and the Audit Coverage tile on the Overview tab show the units audited out of the units on the rent roll, and how many units have no lease on file.

Only a completed audit with a rent roll can show units with no lease on file. A single-lease audit, or an audit with no rent roll, shows none. Audits that ran before this change show these units too.


Lease Signature Status

Lease Auditor reads whether each lease is signed and shows the result in three places, so you don't have to open each unit to check.

Display What it means
Signed (green) Pivott AI found that the lease is signed.
Not signed (red) Pivott AI found that the lease is not signed.
Needs Review (yellow) Pivott AI read a signature status but isn't confident it's correct. Open the lease and check it by hand.
– (dash) Pivott has no signature result for this lease.

Where you see it

  • Audit unit list: the Signature column. To list only the units you need, click Add Filter, choose Signature, and pick Signed, Not signed, Needs Review or No Data. You can add a Status filter the same way. With both filters on, the list shows only units that match both.
  • Unit page: the Signature card on the Overview tab, next to the Filename and Lease Dates cards.
  • Property Overview: the Unsigned Leases card shows how many units have a lease that is not signed, out of the audited units. It uses each unit's most recent completed audit, like the other Overview cards. Units with no signature result count as audited but not as unsigned. If the property has no completed audit yet, the card is empty rather than showing 0.

Signature status doesn't change a unit's status, its error count or its accuracy.


Overcharged and Undercharged

For dollar fields, Lease Auditor compares what the resident is billed on the Rent Roll with what the Lease says:

Label What it means
Overcharged The rent roll amount is higher than the lease amount. The resident pays more than the lease requires.
Undercharged The rent roll amount is lower than the lease amount. The resident pays less than the lease requires, which is missing revenue for the property.

For example, if the rent roll bills $1,555 rent and the lease says $1,752, the unit is undercharged by $197.

A blank amount counts as zero. If the rent roll bills a charge and the lease has no amount for it, the unit is overcharged by the full rent roll amount. If the lease has an amount and the rent roll is blank or zero, the unit is undercharged by the full lease amount.

Some screens may label these two values differently. The rent roll value is always what the resident is billed, and the lease value is always what the lease says.


Where You See Each Result

On the audit page

Click the Audits tab, then click an audit. The table can show a count for each unit in the Matches, Errors and Uncertain columns. The Errors column counts Omissions as well. The Signature column shows whether each lease is signed. See Lease Signature Status.

To show or hide columns, click Columns above the table, tick the columns you want, and click Update. Some columns, such as Matches and Uncertain, may be hidden until you turn them on.

On the unit page

Click a unit to see each field. On the Errors & Omissions tab, compare the Rent Roll and Lease values in each row. When the lease has no value for a rent roll charge, the Lease column shows Not found. To see where a value came from in the lease, see Viewing the Source Page.

Moving between units

Use the Previous and Next buttons at the top of the unit page to move to another unit without going back to the unit list. The toggle next to the buttons sets which units they move through:

  • All Units moves through every unit, in the same sort order and with the same filters as the unit list you came from.
  • Needs Review moves only through units that need review. This option shows your company's name for that status, for example Needs Attention. It's turned off when no unit needs review.

The counter next to the buttons, for example 94/94, shows where the current unit sits in the units you're moving through. If the current unit isn't one of them, the counter shows a dash in place of the number, and Previous or Next takes you to the nearest one.

The tab you have open, such as Errors & Omissions, stays open on the next unit. If you opened the unit from a link instead of the unit list, the buttons move through all units in unit number order.

In exports

The table download (CSV or Excel) on the audit page includes the Uncertain column after Errors. To learn more, read How to Export Lease Audit Results.


Viewing the Source Page

Each extracted value on the unit page has a small Image from PDF thumbnail that shows the exact text Pivott AI read. To see that text in context:

  1. Open a unit.
  2. In the results table, find the field and click View Page.
  3. Pivott opens the full lease page the value came from, with the value highlighted. The window also shows the file name, the page number, and the field name and value.
  4. Close the window to go back to the results table.

Leases imported from an integration, rather than uploaded as a PDF, have no page to show. For these leases the thumbnail doesn't appear. If Pivott can't load a page, the window shows a message instead of the page.


Rent Roll Freshness

Audit results are only as current as the rent roll behind them. The Freshness card on the Overview tab shows how old that rent roll data is.

Pivott counts the age in days from the rent roll's "As of" date to today. If Pivott can't read an "As of" date in the rent roll, it uses the date you uploaded the file, and the card labels it Upload date.

State Rent roll age What to do
Current 30 days or less No action needed.
Dated 31 to 60 days Plan to upload a new rent roll and re-run the audit.
Stale More than 60 days Upload a new rent roll and re-run the audit before you rely on the results.

On the Overview tab, each unit uses the rent roll from its most recent audit. The card shows:

  • The oldest rent roll date across all units, with its age in days and its state.
  • How many units are in each state.

The age updates each time you open the page or run an export. The Export All Data file shows the same freshness information as the Overview tab.

If the property has no rent roll yet, the card shows – and Rent roll not uploaded yet.


Troubleshooting

A unit that used to show Okay now shows Needs Review

Okay is now only for units with no Errors, Omissions, or Uncertain results. Before this change, a unit with a few errors could still show Okay. Open the unit to see what was flagged.

A unit shows Needs Review, but every field is a Match

Some audits marked a unit Needs Review before Pivott had finished checking resident names, and didn't update the status afterwards. This is fixed for new audits. To update an older audit, click Re-Run Audit.

A charge shows Not found in the Lease column

The rent roll bills this charge, but Pivott AI found no value for it in the lease. Check whether the lease is missing an addendum for that charge.

A field shows an Error, but the lease seems to match

Pivott reports an Error when it cannot read the lease value, for example, a date with no year. Open the lease and compare the value with the rent roll value by hand.

The Freshness card says Stale, but I uploaded the rent roll recently

Freshness uses the "As of" date inside the rent roll, not the upload date. An older rent roll uploaded today is still stale. Upload a newer rent roll and re-run the audit.

A unit shows Wrong Lease, but the lease is correct

Hover over the status to see whether the name or the dates caused it. Open the unit and compare the lease with the rent roll. The rent roll may have an outdated resident name or lease dates. If the lease is correct, select the right status from the menu at the top right of the unit page.

Wrong Lease didn't appear as soon as the audit finished

Pivott sets Wrong Lease after it finishes checking resident names, which can take a short time after the audit completes. Reload the page after a few minutes.

An older audit doesn't show any Wrong Lease units

Audits that ran before Wrong Lease was added may not show it. To check an older audit, click Re-Run Audit.

New units appeared in my audit with the status No lease on file

These units are on the rent roll, but the audit has no lease file for them. Upload the missing leases and re-run the audit, or turn off Show units not audited to hide them.

My overcharged and undercharged totals switched

Before October 13, 2026, some screens showed these two labels the wrong way round. The labels are now correct everywhere. See Overcharged and Undercharged.


Next Steps

To run an audit, read How to Run a Lease Audit.