Back to Home

API

The NYCLandlordCheck API exposes public records we aggregate from NYC Open Data. All endpoints are read-only and return JSON.

Base URL

https://www.nyclandlordcheck.com/api/v1

Endpoints

GET/api/v1/buildings/search?q={query}&limit={n}

Search by address or landlord name.

GET/api/v1/buildings/{bbl}

Building report with violations, complaints, and owner info.

GET/api/v1/buildings/{bbl}/violations?limit={n}&status={status}

Violations for a building with optional filters.

GET/api/v1/buildings/{bbl}/timeline?limit={n}

Timeline events for a building.

GET/api/v1/owners/{id}

Owner portfolio details and stats.

GET/api/v1/leaderboards/worst-buildings?borough={borough}&limit={n}

Worst buildings leaderboard, optionally filtered by borough.

GET/api/v1/leaderboards/worst-landlords?limit={n}

Worst landlords leaderboard.

GET/api/v1/buildings/violations/recent?limit={n}

Recent violations feed.

Example

curl "https://www.nyclandlordcheck.com/api/v1/buildings/search?q=123%20Main%20St"

Responsible use

Please be respectful with request volume. If you need higher-volume access or data exports, email us at hello@nyclandlordcheck.com.