Most landlords think of maintenance documentation as receipts. It’s not. Receipts are a fraction of the record. The real record is the timeline, when the tenant first reported the issue, what was decided about urgency, when the vendor was dispatched, when the owner approved the cost, when the work was finished, and what condition the unit was in throughout. That timeline is what gets tested when a tenant withholds rent, when an insurance adjuster denies a claim, when an auditor asks for documentation, and when an owner asks why the repair cost twice what they expected.
The landlords who lose those tests aren’t lazy. They have a folder of receipts, a phone full of photos, and a Gmail thread with the tenant. They just don’t have a single timeline they can hand to a third party. The timeline is what this pillar is about.
Pillar guide · ~13 min readWhy bad maintenance records become habitability lawsuits
In most states, a landlord has an implied warranty of habitability, the unit has to be liveable, with working heat, water, electrical, structural integrity, and pest control. When something breaks that affects habitability, the law gives the landlord a “reasonable time” to fix it. What “reasonable” means is context-dependent, but the burden of proof is on the landlord.
A reasonable timeline for fixing a broken furnace in January isn’t decided by what you remember. It’s decided by what you can prove. If your timeline shows you received the tenant’s first call on January 4, dispatched a vendor on January 5, and replaced the unit on January 8, you’re inside the window. If you can’t prove when the call came in or when the vendor was dispatched, you’re at the tenant’s word, and tenant testimony in habitability cases is generally believed.
This is where landlords get squeezed. The repair was actually completed promptly. The receipts exist. But there’s no timeline that proves the speed, and “trust me, it was fast” doesn’t work in court. The tenant’s rent-withholding claim succeeds, the deduction the landlord wanted to take from the deposit gets denied, and a paid-but-undocumented repair becomes a financial loss.
Two examples from real cases (sanitized; details changed):
Furnace, four-unit building, Minnesota. Tenant called in a no-heat condition at 6:42 PM on a Tuesday. Landlord responded the same night, scheduled a Wednesday vendor, replaced the unit Thursday morning. Tenant later withheld rent claiming “three weeks of no heat in the winter.” Landlord had receipts but no timestamped record of the initial call, the response, or the vendor dispatch. Judge ruled for tenant on the rent-withholding because the landlord couldn’t prove the speed. Cost: $3,200 in rent abatement + statutory damages on a $1,150 repair that was, in reality, executed flawlessly.
Mold remediation, single-family, North Carolina. Tenant reported a leak; landlord patched the leak but did not document the moisture readings before or after. Mold appeared two months later. Insurance claim denied for lack of contemporaneous documentation showing the leak was identified and remediated. Cost: $14,000 in mold remediation and a contested claim that ran for over a year.
Both cases were caused by the same thing, receipts, but no record.
The five-stage repair record
Every maintenance event passes through five stages. The record has to capture each one.
| Stage | What it captures | What gets documented |
|---|---|---|
| 1. Tenant request | When the issue was first reported | Date/time, channel (call, text, portal), tenant’s description, severity assessment |
| 2. Triage | The landlord’s response and classification | Severity rating, response timeline, initial decisions (DIY vs vendor, urgency) |
| 3. Vendor visit | The on-site assessment and quote | Vendor name and license, arrival time, photos of condition, scope, written quote |
| 4. Owner approval | The decision to proceed | Threshold check (if applicable), owner’s written approval, alternative options considered |
| 5. Completion | The finished work and verification | Completion photos, vendor invoice, tenant’s acknowledgment that the issue is resolved |
Every artifact at every stage gets a timestamp. The artifacts collectively become the timeline. Below is the unpacking of each stage.
Stage 1: Tenant request, the moment the clock starts
The clock for any habitability claim starts at the tenant’s first report. This is the most-skipped documentation step because it usually happens through a text or a phone call that nobody indexes.
What to capture:
- Date and time stamped automatically, not “around the 4th of January.” The exact timestamp.
- Channel, call, text, email, portal request. If a call, capture it with a follow-up text or email reply (“Confirming your call at 6:42 PM about no heat, we’re on it”) that lands the timestamp in a written record.
- The tenant’s words. Not a paraphrase. Verbatim, including any clues about severity (“water is pouring from the ceiling” versus “there’s a small drip”).
- Severity classification. Your call, made within minutes of the report, recorded in writing. This is what justifies your response speed in any later dispute. The emergency vs non-emergency maintenance guide covers the classifications most landlords use.
A clean intake record looks like:
2026-01-04 18:42, Tenant call (J. Sanders, 412 Ash St, Unit 2B). Tenant reports: “No heat in the apartment since this afternoon. Kids are home, thermostat reads 58.” Severity: emergency (habitability, winter, occupied with minors). Responding tonight.
If you can produce that paragraph nine months from now for any repair, you have a stage-1 record. If you can’t, you don’t.
Stage 2: Triage, the response window decision
Within minutes of the request, you’ve made a decision: emergency, urgent, routine, or scheduled. That decision sets the window you’re committing to. Most landlords don’t write the decision down. The decision needs to be on paper because it controls what “reasonable time” means in a later dispute.
The standard scale:
- Emergency, habitability issue (heat in cold, water, sewer, structural, electrical safety). Response within hours, not days.
- Urgent, significant but not life-safety (working but inadequate heat, single-broken appliance affecting habitability, leak without imminent damage). Response within 24-48 hours.
- Routine, non-habitability, can wait for normal scheduling (cosmetic, minor appliance issues, slow drains). Response within 5-10 business days.
- Scheduled, preventive or non-urgent (annual HVAC service, seasonal maintenance). Calendared, not pulled forward.
Whatever you classify it as, log it. The classification, the time of the classification, and your reasoning. Five words is enough, “Emergency: winter, no heat, occupied.” But it has to be in writing.
The tenant maintenance request workflow article has the full triage logic with edge cases.
Stage 3: Vendor visit, the on-site record
When the vendor shows up, the record expands. Three things should land in the file the same day:
- Vendor identification. Company name, license number (where required), insurance certificate on file. If the vendor isn’t already in your roster, you’re not just hiring them, you’re vetting them. The vendor management guide covers the full vetting workflow.
- Photos of the condition before any work. This is the “as-found” state. Wide shot of the area, close-ups of the failure point. If the vendor took readings (moisture, gas, electrical), those readings are part of the record.
- Written quote. Scope of work, materials, labor, total. Verbal-only quotes don’t survive disputes, if the owner later asks why the work cost twice the quote, you need a paper baseline.
If the issue can’t be fixed in the initial visit (a part has to be ordered, a follow-up is required), the date of the next scheduled visit goes into the timeline immediately. Gaps in the timeline that aren’t explained are read as delay.
Stage 4: Owner approval, the threshold decision
If you’re managing on behalf of an owner, almost every repair triggers a threshold question: is this within my authority, or do I need owner sign-off? The threshold is contract-specific (usually $300, $500, or $1,000) but it’s the single most disputed item in owner-PM relationships.
What to document:
- The threshold itself. From the management agreement. Both parties signed off on it. (If your management agreement doesn’t specify, fix that today, the owner approval thresholds guide has the standard ranges.)
- The estimate. Whether it cleared or didn’t clear the threshold.
- The decision. If above threshold: owner approval, in writing, with date and time. If below: the manager’s authority to proceed, noted in the record.
- Alternative options considered. “Replace vs repair,” “Vendor A vs Vendor B,” “Urgent expedite vs standard.” Owners want to see that you didn’t just take the first quote.
The “alternative options” line is the one that builds owner trust. It signals that you’re managing money, not just executing tickets.
The repair-vs-replace decision
For appliances and major systems, the choice between repairing and replacing is one of the higher-stakes decisions in property management. Done well, it saves the owner money and extends asset life. Done badly, it produces a repair bill that’s 70% of replacement cost on a unit with three years of life left.
The standard rule of thumb is the 50% rule: if the repair exceeds 50% of replacement cost, replace. The more nuanced rule combines the 50% test with remaining useful life, a 30% repair on a unit at the end of its life is still a bad bet.
Below is the calculator. Pick the item, enter the repair quote and the unit’s age, and it produces the decision plus the reasoning. The reasoning is what you paste into the owner-approval record.
For the deep article on the methodology, including IRS-recognized useful life schedules and edge cases (warranties, deferred maintenance, end-of-tenancy timing), see repair vs. replace for HVAC and appliances.
Stage 5: Completion, verification, receipts, and the close-out
The repair isn’t done when the work is done. It’s done when the record is closed.
- Completion photos. The “after” matching the “as-found” shot from stage 3. Same angle. Same lighting if possible. Side-by-side photos are what a future buyer of the property, an insurance adjuster, or an owner reviewing a year-end statement will want to see.
- Vendor invoice. Not a verbal “send me a Venmo.” A real invoice with the vendor’s business name, address, license number where required, line items, tax, total.
- Tenant acknowledgment. A text, an email, a portal note from the tenant confirming the issue is resolved. This closes the habitability clock.
- Categorization. Capitalizable improvement vs. expense. Tax-treatment categorization happens at the close, not at tax time. The maintenance receipts guide covers the IRS categories.
If anything is missing (the tenant won’t acknowledge, the vendor hasn’t invoiced, photos didn’t get taken) the ticket stays open. Closing a ticket with missing artifacts is how the file decays.
Photo standards: before, in-progress, after
A maintenance photo set has three distinct stages:
- Before. What it looked like when the vendor arrived. The failure point and the surrounding context.
- In-progress. What was found behind the wall, under the floor, inside the panel. This is the most-skipped category and the most useful in dispute. If you opened a wall to fix a leak and found rot the tenant didn’t know about, photograph the rot.
- After. What it looks like with the work completed. Same angles as the “before.”
For pipe leaks, electrical work, anything that involved opening something up: the in-progress photo is what protects you in an insurance claim and what proves the work was real to the owner. The document maintenance with photos guide goes deeper on the photo standard.
Vendor records you keep regardless of any specific repair
Repeat vendors generate a permanent file. Keep these per vendor:
- W-9 on file. Updated annually. You’ll need it at tax time when you 1099 anyone who hit $600 of paid work in the year.
- Certificate of insurance. Listing you (or the owner) as additionally insured. Renewed annually.
- License number where the trade requires one (HVAC, electrical, plumbing in most states). Verified on the state licensing board’s site.
- Worker’s comp certificate in states that require it for solo contractors.
- Year-to-date paid total so 1099 thresholds don’t sneak up.
These aren’t repair records. They’re vendor records, and they live in a parallel filing system that any specific repair record references.
What the maintenance flow looks like in practice
A tenant reports an issue from their phone. The request lands in your dashboard with a timestamp, a severity classification, and a triage decision. You dispatch a vendor; their on-site notes, photos, and quote land in the same record. Owner approval (if required) is handled inline. The completion photos and the invoice close the ticket. The whole timeline exports as a PDF.
How long do you keep maintenance records?
The longest of three rules:
- IRS retention. 3 years for routine expense receipts; 7 years if there’s any chance the deduction is contested or audited. Capitalized improvements stay on file as long as the asset is depreciating, plus 3 years after disposal.
- Insurance retention. Insurers commonly require records of any habitability-related repair for 7+ years. Mold, water, structural, electrical, keep these forever as a practical matter.
- State retention for habitability claims. Statute of limitations in most states is 2-6 years from the event, but the “discovery rule” can extend that significantly.
Practical answer: 7 years on routine maintenance, indefinite on anything related to habitability or major systems. The property records retention guide has the breakdown by record type.
Frequently asked questions
What's "reasonable time" for a habitability repair?
State-dependent and condition-dependent. As a general framework: emergencies (no heat in winter, no water, sewer backup, structural collapse risk) need response within hours and resolution within 1-3 days. Significant habitability issues need response within 24-48 hours and resolution within a week. Cosmetic and quality-of-life issues can wait 5-10 business days. The "reasonable" standard tightens when conditions are severe or occupants are vulnerable (children, elderly, disabled).
Do I need a written quote before authorizing every repair?
Below your owner's approval threshold, you can usually authorize on a verbal estimate if the situation is urgent. Above the threshold, the written quote and the owner's written approval are non-negotiable, verbal approval is the source of most owner-PM disputes. Even below threshold, a written quote in the record protects you when the owner reviews the statement and asks why a $400 repair wasn't a $250 repair.
How do I document a repair that I did myself?
The same way you'd document a vendor: photos before/in-progress/after, materials receipts, hours logged at a reasonable hourly rate (consistent with what a third-party vendor would charge), and a written summary. If you intend to deduct the labor against the tenant or charge the owner for the labor, the rate and the hours have to be defensible. Some states don't allow landlord-labor deductions against tenants at all.
What if the tenant caused the damage I'm now repairing?
The repair record and the lease violation or move-out deduction record are two different artifacts. Document the repair as a repair (request, vendor, completion, receipt). Then, separately, document the cause attribution (photos showing tenant action, vendor's note that the cause was misuse rather than wear, tenant communication if they admitted it). At deposit time, the cause-attribution artifact is what justifies the deduction; the repair record is what supports the dollar amount. Don't conflate them.
Should I keep vendor 1099s with the repair records or separately?
Separately. The repair record references a specific invoice; the 1099 system is a year-end aggregation across all repairs that vendor did. Vendor records (W-9, COI, license) live in a vendor file; repair records reference those by vendor name, but the underlying documents are in the vendor system. Conflating them gets messy fast.
How do I handle a repair an insurance claim might cover?
Document at the highest level immediately, before, in-progress, after photos, every receipt, every vendor exchange. Don't decide whether to claim before you've documented. Insurance claims often hinge on whether the documentation is contemporaneous (created at the time) or reconstructed (assembled later). Reconstructed documentation is usually treated as suspect. Document everything, then decide whether to file.
What's the difference between a repair and a capitalized improvement for taxes?
The IRS distinguishes repairs (deductible as expense in the year incurred) from improvements (capitalized and depreciated over the asset's useful life). The general test: a repair returns property to its prior working condition; an improvement adds value, extends useful life, or adapts the property to a new use. Replacing a leaking faucet is a repair. Replacing the entire plumbing system is an improvement. The IRS has detailed rules and de minimis safe harbors. Your accountant should be your first call; the categorization affects the cash-flow picture significantly.
Where to go next
Three follow-on reads:
- Vendor management for property managers, the vendor file system referenced throughout this pillar.
- Owner approval thresholds, the contract clause that governs stage-4 of every repair.
- Document maintenance with photos, deeper detail on the photo standard.
If maintenance documentation is the area you’re starting from zero on, also read the property documentation pillar, it’s the broader framework that move-ins, move-outs, maintenance, and lease violations all fit into.