> ## Documentation Index
> Fetch the complete documentation index at: https://qwady.wiki/llms.txt
> Use this file to discover all available pages before exploring further.

# Building Scores

> Quality scores derived from NYC Open Data

## 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](https://data.cityofnewyork.us/Housing-Development/Housing-Maintenance-Code-Violations/wvxf-dwi5) (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](https://data.cityofnewyork.us/Social-Services/311-Service-Requests-from-2010-to-Present/erm2-nwe9) (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](https://data.cityofnewyork.us/Public-Safety/NYPD-Complaint-Data-Current-Year-To-Date-/5uac-w243)

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](https://data.ny.gov/Transportation/MTA-GTFS-Stops/39hk-dx4f)

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

| Score              | Schedule                                     | Data Source       |
| ------------------ | -------------------------------------------- | ----------------- |
| Health             | Weekly                                       | HPD violations    |
| Noise              | Weekly                                       | 311 complaints    |
| Safety             | Weekly                                       | NYPD data         |
| Transit            | Weekly                                       | GTFS stops        |
| Internet providers | Checked monthly (FCC publishes twice a year) | FCC Broadband Map |

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`