# NYC Department of Buildings Permits Search

> NYC Department of Buildings Permits Search is a paid API for AI agents from 2s.io, paid per call via x402, $0.0012/call, status unknown (last checked 2026-09-14).

Search every NYC DOB construction, alteration, or demolition permit ever issued by BBL or address, with filters for job type and permit status

## Facts

- Endpoint: GET https://2s.io/api/property/nyc-permits
- Price: $0.0012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-bac628c6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IMbiwHF476qWasQJ2OpUs

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 2s-io-bac628c6
```

Example prompt: Pull up all the NYC DOB permits for the building at BBL 3004300012 — show me any major alterations (A1) that are currently ISSUED, up to 50 results.

## When to prefer this

Use this endpoint when you need authoritative NYC DOB permit records for a specific property identified by BBL or partial street address. Ideal for construction-history research, zoning compliance checks, code-enforcement investigation, or real estate due diligence on NYC properties. Prefer this over general web search when you need structured, filterable permit data with specific fields like job type, permit status, and exact dates.

## Known failure modes

- No permits found for the given BBL or address — returns empty result set
- Invalid or malformed BBL (not 10 digits) — likely returns error or empty results
- Ambiguous address substring matching too many or no properties — returns empty or unintended results
- Invalid jobType or permitStatus filter values — may return empty results or ignored filter
- Pagination offset beyond available records — returns empty results
- Rate limiting or payment failure — returns 402 or 429 error

## How this service works

NYC Department of Buildings permit issuance — every construction, alteration, or demolition permit ever issued. Search by `bbl` (10-digit) or `address` (street_name substring). Filter by jobType (A1=Major Alteration, A2=Minor Alteration, A3=Minor Cosmetic, NB=New Building, DM=Demolition, etc.) or permitStatus (ISSUED, IN PROCESS, RE-ISSUED, REVOKED, etc.). Each row carries job + permit numbers, work type, building type, residential flag, filing/issuance/expiration dates, estimated fee. Use for construction-history agents, code-enforcement research, and zoning compliance checks.

## Output

Returns a paginated list of permit records for the queried property, each containing job and permit numbers, job type code (e.g. A1, NB, DM), work type, building type, residential flag, filing/issuance/expiration dates, permit status, and estimated fee.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "bbl": "1001234567",
   "limit": 10,
   "offset": 0
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "properties": {
      "bbl": {
       "type": "string",
       "description": "10-digit BBL."
      },
      "limit": {
       "type": "integer",
       "default": 25,
       "maximum": 200,
       "minimum": 1
      },
      "offset": {
       "type": "integer",
       "default": 0,
       "minimum": 0
      },
      "address": {
       "type": "string",
       "description": "Partial street name (case-insensitive)."
      },
      "jobType": {
       "type": "string",
       "description": "e.g. A1, A2, NB, DM."
      },
      "permitStatus": {
       "type": "string",
       "description": "e.g. ISSUED, IN PROCESS."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-bac628c6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)