NYC Building Report

Public API

Version 1 · read-only JSON

NYC Building Report is an independent website that aggregates public New York City building records into a simple report. This API exposes the same search and report data as JSON for software, research, and AI agents. It is not an official City of New York service. There is no authentication.

Machine-readable specification: OpenAPI 3.

What you can do

• Search for a building by street address or BIN
• Retrieve the public report for a building, including counts and individual records

The API is GET-only. It does not create, update, or delete records. Underlying filings come from NYC Open Data and other public NYC sources; we do not invent facts when a source is blank.

Search for a building

GET /api/v1/buildings/search?address=ADDRESS

Uses the same address resolution as the website. You can pass a street address (optionally with a borough) or a 7-digit BIN. At most 10 matches are returned. If nothing matches, you get HTTP 200 and an empty buildings array.

curl "https://nycbuildingreport.com/api/v1/buildings/search?address=350+5th+Avenue,+Manhattan"

{
  "query": "350 5th Avenue, Manhattan",
  "buildings": [
    {
      "id": "manhattan/350-5th-avenue",
      "bin": "1015862",
      "bbl": "1008350041",
      "formatted_bbl": "1-00835-0041",
      "slug": "350-5th-avenue",
      "street_address": "350 5th Avenue",
      "borough": "Manhattan",
      "neighborhood": null,
      "url": "https://nycbuildingreport.com/buildings/manhattan/350-5th-avenue"
    }
  ]
}

Retrieve a building report

GET /api/v1/buildings/{identifier}

identifier is either a BIN (1015862) or a borough and slug (manhattan/350-5th-avenue). The JSON includes property attributes, DOB complaints and violations, HPD violations, bedbug filings, 311 requests, recorded residential units, counts, the canonical website URL, attribution, and a site last-updated timestamp.

Individual record lists are capped at 100 items (newest first, except residential units which follow unit order). Totals remain in counts. Building permits are not imported yet and are returned as an empty array.

curl "https://nycbuildingreport.com/api/v1/buildings/1015862"

curl "https://nycbuildingreport.com/api/v1/buildings/manhattan/350-5th-avenue"

{
  "id": "manhattan/350-5th-avenue",
  "bin": "1015862",
  "street_address": "350 5th Avenue",
  "borough": "Manhattan",
  "url": "https://nycbuildingreport.com/buildings/manhattan/350-5th-avenue",
  "counts": {
    "dob_complaints": 1,
    "dob_violations": 0,
    "hpd_violations": 0,
    "bedbug_reports": 0,
    "service_requests": 0,
    "residential_units": 0
  },
  "dob_complaints": [
    {
      "source_id": "c-1",
      "occurred_on": "2020-01-15",
      "status": "CLOSED",
      "category": "Illegal Conversion (45)"
    }
  ],
  "permits": [

  ],
  "attribution": {
    "text": "Aggregated from NYC Open Data and other public NYC records. Not an official City of New York website.",
    "site": "https://nycbuildingreport.com/"
  }
}

Errors

• 400 — missing search address
• 404 — unknown building or API path
• 405 — method other than GET
• 429 — too many requests from one client

{
  "error": {
    "code": "not_found",
    "message": "Building not found."
  }
}

Attribution

Please credit NYC Building Report and the original public datasets. Confirm important facts against city source files. See also the Privacy Policy and Terms of Service.