Skip to main content

Overview

Borough enriches building data with quality scores computed from NYC Open Data sources. Each score ranges from 0 to 100, where higher is better. Scores are available via GET /v1/building/{id}/scores.

Score types

Health Score

Source: HPD Violations (NYC Department of Housing Preservation & Development) Measures building maintenance quality based on open HPD violations.
  • Class C (immediately hazardous): -3 points each
  • Class B (hazardous): -2 points each
  • Class A (non-hazardous): -1 point each
  • Formula: max(0, 100 - weighted_sum)
Individual violations are available via GET /v1/building/{id}/violations.

Noise Score

Source: 311 Service Requests (noise complaints) Reflects reported noise activity near the building, based on 311 noise-complaint density within 200 meters over the trailing 6 months. Scored 0–100 (higher = quieter) with a logarithmic curve calibrated to the citywide distribution of nearby complaint counts, so a typical NYC building lands near the middle and the noisiest blocks approach 0.

Safety Score

Source: NYPD Complaint Data Reflects reported crime activity near the building, based on NYPD complaint density within 400 meters over the trailing 12 months. Weighted by severity:
  • Felony: 5 points
  • Misdemeanor: 2 points
  • Violation: 1 point
Scored 0–100 (higher = safer) with a logarithmic curve calibrated to the citywide distribution of weighted complaint counts, so a typical NYC building lands near the middle and the highest-incident areas approach 0.

Transit Score

Source: MTA GTFS Stops Measures public transit accessibility based on proximity and density of subway, bus, commuter-rail (LIRR/Metro-North), and ferry stops near the building. Two components (50 points each):
  • Proximity: Linear decay based on distance to nearest stop (0-400m)
  • Density: Logarithmic scale of stops within 400m

Update frequency

Enrichment jobs run on a periodic schedule. Scores reflect the most recent computation cycle.

Internet provider availability

Borough also enriches buildings with likely internet provider availability from official FCC Broadband Data Collection public data.
  • Coverage level: exact-building when matched, or Census-block level from FCC public bulk imports
  • Source: FCC Broadband Map public availability data
  • Cadence: the FCC publishes this dataset twice a year. Borough checks monthly and re-imports when a new filing period is available, so most monthly checks find nothing new. Manual backfills are supported when needed
  • Fill rate: about 76.5% of eligible buildings, meaning those with an active listing and a geocoded location. Buildings with no active listing are not enriched by design
  • Disclaimer: provider availability may vary by apartment or unit
This product uses FCC APIs and/or Data but is not endorsed or certified by the FCC.

Availability

  • Scores require building geo-coordinates (latitude/longitude)
  • Health score additionally requires a BBL (Borough-Block-Lot) identifier
  • Not all buildings have all scores; missing scores return null