# OneShot Place Permits Lookup > OneShot Place Permits Lookup is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-16). Search and retrieve building/construction permit records for addresses in Chicago and New York City by address, date range, permit type, and other filters. ## Facts - Endpoint: POST https://win.oneshotagent.com/v1/tools/lookup/place-permits?utm_source=zero.xyz - Price: $0.001/call - Payment: x402 - Status: unknown - Last checked: 2026-10-16 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/oneshot-place-permits-lookup-460c1d7e - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wiD4W-IIovs-9U0SF5nti 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 oneshot-place-permits-lookup-460c1d7e -d '' ``` Example prompt: 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. ## When to prefer this 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). ## Known failure modes - 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 ## How this service works Tools, payments, and compute orchestration for autonomous AI agents. ## Authentication - **`x402Payment`** — paid tool endpoints use the [x402 payment protocol](https://x402.io). First call returns `402 Payment Required` with a quote; sign and resend the request with `payment-signature: ` and `X-Quote-ID: `. - **`agentId`** — free read-only endpoints accept `X-Agent-ID: ` (0x… address). - **`soulKey`** — soul marketplace seller dashboard uses `Authorization: Bearer soul_…` (issued by `POST /v1/soul/register`). - **`acpBearer`** — Stripe ACP checkout sessions use a separate bearer token plus the `API-Version: 2026-01-30` header. ## Async tools & polling Most tool endpoints return `202 Accepted` with `{ request_id, tool, status }`. Poll `GET /v1/requests/{id}` (with the same `X-Agent-ID`) to retrieve the final result. A WebSocket fallback is available at `wss:///v1/requests/subscribe`. ## Pricing See [docs.oneshotagent.com/pricing](https://docs.oneshotagent.com/pricing) for the full table. Per-call prices for this environment: | Tool | Cost | |---|---| | Web search | $0.001 | | Web read | $0.002 | | Research | $0.01 | | Person profile | $0.005 | | Person email status | $0.001 | | Person dossier | $0.10 | | Person social accounts | $0.50 | | Business search | $0.01 | | Commerce search | $0.002 | | LinkedIn history sync | $0.02 per bounded run | | LinkedIn reply | $0.02 per message | | LinkedIn message to a connection | $0.02 per message | | LinkedIn profile view | $0.01 per view | | LinkedIn post reaction | $0.01 per reaction | | Email send | quote-based; service fee from $0.005 per send | | SMS send | $0.0035 per segment per recipient | | Voice call | $0.35/minute + $5.00 number registration on the first call | | Browser task | quote-based; minimum $0.005 | | Website build | quote-based; from $1.00 | | Compute goal | quote-based; minimum budget $1.00 + 20% platform fee | ## Error format `{ "error": "", "message": "", "details": }`. Validation errors include a `details` field with the failing field paths. ## Output 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. ## Request schema (JSON Schema) ```json { "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" } } } ``` ## Response schema (JSON Schema) ```json { "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" } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-place-permits-lookup-460c1d7e/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)