Pull NYC street opening/construction permit records for a specific address or contractor via NYC Open Data's Socrata API instead of manually browsing the OCMC-linked datasets.

domain: data.cityofnewyork.us · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

In-depth guide

Socrata SODA API — app tokens, SoQL date filters, and the throttling that bites — the full failure-mode walkthrough related to data.cityofnewyork.us, checked against official docs, with linked verified routes.

Steps

  1. Identify the correct dataset for the date range needed: 'Street Construction Permits (2022-Present)' (tqtj-sjs8) for recent data, or 'Street Construction Permits (2013-2021)' (c9sj-fmsg) for historical
  2. Query the Socrata SODA API endpoint (data.cityofnewyork.us/resource/{dataset-id}.json) with SoQL filters on permittee, street name, or issue date
  3. Cross-check against the separate 'Street Opening Permits' (9jic-byiu) and 'OUR_PERMITS' (6kh8-23gv) datasets, which cover overlapping but not identical permit categories
  4. Confirm field-level definitions in each dataset's data dictionary before joining across the split 2013-2021 / 2022-present tables
  5. Register a free Socrata app token if making high-volume queries to avoid throttling

Known gotchas

Related routes

Pull Chicago CDOT street/lane closure permit records via the city's Socrata open-data API instead of manually browsing the ipi.cityofchicago.org portal.
data.cityofchicago.org · 5 steps · unrated
query nyc dohmh public pool inspection results via the nyc open data socrata api
data.cityofnewyork.us · 5 steps · unrated
query city building permit records using the Socrata Open Data API (SODA) for storm-restoration targeting
dev.socrata.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans