{"uid":"cap_IMbiwHF476qWasQJ2OpUs","slug":"2s-io-bac628c6","name":"NYC Department of Buildings Permits Search","description":"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.","url":"https://2s.io/api/property/nyc-permits","method":"GET","headers":{},"bodySchema":{"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."}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"bbl":"1001234567","limit":10,"offset":0}}},"response":{"data":{"ok":true,"items":[],"total":0,"source":{"url":"https://opendata.cityofnewyork.us/","license":"NYC Open Data terms (free, public domain attribution recommended).","provider":"NYC OpenData (City of New York via Socrata)"}},"meta":{"cost":{"usd":0.0012,"tier":0},"caller":"x402","version":null,"endpoint":"property.nyc-permits","settlement":{"txHash":"0xe0b102ebe8301baa709b3bf2bfc9995cd25f62bd7cd1c4a26fb836ccae6cd7b6","network":"eip155:8453","success":true}}}},"exampleRequest":{"bbl":"1001234567","limit":10,"offset":0},"tags":["x402"],"displayCostAmount":"0.0012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9WORcToC32pKUmASfHnKu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search every NYC DOB construction, alteration, or demolition permit ever issued by BBL or address, with filters for job type and permit status","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-07-15T14:36:23.805Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:37:57.774Z","isFirstParty":false}