# NYC Property Facts

> Free, plain-English facts about every New York City property (858,284 tax lots), compiled from NYC Open Data: owner of record, building, tax assessment, ACRIS deeds, DOB jobs/permits/violations, ECB and HPD violations, OATH tickets, HPD complaints and 311 requests. Open-item counts as of 2026-10-31. Independent site. Data from NYC Open Data; not affiliated with the City of New York.

Each property has one page at `https://nycpropertyfacts.com/ny/{borough}/{address-slug}-{bbl}` with a dated summary you can quote, a "How to cite" line, a Markdown twin (append `.md` or send `Accept: text/markdown`) and a JSON twin at `https://nycpropertyfacts.com/api/v1/property/{bbl}`.

## For agents
- [MCP server](https://nycpropertyfacts.com/mcp): Streamable HTTP, no auth. Tools: lookup_property, get_property, list_open_issues, get_sales_history, search_properties. Card: https://nycpropertyfacts.com/mcp/server-card
- [REST API docs](https://nycpropertyfacts.com/developers): no key, CORS open. Start with `GET https://nycpropertyfacts.com/api/v1/property?address=...`
- [OpenAPI 3.1](https://nycpropertyfacts.com/openapi.json)
- [Full guide for LLMs](https://nycpropertyfacts.com/llms-full.txt): definitions, fields, examples

## Browse
- [Boroughs](https://nycpropertyfacts.com/ny/): Manhattan (42,504 lots), Bronx (89,362 lots), Brooklyn (276,106 lots), Queens (324,483 lots), Staten Island (125,829 lots)
- [About the data and freshness](https://nycpropertyfacts.com/about)
- [Example: 98 Grattan Street, Brooklyn](https://nycpropertyfacts.com/ny/brooklyn/98-grattan-street-3030090016)

## Citing
Quote the summary and cite: NYC Property Facts, "<address> (BBL <bbl>)", data as of <date>, <page URL>. Source: NYC Open Data. Not a title search or official record.

## Identifiers
- BBL: 10 digits = borough (1 Manhattan, 2 Bronx, 3 Brooklyn, 4 Queens, 5 Staten Island) + block (5) + lot (4). One page per BBL. Condo buildings have one billing BBL plus unit lots.
- BIN: 7-digit DOB building number; one lot can have several buildings.
- Address lookup is forgiving: St/Street, 5th/Fifth, units (Apt 3B, #4), Queens hyphenated house numbers, optional borough and ZIP. Results carry confidence 0-1 and alternatives.

## Sections and what "open" means
- permits — DOB job filings and work permits: A DOB "job" is an application to do construction work. status "open" = a permit was issued but DOB has no record of final sign-off. Work permits are listed with type "work_permit" and their DOB permit status (they are not counted as open items).
- violations — DOB, ECB and HPD violations: status "open" = DOB violation category is ACTIVE, ECB violation status is ACTIVE, or HPD violation status is Open.
- complaints — HPD complaints (2019+) and 311 requests (last 12 months): Complaints are reports, not violations. status mirrors the published complaint / request status.
- hearings — OATH hearings / tickets: status "open" = balance due > $0 after a decision (cases awaiting a hearing are "pending"). default=true means the respondent did not appear.
- sales — ACRIS deeds: Deeds recorded with the City Register. amount 0 usually means a non-market transfer. lots_in_deed > 1 means the price covers several lots.
- owners — Owner of record, deed grantees and HPD registration contacts: Owner of record comes from city tax records (PLUTO) and can lag behind recent sales.

## REST endpoints
- GET https://nycpropertyfacts.com/api/v1/property?address=98+Grattan+St+Brooklyn → { query, match{bbl,address,confidence,matched_on}, alternatives[], url, summary, property }
- GET https://nycpropertyfacts.com/api/v1/property/{bbl} → property: bbl, bins, address, url, markdown_url, summary, how_to_cite, data_as_of, last_updated, open_items, facts, assessment, last_priced_deed, record_counts, sections, sources, disclaimer
- GET https://nycpropertyfacts.com/api/v1/property/bin/{bin}
- GET https://nycpropertyfacts.com/api/v1/property/{bbl}/permits?status=open&since=2024-01-01&limit=50&offset=0
- GET https://nycpropertyfacts.com/api/v1/property/{bbl}/violations?status=open&since=2024-01-01&limit=50&offset=0
- GET https://nycpropertyfacts.com/api/v1/property/{bbl}/complaints?status=open&since=2024-01-01&limit=50&offset=0
- GET https://nycpropertyfacts.com/api/v1/property/{bbl}/hearings?status=open&since=2024-01-01&limit=50&offset=0
- GET https://nycpropertyfacts.com/api/v1/property/{bbl}/sales?status=open&since=2024-01-01&limit=50&offset=0
- GET https://nycpropertyfacts.com/api/v1/property/{bbl}/owners?status=open&since=2024-01-01&limit=50&offset=0
- GET https://nycpropertyfacts.com/api/v1/search?street=Grattan+St&zip=11237
- Every record: id, type, status, status_detail, date, dates{}, description (plain English), source{dataset_id,dataset,url,dataset_updated}, data_as_of.
- Errors: { error: { status, code, message, hint, docs } }. Rate limit ~120/min/IP; 429 has Retry-After. ETag/If-None-Match supported.

## MCP tools (https://nycpropertyfacts.com/mcp, protocol 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26)
- lookup_property(address, borough, zip): Resolve a free-text NYC address to its tax lot (BBL) and return the property facts: summary, owner of record, building, assessment, last priced deed and open-item counts. Returns the best match with a 0-1 confidence and up to 4 alternatives. Use get_property for a known BBL/BIN.
- get_property(bbl, bin): Return the full fact sheet for a tax lot by 10-digit BBL (borough-block-lot, e.g. 3030090016) or by 7-digit DOB building number (BIN).
- list_open_issues(address, bbl, limit): List every open item for a property: DOB jobs with a permit issued but no sign-off, active DOB and ECB violations, open HPD violations, and OATH tickets with an unpaid balance or a pending hearing. Each record has status, dates, a plain-English description and its source dataset.
- get_sales_history(address, bbl, limit): Deeds recorded with the NYC City Register (ACRIS) for a property: date, stated price (0 = non-market transfer), grantors, grantees, and whether the deed covers several lots.
- search_properties(street, zip, borough, house_number, limit, offset): List tax lots on a street (prefix match, e.g. "Grattan St") and/or in a ZIP code, with address, building class, units, owner of record and open-item count. Paginate with limit/offset.

## Datasets
- PLUTO (Dept. of City Planning) (64uk-42ks) — https://data.cityofnewyork.us/d/64uk-42ks — city updated 2026-08-24, synced 2026-10-31; daily check; reload only when the city publishes
- Building Footprints (5zhs-2jue) — https://data.cityofnewyork.us/d/5zhs-2jue — city updated 2026-10-25, synced 2026-10-31; weekly
- DOB Permit Issuance (BIS) (ipu4-2q9a) — https://data.cityofnewyork.us/d/ipu4-2q9a — city updated 2026-10-31, synced 2026-10-31; weekly
- DOB NOW: Build – Approved Permits (rbx6-tga4) — https://data.cityofnewyork.us/d/rbx6-tga4 — city updated 2026-10-30, synced 2026-10-31; daily
- DOB Job Application Filings (BIS) (ic3t-wcy2) — https://data.cityofnewyork.us/d/ic3t-wcy2 — city updated 2026-10-30, synced 2026-10-31; weekly
- DOB NOW: Build – Job Application Filings (w9ak-ipjd) — https://data.cityofnewyork.us/d/w9ak-ipjd — city updated 2026-10-30, synced 2026-10-31; daily
- DOB Violations (3h2n-5cm9) — https://data.cityofnewyork.us/d/3h2n-5cm9 — city updated 2026-10-31, synced 2026-10-31; daily
- DOB ECB Violations (6bgk-3dad) — https://data.cityofnewyork.us/d/6bgk-3dad — city updated 2026-10-31, synced 2026-10-31; daily
- OATH Hearings Division Case Status (jz4z-kudi) — https://data.cityofnewyork.us/d/jz4z-kudi — city updated 2026-10-31, synced 2026-10-31; daily
- HPD Housing Maintenance Code Violations (wvxf-dwi5) — https://data.cityofnewyork.us/d/wvxf-dwi5 — city updated 2026-10-31, synced 2026-10-31; daily
- HPD Housing Maintenance Code Complaints and Problems (ygpa-z7cr) — https://data.cityofnewyork.us/d/ygpa-z7cr — city updated 2026-10-31, synced 2026-10-31; daily
- HPD Multiple Dwelling Registrations (tesw-yqqr) — https://data.cityofnewyork.us/d/tesw-yqqr — city updated 2026-10-28, synced 2026-10-31; daily check; reload only when the city publishes
- HPD Registration Contacts (feu5-w2e2) — https://data.cityofnewyork.us/d/feu5-w2e2 — city updated 2026-10-28, synced 2026-10-31; daily check; reload only when the city publishes
- 311 Service Requests from 2020 to Present (erm2-nwe9) — https://data.cityofnewyork.us/d/erm2-nwe9 — city updated 2026-10-31, synced 2026-10-31; daily
- DOF Property Valuation and Assessment Data (8y4t-faws) — https://data.cityofnewyork.us/d/8y4t-faws — city updated 2026-09-14, synced 2026-10-31; daily
- ACRIS Real Property Master (bnx9-e6tj) — https://data.cityofnewyork.us/d/bnx9-e6tj — city updated 2026-10-08, synced 2026-10-31; daily
- ACRIS Real Property Legals (8h5j-fqxa) — https://data.cityofnewyork.us/d/8h5j-fqxa — city updated 2026-10-08, synced 2026-10-31; daily
- ACRIS Real Property Parties (636b-3b5g) — https://data.cityofnewyork.us/d/636b-3b5g — city updated 2026-10-08, synced 2026-10-31; daily

## Limits
Records are matched to lots by the BBL the agency published; some records lack a BBL. HPD complaints are kept from 2019, 311 for the last 12 months, assessments for three tax years, ACRIS deeds only. Independent site. Data from NYC Open Data; not affiliated with the City of New York. Not a title search, legal advice, or an official record.