{"uid":"cap_5QpguYEXoGp0YPMe5ni4Q","slug":"2s-io-b810a26c","name":"NYC HPD Violations Lookup","description":"NYC Housing Preservation & Development (HPD) violations — every notice of violation issued at a multi-family building. Search by `bbl` (10-digit) or `address` (street_name substring). Filter by `classCode` (A=least severe, B=hazardous, C=immediately hazardous) and `currentStatusOnly=true` to limit to open violations. Each row carries violation id, building id, full address + apartment + story, inspection + approved + certify-by + correct-by dates, current status + status date, and the narrative NOV description. Use for landlord-history, code-enforcement, and tenant-rights agents.","url":"https://2s.io/api/property/nyc-violations","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"properties":{"bbl":{"type":"string","description":"10-digit BBL."},"limit":{"type":"integer","default":25,"maximum":200,"minimum":1},"offset":{"type":"integer","default":0,"minimum":0},"address":{"type":"string","description":"Partial street name (case-insensitive)."},"classCode":{"enum":["A","B","C"],"type":"string","description":"Severity class."},"currentStatusOnly":{"type":"boolean","description":"True restricts to open violations."}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_C2jG-UROaPU42VKwMnarC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves NYC Housing Preservation & Development (HPD) notices of violation for multi-family buildings, searchable by BBL or address with optional severity and status filters.","exampleAgentPrompt":"Can you pull up all open HPD violations for the building at 123 West 125th Street in Manhattan — specifically any Class C immediately hazardous ones — so I can check the landlord's code enforcement history?","exampleUseCases":null,"resultDescription":"A paginated list of HPD violation records for the queried building, each containing violation ID, building ID, full address with apartment and story, inspection/approved/certify-by/correct-by dates, current status and status date, and the full Notice of Violation narrative description. Results can be filtered to only open violations and to specific severity classes.","failureModes":["No results returned if BBL or address does not match any HPD-registered building","Invalid BBL format (must be exactly 10 digits) may return empty results or error","classCode must be exactly A, B, or C — other values rejected","offset/limit out of range returns 400 or empty set","Address substring too vague returns many unrelated results","Network or upstream HPD data unavailability returns 5xx"],"whenToPreferThis":"Use this endpoint when you need structured, filterable HPD violation data for NYC multi-family buildings — especially for tenant rights research, landlord background checks, code enforcement analysis, or real estate due diligence. Prefer this over generic NYC open data portals when you need a clean, agent-friendly API with per-call pricing and no authentication setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:29.516Z","isFirstParty":false}