{"uid":"cap_wiD4W-IIovs-9U0SF5nti","slug":"oneshot-place-permits-lookup-460c1d7e","name":"OneShot Place Permits Lookup","description":"Tools, payments, and compute orchestration for autonomous AI agents.\n\n## Authentication\n\n- **`x402Payment`** — paid tool endpoints use the [x402 payment protocol](https://x402.io).\n First call returns `402 Payment Required` with a quote; sign and resend the request\n with `payment-signature: ` and `X-Quote-ID: `.\n- **`agentId`** — free read-only endpoints accept `X-Agent-ID: ` (0x… address).\n- **`soulKey`** — soul marketplace seller dashboard uses `Authorization: Bearer soul_…`\n (issued by `POST /v1/soul/register`).\n- **`acpBearer`** — Stripe ACP checkout sessions use a separate bearer token plus the\n `API-Version: 2026-01-30` header.\n\n## Async tools & polling\n\nMost tool endpoints return `202 Accepted` with `{ request_id, tool, status }`. Poll\n`GET /v1/requests/{id}` (with the same `X-Agent-ID`) to retrieve the final result.\nA WebSocket fallback is available at `wss:///v1/requests/subscribe`.\n\n## Pricing\n\nSee [docs.oneshotagent.com/pricing](https://docs.oneshotagent.com/pricing) for the full\ntable. Per-call prices for this environment:\n\n| Tool | Cost |\n|---|---|\n| Web search | $0.001 |\n| Web read | $0.002 |\n| Research | $0.01 |\n| Person profile | $0.005 |\n| Person email status | $0.001 |\n| Person dossier | $0.10 |\n| Person social accounts | $0.50 |\n| Business search | $0.01 |\n| Commerce search | $0.002 |\n| LinkedIn history sync | $0.02 per bounded run |\n| LinkedIn reply | $0.02 per message |\n| LinkedIn message to a connection | $0.02 per message |\n| LinkedIn profile view | $0.01 per view |\n| LinkedIn post reaction | $0.01 per reaction |\n| Email send | quote-based; service fee from $0.005 per send |\n| SMS send | $0.0035 per segment per recipient |\n| Voice call | $0.35/minute + $5.00 number registration on the first call |\n| Browser task | quote-based; minimum $0.005 |\n| Website build | quote-based; from $1.00 |\n| Compute goal | quote-based; minimum budget $1.00 + 20% platform fee |\n\n## Error format\n\n`{ \"error\": \"\", \"message\": \"\", \"details\": }`.\nValidation errors include a `details` field with the failing field paths.","url":"https://win.oneshotagent.com/v1/tools/lookup/place-permits?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"city":{"type":"string","description":"Chicago or New York City; an NYC borough name is also accepted"},"limit":{"type":"integer","description":"Page size, 1-100, default 50"},"state":{"type":"string","description":"Two-letter US state code"},"offset":{"type":"integer","description":"Results to skip, 0-10000, default 0"},"borough":{"type":"string","description":"NYC borough, required when city is New York City"},"issued_to":{"type":"string","description":"Last issue date inclusive, YYYY-MM-DD"},"issued_from":{"type":"string","description":"First issue date inclusive, YYYY-MM-DD"},"permit_type":{"type":"string","description":"Exact source permit type, case insensitive"},"street_address":{"type":"string","description":"Site street address with number and source spelling; no unit or city"}}},"responseSchema":{"type":"json","example":{"limit":50,"total":1,"offset":0,"source":"Chicago Department of Buildings","permits":[{"number":"101046020","status":null,"address":"7529 N CLARK ST","district":"CHICAGO","filed_date":"2024-03-08","contractors":["3 S SUPPLY COMPANY","INTEGRITY SIGN COMPANY"],"description":"INSTALLATION OF A WALL SIGN ON THE FRONT ELEVATION","issued_date":"2024-09-18","permit_type":"PERMIT - SIGNS","declared_value":5500,"expiration_date":null}],"coverage":"NYC legacy permit issuances and Chicago only; exact address matching. No match does not prove no work occurred.","loaded_at":"2026-10-14T00:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_M4aZ7GOOQ4869JCY3xad-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search and retrieve building/construction permit records for addresses in Chicago and New York City by address, date range, permit type, and other filters.","exampleAgentPrompt":"Can you pull up any building permits issued for 7529 N Clark St in Chicago, IL between January 2024 and September 2024? Show me up to 50 results.","exampleUseCases":[{"title":"Pre-purchase property permit check","prompt":"Before I make an offer on this house, can you look up all building permits ever issued for 123 Main St in Chicago, IL? I want to know what work has been done and whether it was permitted."},{"title":"Verify contractor work permit in NYC","prompt":"Can you search for any permits pulled for 450 West 33rd St in Manhattan, New York City, NY for electrical or plumbing work issued in the last two years — up to 100 results?"},{"title":"Identify unpermitted sign installations","prompt":"Look up sign permits issued for addresses on Milwaukee Ave in Chicago, IL between March 2023 and March 2024, permit type 'PERMIT - SIGNS', and return the first 50 results."}],"resultDescription":"Returns a paginated JSON object containing total count, source name, data load timestamp, coverage disclaimer, and an array of permit records — each with permit number, address, district, permit type, filed date, issued date, expiration date, contractors, declared value, and description.","failureModes":["No permits found for address — does not prove no work occurred; coverage is limited to Chicago and NYC legacy data","Invalid city value returns error — only 'Chicago' and 'New York City' (or NYC boroughs) are accepted","Missing borough when city is New York City may return incomplete or error results","offset exceeds 10000 causes error","Date format not in YYYY-MM-DD causes rejection","402 Payment Required on first call — must sign and resend with x402 payment headers"],"whenToPreferThis":"Use this endpoint when you need structured, paginated permit records for specific addresses or date ranges in Chicago or New York City. Prefer this over general web search when you need machine-readable permit data including contractors, declared values, and filing dates. Not suitable for cities other than Chicago and NYC, or for confirming absence of unpermitted work (coverage is partial by design).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:39:32.074Z","isFirstParty":false,"canonicalSlug":"oneshot-place-permits-lookup-460c1d7e"}