$ man building-permits
/building-permits(1)
NAME
building-permits — building permits multi-city open-data lookup
SYNOPSIS
POST https://x402.org/v1/building-permits
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Building permits multi-city open-data lookup. NYC, SF, Chicago, LA, Seattle, Austin. Filter by address substring, status, type, recency. Each city normalized to common shape (id, type, status, description, address, dates, cost). Real-estate / construction primitive.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| city | string | One of: 'nyc', 'sf', 'chicago', 'la', 'seattle', 'austin'. | required |
| address | string | Street name or address substring (case-insensitive). Optional. | optional |
| status | string | Filter on permit status (city-specific values, e.g. 'ISSUED'). Optional. | optional |
| permit_type | string | Filter on permit type (city-specific). Optional. | optional |
| days | number | Restrict to permits within last N days. Optional. | optional |
| limit | number | Max records to return (1-100). Default 20. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| city | string | City slug requested or matched (nyc, sf, chicago, la, seattle, austin). |
| city_name | string | Human-readable city name for the permits returned. |
| dataset | string | Source open-data dataset identifier the permits were pulled from. |
| source_portal | string | URL of the city's open-data portal that hosts the underlying permit dataset. |
| total | number | Count of permit records returned after filters applied. |
| permits | array | Array of normalized permit records with id, type, status, description, address, dates, and cost. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/building-permits \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# install once claude mcp add x402 --command "npx x402-deployer-mcp" # then ask Claude Code: # "use the building-permits tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- real-estatepermitsconstructionopen-databuildingnycsfchicagolaseattleaustindue-diligenceproperty
- methods
- POST
- cluster
- locale
- price
- $0.03 USDC per call
ADJACENT — other endpoints in locale
| endpoint | description | price |
|---|---|---|
| address-geocode | Geocoder / address-to-lat-lng / location resolver. | $0.02 |
| airport-delays | FAA NAS Status — current US airport delays, ground stops, ground delay programs, weather-driven program changes. | $0.02 |
| bin-lookup | Credit card BIN / IIN lookup. | $0.02 |
| card-bin-lookup | Credit card BIN lookup / IIN lookup / card-issuer lookup. | $0.02 |
| reverse-geocode | Reverse geocoder / lat-lng-to-address. | $0.02 |
| satellite-bbox | Bounding-box satellite composite / Sentinel-2 cloud-free mosaic / region satellite snapshot / arbitrary bbox to imagery. | $0.02 |
| flight-status | Flight status / live aircraft position / flight tracker / ICAO24 lookup / callsign lookup / aircraft bounding-box / OpenSky Network state… | $0.01 |
| property-tax | Property tax lookup. | $0.01 |
SEE ALSO