Fresh building records for every NYC address — not last month's Open Data dump.

Create a trial API key. Body: { "email": "you@company.com" }. The key is returned once.

Returns the building's last-refresh time and per-agency status, or found: false if we don't hold it yet. Pass a bin, an address, or q (auto-detected). Top-level status is "ready" or "refreshing".

{
  "found": true,
  "bin": "1001780",
  "address": "1 CENTRE STREET, MANHATTAN",
  "status": "ready",
  "lastRefreshedAt": "2026-07-08T18:20:11.004Z",
  "ageSeconds": 512,
  "refreshInProgress": false,
  "refreshStartedAt": null,
  "canRefresh": false,
  "cooldownRemainingSeconds": 42688,
  "agencies": [
    { "id": "bis_jobs", "label": "BIS Jobs", "status": "ok", "count": 143, "source": "live" }
  ]
}

Data is served live-only— we don't substitute stale NYC Open Data. If an agency's website is down when you refresh, that source keeps the last data we successfully scraped and carries a refreshError in agencies[] (its status is error if we hold no prior data). A handful of agencies with no live source yet (CofO, HPD, LPC violations) are still served from Open Data.

While a refresh is running, status is "refreshing", refreshInProgress is true, and lastRefreshedAt still reflects the last completedrefresh (it only advances once the new one finishes) — so a poller can tell "done" from "still going". Individual sources report status: "loading" in agencies[] until they land.

Queue a refresh from the source agencies. Body: { "bin": "…" } or { "address": "…" }. We scrape one building at a time(a single shared connection to the city's systems), so your request joins a queue and returns 202 with a jobId and your place in line. A 429 refresh_cooldown means it was refreshed within the last 12h — just read it from /freshness.

{
  "status": "queued",              // or "running" if it started immediately
  "deduped": false,                // true = you rejoined a pending refresh
  "bin": "1001780",
  "queue": {
    "status": "queued",
    "position": 3,                 // 1 = being scraped right now
    "refreshesAhead": 2,           // buildings that finish before yours
    "queueLength": 2,
    "jobId": "job_1001780_7"
  },
  "message": "Queued at position 3 — 2 refreshes ahead of you…"
}

Poll your place in the queue. Pass the same building (or the jobId you got back) and watch queue.status move queued → running → done (or error). While queued, position counts down to 1. Once it's done, read the fresh data from /freshness and /data. (Queue status is also mirrored in the queue field of every /freshness response.) not_found means no pending or recent job — check /freshness for the current data.

Returns the stored records for one agency. agency is a dataset id (e.g. bis_jobs, fdny) or a group name (e.g. DOB BIS, HPD) which expands to all its datasets. Row datasets page with limit (max 1000) + offset.

Lists every dataset id, its label, and its group — the values /data accepts. No auth required.

Liveness probe. No auth required.