Reference
Changelog
v1.1 · July 21, 2026
The depth release: browse, feeds, batch, deadlines, test mode
- City-wide browse & filters: GET /v1/restaurants (borough/zip/cuisine/grade/score/risk/vermin filters) and GET /v1/contractors.
- City-wide feeds: GET /v1/violations (every citation, filterable by code/category/borough/date) and GET /v1/inspections (what closed this week).
- Batch endpoints: POST /v1/restaurants/batch (50), /v1/properties/batch (25), /v1/contractors/batch (25) — with meta.notFound for misses.
- The compliance calendar as an API: GET /v1/properties/{bbl}/deadlines — facade/benchmarking/emissions/elevator/boiler/registration obligations with due dates, statuses, and what to do.
- Itemized dockets: /v1/properties/{bbl}/violations + /permits, /v1/contractors/{slug}/tickets with reopenableOnly (live 75-day windows) and hearingAfter.
- Meta & stats: /v1/meta/cuisines, /v1/meta/boroughs, /v1/meta/violation-codes, /v1/stats/restaurants.
- Cursor pagination, multi-value filters, since/until, sorting, and strict unknown-param rejection on all new list surfaces.
- Test mode: dd_test_ keys answer every endpoint from a deterministic fixture city; every commissioned key ships with its test twin; these docs run on a shared public test key.
- Platform: GET /v1/health, GET /v1/openapi.json (the machine-readable contract), RestaurantSummary gains openViolations, /v1/me gains mode.
- These docs: rebuilt as a reference generated from the OpenAPI document, with per-endpoint consoles, guides, and dark mode.
v1.0 · July 21, 2026
Launch
- Restaurants: search, nearby (geo radius), full profile (risk + vermin report + fines), inspection history, violations.
- Properties: address search, profile by BBL (risk, open counts, judgment exposure, per-agency rollup).
- Contractors: company search, docket profile with the reopen-window savings envelope.
- Bearer API keys (SHA-256 at rest, shown once), commissioned daily limits with X-RateLimit headers, /v1/me introspection.