HPD Complaints vs Violations: How to Read Them
How a 311 housing complaint becomes an HPD inspection and maybe a violation, what complaint categories and statuses mean, and why most close with no violation.
8 min read · Updated
A complaint is a tenant's report of a problem; a violation is HPD's official finding, after an inspection, that the problem breaks the housing law. Most complaints never become violations: in the 12 months to September 2026, only about one in six complaint problems ended with a violation being issued.
That doesn't mean the other complaints were false. Many closed because the tenant said the problem was fixed, the inspector couldn't get in, or it was a duplicate of a building-wide report. Here is how to read the complaint record on a building.
At a glance
- Complaint problems, Oct 2025–Sep 2026
- 993,730
- On 615,289 complaints
- Ended with a violation issued
- 16.4%
- 162,630 problems
- Heat and hot water share
- 36.4%
- Largest category by far
- Still open (Oct 12, 2026)
- 1.8%
- 17,835 problems
From 311 call to violation
HPD recommends telling the landlord first. If that doesn't work, you file with 311 by phone, 311 online or the app. Then:
- 1
You get a service request number
Use it to check status on 311 or HPD Online. The complaint row in open data links back to 311 by its Unique Key. - 2
HPD tells the managing agent
HPD tries to contact the owner’s agent to say a complaint was filed and a violation may follow if the condition isn’t corrected. - 3
HPD calls you back
If you say the problem is fixed, HPD closes the complaint. Keep your phone number current. - 4
An inspector visits, unannounced to the owner
If it isn’t fixed or HPD can’t reach you, a Code Enforcement inspector is sent. On every inspection, inspectors also check smoke and CO detectors and certain other conditions, such as window guards and lead paint where young children live. - 5
A violation, or not
If the condition breaks the Housing Maintenance Code or Multiple Dwelling Law, the inspector writes a violation and HPD mails the owner a Notice of Violation with a deadline. - 6
Emergency repairs if needed
For immediately hazardous conditions the owner ignores, HPD's Emergency Repair Program may make certain repairs and bill the owner. See the Emergency Repair Program guide.
Complaints vs violations at a glance
| Complaint | Violation | |
|---|---|---|
| Who creates it | A tenant or member of the public, through 311 | An HPD inspector, after seeing the condition |
| Is it verified? | No, it is a report | Yes, it is a legal finding |
| Severity scale | Type: Immediate Emergency, Emergency, Non Emergency | Class A, B, C (and I for information orders) |
| Statuses | Open or Close, plus a status description | About 20 detailed statuses |
| Owner deadline | None by itself | Immediately (heat) to 90 days, by class |
| Open data | Dataset ygpa-z7cr | Dataset wvxf-dwi5 |
How a complaint record is structured
HPD splits each complaint into one or more problems. A tenant calling about no heat and a leaking ceiling makes one complaint with two problems. Each problem has its own category, type and status. HPD's dictionary says a problem closes when a tenant verifies it was corrected or an inspector enters a result, and a complaint closes when all its problems are closed.
| Field | What it means | Values |
|---|---|---|
| ReceivedDate | When HPD received the complaint | Date |
| ComplaintID / ProblemID | The complaint, and each problem within it | Numbers |
| UnitType | Where the problem is | Apartment, Building, Building-Wide, Public area |
| Type | HPD’s urgency code for the problem | Immediate Emergency, Emergency, Hazardous, Non emergency |
| MajorCategory / MinorCategory | What the problem is, e.g. Heat/Hot Water > Entire building | Text |
| ComplaintStatus / ProblemStatus | Whether it is still being handled | Open, Close |
| StatusDescription | The outcome in plain words (see below) | Text |
| ProblemDuplicateFlag | Another complaint already covers this condition | Y, N |
| ComplaintAnonymousFlag | Filed anonymously | Y, N |
| Unique Key | Links the row to the 311 service request | Number |
What people complain about
| Category | Problems | Share |
|---|---|---|
| Heat/Hot water | 361,582 | 36.4% |
| Unsanitary condition | 155,266 | 15.6% |
| Plumbing | 97,078 | 9.8% |
| Paint/Plaster | 80,683 | 8.1% |
| Door/Window | 64,090 | 6.4% |
| Water leak | 52,225 | 5.3% |
| General | 48,416 | 4.9% |
| Electric | 40,219 | 4.0% |
| Flooring/Stairs | 36,414 | 3.7% |
| Appliance | 28,971 | 2.9% |
| Safety | 22,054 | 2.2% |
By urgency, 62.1% of problems were coded Emergency, 33.9% Non emergency and 4.0% Immediate Emergency. Elevator, outside-building and line-of-travel problems were each under 0.3%.
Why most complaints close without a violation
The StatusDescription field tells you how each problem ended. These were the most common outcomes over the last 12 months:
| Outcome (paraphrasing HPD’s status text) | Problems | Share |
|---|---|---|
| Inspected; conditions did not violate the law HPD enforces | 187,997 | 18.9% |
| Inspected; violations issued | 155,574 | 15.7% |
| Inspection attempted but could not be completed | 129,238 | 13.0% |
| Duplicate building-wide complaint; a tenant verified it was corrected | 104,867 | 10.6% |
| No access; card left, tenant did not reschedule in time | 96,254 | 9.7% |
| Duplicate building-wide complaint; phone contact said corrected | 77,659 | 7.8% |
| No heat/hot water: an occupant confirmed it was restored | 60,727 | 6.1% |
| No heat/hot water: no access to any apartment | 40,777 | 4.1% |
| Phone contact said the condition was corrected | 35,175 | 3.5% |
| Inspected; no violations issued (older wording) | 35,107 | 3.5% |
Some patterns to know:
- Heat complaints are time-sensitive. 6,472 heat problems closed with HPD's note that heat was not required at the time of inspection because it was above 55°F outside. Daytime heat rules depend on the outdoor temperature; nighttime rules do not. See NYC heat and hot water rules.
- Building-wide duplicates are normal. When many tenants report the same building-wide condition, HPD's status text notes that more than one complaint was received and reports the outcome for the initial complaint.
- No access closes complaints. If nobody lets the inspector in, the complaint closes and you have to file again.
- "Violations were previously issued" (11,146 problems) means the condition is already covered by an existing open violation, which is itself a sign of a repeat problem.
How to read complaints on a building page
On a Roofy building page, each complaint shows its major category, minor category, date, apartment and status. Weigh them this way:
- Repeat categories over several years matter more than one bad month. The same heat or leak complaint every winter suggests patching, not fixing.
- Building-wide heat complaints from many apartments on the same days point to a boiler or fuel problem.
- Complaints with no matching violations aren't proof the building is fine. Check whether they closed for no access or a tenant callback.
- Size matters. Compare complaints to the number of units. Fifty complaints in a 300-unit building is different from fifty in a six-family.
Once a violation is issued, its status tells you whether it is still open. See HPD violation status codes explained, and for citywide heat trends, our 2025-26 heat complaints report.
Complaint lifecycle (owner notice, tenant callback, unannounced inspection, NOV, correction periods, ERP) from HPD’s Report a Quality or Safety Issue page. Field definitions, allowed values and closing rules from the HPD complaints data dictionary (ygpa-z7cr). Closing rules and field values (incl. Hazardous type) re-checked in the ygpa-z7cr data dictionary xlsx. Re-queried 2026-10-12 for problems received Oct 1, 2025 to Sep 30, 2026: 993,730 problems / 615,289 complaints, category, type, open-status and StatusDescription counts all matched; 162,630 violation-issued = sum of the four "violations were issued" texts plus the heat no-access-but-verified text. Inspector-checks list verified on HPD Code Enforcement page. Heat-status wording tightened to match HPD status text.
Sources
- Housing Maintenance Code Complaints and Problems (dataset and data dictionary) · NYC Open Data / NYC HPD (accessed October 12, 2026)
- Report a Quality or Safety Issue · NYC HPD (accessed October 12, 2026)
- Code Enforcement · NYC HPD (accessed October 12, 2026)
- Housing Maintenance Code Violations (dataset) · NYC Open Data / NYC HPD (accessed October 12, 2026)
General information, not legal, tax or financial advice. Rules change; confirm with the agency or a professional before you act.