Skip to main content

​
Overview

Borough enriches building data with quality scores computed from NYC and New York State open data. Each score ranges from 0 to 100, where higher is better. Scores are available via GET /v1/building/{id}/scores (Starter and above). On the Free tier, the same four scores and the open violation count appear as buildingScores on each search result.

​
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 (Starter and above). The list holds the 50 most recent violations of any status, open and closed together, so filter on status: "Open" and use violationsOpen from /scores for the open count rather than counting list rows. For a building matched by location rather than BBL (see Availability), the list can include violations from adjacent lots.

​
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

Sources: NYPD Complaint Data Historic for the part of the window before January 1 of the current year, and NYPD Complaint Data Current (Year To Date) for the rest 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

Sources: MTA subway stops (39hk-dx4f), MTA bus stops (2ucp-7wg5), LIRR and Metro-North stations (wxmd-5cpm), the NYC Ferry GTFS feed, and the Staten Island Ferry GTFS feed (b57i-ri22) Measures public transit accessibility based on proximity and density of subway, bus, commuter-rail (LIRR/Metro-North), and ferry stops near the building. Six components by mode, summed and capped at 100 (the raw maximum is 110, so a building does not need every mode to score 100):

​
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

  • Noise, safety, and transit scores require building geo-coordinates (latitude/longitude)
  • The health score uses the building’s BBL (Borough-Block-Lot) identifier when Borough has one. Otherwise it counts HPD violations within about 50 m of the building’s coordinates, so for those buildings it can include adjacent lots
  • Not all buildings have all scores; missing scores return null