City of New York

Open Data NY Live

Query public building permit status for City of New York via the SignedOff API.

Quick Start

# Look up a City of New York permit
curl -H "X-API-Key: YOUR_KEY" \
"https://signedoff.io/api/v1/permits/M00855935-I1/status?jurisdiction=nyc_dob"

Include jurisdiction=nyc_dob for stable routing across DOB NOW, legacy BIS, electrical, elevator, and LAA identifier families.

Sample Response

{
"permit_number": "M00855935-I1",
"status": "LOC Issued",
"jurisdiction": "City of New York (DOB)",
"platform": "socrata",
"data_freshness": {
"cached": true,
"last_refreshed": "2026-05-07T08:00:00Z",
"cache_ttl_seconds": 14400
}
}

Integration Notes

  • NYC DOB records are split across several official public datasets. SignedOff returns the fields published for the matched record family; it does not imply complete inspection or workflow history.
  • Permit data is cached for 4 hours. The data_freshness object in every response shows when the data was last fetched from the portal.
  • Pro and Enterprise plans can use force_refresh=true to bypass the cache and fetch live data.

The SignedOff API provides programmatic access to City of New York building permit data from its official public source. Developers receive structured status and available job or permit metadata from the matched NYC DOB public source without repeating manual lookups. Available fields remain source-specific, and the official jurisdiction record is authoritative.

Jurisdiction API FAQ

City of New York permit API questions

How do I check City of New York permit status by API?

Send the exact permit or filing identifier with jurisdiction=nyc_dob. The response includes the status and metadata published by the matched DOB NOW, approved-permit, legacy, electrical, elevator, or LAA source, plus data-freshness details. Inspection and workflow depth varies by source.

What permit number format does City of New York use?

A representative City of New York permit number is M00855935-I1. Permit formats can vary by record type and issue year, so applications should preserve letters, digits, and separators exactly as issued.

How fresh is City of New York permit data?

SignedOff caches permit responses for up to four hours and reports the last refresh time in every response. Pro and Enterprise requests can use force_refresh=true when an immediate portal check is needed.

Does the City of New York Permit API require a jurisdiction parameter?

Use jurisdiction=nyc_dob. Some modern DOB NOW identifiers can be detected automatically, but the explicit parameter is reliable across legacy and trade-specific formats that may overlap other jurisdictions.

API Docs All Jurisdictions City of New York City Page Get API Key