NYC Scope

• Get Oath Violation — Look up OATH/ECB summonses by ticket number (NOV number), up to 100 per call; a missing leading zero is tolerated (39554575Z finds 039554575Z; meta.resolved maps your spelling to the stored one), served from the mirror (no live city or Finder calls). Returns the mirror record in Socrata column names: hearing_date, hearing_status, hearing_result ("IN VIOLATION", "DEFAULT", "DISMISSED"…), balance_due, penalty_imposed, respondent, violation_location, issuing_agency, plus ":updated_at" (the city's o
• Search Oath Violations — Search OATH/ECB summonses by BBL (10-digit borough-block-lot) or by address. Use type=bbl with q=<bbl>, or type=address with q=<house number + street, borough>. Returns composed search rows (camelCase) — ticketNumber, hearingDate, hearingStatus, balanceDue, respondentName. Pass page (and optionally pageSize, statusTab, sortBy/sortOrder, agencies/statuses/boroughs filters, violationFrom/To, hearingFrom/To) to get one page plus meta.aggregates instead of the whole capped set.
• Get Respondent Address — The respondent's mailing address for one OATH/ECB summons — the fields the city redacted from the public dataset (street address, city, state) recovered from the Summons Finder — plus the inspection location and what the city itself publishes. For authorization forms (OATH GN4): data.form.gn4 is pre-filled with RESPONDENT_NAME_ON_NOTICE, NOTICE_NUMBERS, AUTHORIZER_NAME/ADDRESS/CITY_STATE/ZIP. status=ready means the address is in hand; not_found means the Finder has no record; pending (wait=false
• Search Respondent — Find every OATH/ECB summons issued to a respondent (owner, LLC, contractor) by name. "What else does this respondent have open?"
• Lookup Ecb Violations — Look up DOB-ECB violations by ECB violation number, up to 50 per call (comma-separated); leading zeros and a missing check letter are tolerated (39554575, 039554575Z and 39554575Z all find the same row; meta.resolved maps your spelling to the city one). Raw NYC Open Data 6bgk-3dad rows: ecb_violation_status, hearing_status, hearing_date, penality_imposed, balance_due, respondent_name. meta.source says city or mirror.
• Get Dob Correction Status — Was a DOB violation corrected or is it still open? Up to 50 NOV numbers per call (comma-separated), in the ECB spelling (39554575Z) or the OATH ticket spelling (039554575). One row per number: correction = corrected | open | pending | disapproved | dismissed | unknown, the tri-state corrected flag, the raw certification_status and ecb_violation_status it came from, hearing_date, balance_due, bin and bbl (feed bbl to get_property_report for the whole lot), and the linked BIS record when the city
• List Dob Violations At Lot — Every DOB-ECB violation on one lot (10-digit BBL), all time, newest issue date first, 200 per page (meta.page.next_cursor). Each row carries the correction verdict (correction, tri-state corrected), class, statuses, dates, penalty and balance, respondent name and mailing address, infraction code and law, the OATH spelling in matched, BIN and the PLUTO address. meta.totals counts the lot: all, corrected, pending, disapproved, open, dismissed, unknown, balance_due_total, hearings_past_due, default
• Search Dob Violations — Search DOB-ECB violations by type=bin|bbl|address|respondent|violation_number with q. Local mirror first, live city fallback.
• Search Hpd Violations — HPD housing-maintenance violations at a BBL (wvxf-dwi5), newest first, cursor-paged; optional status=Open|Close.
• Get Hpd Registrations — HPD multiple-dwelling registrations on a lot (tesw-yqqr) with each registration's contacts (feu5-w2e2): owner, head officer, managing agent, site manager… with type and description exactly as HPD files them and the business address. bbl is required; pass bin (the premises BIN) when known. Also data.buildings: every HPD building on the lot (kj4p-ruqc, Buildings Subject to HPD Jurisdiction), registered or not, active or not, Active first, each with buildingId, BIN, address range, registrationId (0
• Get Property Facts — PLUTO facts (owner name, building class, units, year built, zoning, assessed value) and the ACRIS ownership snapshot (current owner, last deed date/amount) for a 10-digit BBL.
• Get Property Report — The whole city picture for one lot (10-digit BBL) in the legacy property-report shape: property (PLUTO), oath, dobEcb (each row with the correction verdict), hpdViolations, hpdLitigations, dobBisPermits, dobNowPermits, dobCertOccupancy, deeds, hpdRegistration, each {source, status ok/empty/stale/error, data, lastSyncedAt}, plus summary, unifiedViolations, openLitigation and freshness. ETag-aware. Requires an API key.
• Find Related Properties — Other lots that share a non-generic owner/respondent entity with this BBL in the ownership graph (PLUTO owner, ACRIS grantee, HPD litigation respondent). "What else does this landlord own?" Requires an API key.

Schemas and invoke metadata: Directory API