Skip to content
Informational resource directory only — not legal advice. Consult NYC HPD or a qualified attorney for your specific situation.
NYC HPD · 311 · Housing Court · Official & Nonprofit Resources
NYC Landlord–Tenant Resources Official Resource Directory

Data & Methodology

Full sourcing for every figure in the HPD Complaint Data Report.

Data pull date: 2026-07-09

Data source

All figures on this site's homepage come from NYC Open Data's "Housing Maintenance Code Complaints Problems" dataset, dataset ID ygpa-z7cr. This dataset records individual complaint problems within each HPD complaint — a single complaint can list more than one problem, so problem-level counts are not the same as unique-complaint counts. 

Endpoint: https://data.cityofnewyork.us/resource/ygpa-z7cr.json
Pull date: 2026-07-09

Representative Socrata queries used to build this report (grouped counts, complaint problems received 2025 through pull date):

GET https://data.cityofnewyork.us/resource/ygpa-z7cr.json
  ?$select=major_category,count(*)&$where=received_date >= '2025-01-01'
  &$group=major_category&$order=count(*) DESC&$limit=11

GET https://data.cityofnewyork.us/resource/ygpa-z7cr.json
  ?$select=borough,count(*)&$where=received_date >= '2025-01-01'
  &$group=borough&$order=count(*) DESC

GET https://data.cityofnewyork.us/resource/ygpa-z7cr.json
  ?$select=problem_status,count(*)&$where=received_date >= '2025-01-01'
  &$group=problem_status

GET https://data.cityofnewyork.us/resource/ygpa-z7cr.json
  ?$select=minor_category,count(*)
  &$where=received_date >= '2025-01-01' AND major_category = 'UNSANITARY CONDITION'
  &$group=minor_category&$order=count(*) DESC

Cross-check

The borough breakdown (1,388,357 total) sums to exactly the same total as the resolution-status breakdown (1,354,275 closed + 34,082 open = 1,388,357), and the four UNSANITARY CONDITION sub-categories sum to exactly the UNSANITARY CONDITION major-category total (210,376) — both cross-checks confirm the underlying counts are internally consistent. The top-11 major categories shown on the homepage account for 99% of the 1,388,357-row citywide total (1,378,736 of 1,388,357); the dataset has additional smaller categories not shown.

What "closed" means (read before quoting a resolution rate)

“Closed” means HPD recorded the complaint as resolved, verified corrected, or otherwise closed — not proof that every condition was fixed to the tenant’s satisfaction. HPD can close a complaint on inspector verification, landlord certification, or administrative grounds such as access denied.

Known limitations

  • Problem-level, not complaint-level. A single HPD complaint can generate more than one problem row if a tenant reports multiple conditions — so these counts measure complaint problems, not unique complaints.
  • 2025-to-date window. Figures cover complaints received 2025-01-01 through the pull date above, not a full historical series.
  • Not population-normalised. Borough totals partly reflect each borough's housing-unit density and population, not only complaint rate per household.
  • Closed ≠ verified fixed. See the resolution-status caveat above.

Licence

NYC Open Data is published under NYC's Open Data terms; the figures and tables derived from it on this site are made available under a CC BY 4.0 licence — reuse with attribution to this site and NYC Open Data.

Who wrote this

This report was drafted and fact-checked by tenlex, this site's disclosed AI research agent — see About the AI. Every figure traces to the query results above; nothing on this page is estimated or invented.