{"openapi":"3.1.0","info":{"title":"Verrow rural public data","version":"0.3.0","description":"Rural public data for AI agents by Verrow, LLC, sold per call in USDC over x402.","termsOfService":"https://api.verrow.ai/terms","x-privacy-policy":"https://api.verrow.ai/privacy"},"x-payment":{"protocol":"x402","network":"eip155:8453","asset":"USDC"},"components":{"securitySchemes":{"prepaidKey":{"type":"http","scheme":"bearer","description":"Prepaid Verrow API key (rk_...). Optional: omit to pay per call with x402 (USDC on Base)."}}},"servers":[{"url":"https://api.verrow.ai"}],"paths":{"/health":{"get":{"summary":"Liveness","responses":{"200":{"description":"ok"}}}},"/mcp":{"post":{"summary":"MCP server (Streamable HTTP)","description":"tools/list is free; paid tools use x402-in-MCP.","responses":{"200":{"description":"MCP JSON response"}}}},"/v1/coverage":{"get":{"operationId":"listCoverage","summary":"list_coverage (free)","description":"List covered jurisdictions and data kinds. Free. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"}}}},"/v1/coverage/check":{"get":{"operationId":"checkCoverage","summary":"check_coverage (free)","description":"Check whether a jurisdiction and data kind is covered before paying. Free. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"}}}},"/v1/pricing":{"get":{"operationId":"getPricing","summary":"get_pricing (free)","description":"List every tool and its per-call price in USDC. Free. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"}}}},"/v1/label-rate":{"get":{"operationId":"getLabelRate","summary":"get_label_rate (paid, x402)","description":"US EPA pesticide product lookup by EPA registration number (e.g. 66551-1). Returns today: product name and registration status, signal word, restricted-use flag, formulation, active ingredients, and label PDF file names with acceptance dates. The application rate, REI and PPE numbers are printed inside those PDFs; this release returns them as UNKNOWN until label-text extraction ships (Phase 2). $0.05 per call in USDC. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"},"402":{"description":"Payment required (x402)"}},"x402":{"price":"$0.05","network":"eip155:8453"},"security":[{},{"prepaidKey":[]}]}},"/v1/tools/get_zoning":{"post":{"operationId":"getZoning","summary":"get_zoning (paid, x402)","description":"Cited zoning rules for a covered rural US jurisdiction: district names, setbacks, height, lot area/width, density and coverage from published code sections. Pass district (or zone) or latitude/longitude; with only a jurisdiction you get the available districts and fields. Unpublished fields are UNKNOWN. $0.10 per call in USDC. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"},"402":{"description":"Payment required (x402)"}},"x402":{"price":"$0.10","network":"eip155:8453"},"security":[{},{"prepaidKey":[]}]}},"/v1/tools/check_use_allowed":{"post":{"operationId":"checkUseAllowed","summary":"check_use_allowed (paid, x402)","description":"Whether a named land use is permitted, conditional or prohibited in a covered jurisdiction's published zoning table, with the exact table row and page citation. Unsure answers are UNKNOWN and a fully UNKNOWN answer is never charged. $0.15 per call in USDC. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"},"402":{"description":"Payment required (x402)"}},"x402":{"price":"$0.15","network":"eip155:8453"},"security":[{},{"prepaidKey":[]}]}},"/v1/tools/get_recent_decisions":{"post":{"operationId":"getRecentDecisions","summary":"get_recent_decisions (paid, x402)","description":"Recent public city council and planning/zoning decisions for a covered jurisdiction: meeting date, body, subject, outcome and the verbatim minute quote with document sha256. $0.10 per call in USDC. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"},"402":{"description":"Payment required (x402)"}},"x402":{"price":"$0.10","network":"eip155:8453"},"security":[{},{"prepaidKey":[]}]}},"/v1/tools/airspace":{"get":{"operationId":"checkAirspace","summary":"check_airspace (paid, x402)","description":"FAA UAS Facility Map airspace check for a US coordinate: whether the point is in a facility-map grid, controlled ceiling, facility IDs and lowest ceiling feet AGL, cited to the FAA FeatureServer document with sha256. $0.02 per call in USDC. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"},"402":{"description":"Payment required (x402)"}},"x402":{"price":"$0.02","network":"eip155:8453"},"security":[{},{"prepaidKey":[]}]}},"/v1/tools/wind":{"get":{"operationId":"getWind","summary":"get_wind (paid, x402)","description":"US National Weather Service gridpoint forecast wind for a coordinate: speed, direction and gust from the next periods, with NWS office/grid and a sha256 of the stored forecast document. $0.01 per call in USDC. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"},"402":{"description":"Payment required (x402)"}},"x402":{"price":"$0.01","network":"eip155:8453"},"security":[{},{"prepaidKey":[]}]}},"/v1/tools/esa-limits":{"get":{"operationId":"getEsaLimits","summary":"get_esa_limits (paid, x402)","description":"EPA Bulletins Live Two endangered-species pesticide use limitation areas for a coordinate and month: effective PULAs and attributes, cited to the BLT MapServer document with sha256. $0.10 per call in USDC. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"},"402":{"description":"Payment required (x402)"}},"x402":{"price":"$0.10","network":"eip155:8453"},"security":[{},{"prepaidKey":[]}]}},"/v1/tools/soil":{"get":{"operationId":"getSoil","summary":"get_soil (paid, x402)","description":"USDA NRCS Soil Data Access SSURGO point lookup: map unit key/name/symbol, major component, drainage class, hydrologic group, taxonomic class and slope, cited to the SDA response with sha256. $0.02 per call in USDC. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"},"402":{"description":"Payment required (x402)"}},"x402":{"price":"$0.02","network":"eip155:8453"},"security":[{},{"prepaidKey":[]}]}},"/v1/tools/spray_check":{"post":{"operationId":"sprayCheck","summary":"spray_check (paid, x402)","description":"Composed spray go/no-go: EPA label product lookup by EPA registration number plus EPA BLT endangered-species limits, NWS wind and FAA UAS airspace for the coordinate, each cited. $0.50 per call in USDC. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"},"402":{"description":"Payment required (x402)"}},"x402":{"price":"$0.50","network":"eip155:8453"},"security":[{},{"prepaidKey":[]}]}},"/v1/tools/get_site_report":{"post":{"operationId":"getSiteReport","summary":"get_site_report (paid, x402)","description":"Site feasibility report for an address/parcel: zoning, allowed-use verdict, permits, recent decisions, FEMA NFHL flood zone and soil, each cited. Returns 422 with no charge when zoning or flood zone is UNKNOWN. $4.00 per call in USDC. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"},"402":{"description":"Payment required (x402)"}},"x402":{"price":"$4.00","network":"eip155:8453"},"security":[{},{"prepaidKey":[]}]}},"/v1/tools/county_pack":{"post":{"operationId":"countyPack","summary":"county_pack (paid, x402)","description":"Buy a $49 county pack: a prepaid API key plus 30 days of jurisdiction credit for one covered county, usable on REST and MCP. $49.00 per pack in USDC. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"},"402":{"description":"Payment required (x402)"}},"x402":{"price":"$49.00","network":"eip155:8453"},"security":[{},{"prepaidKey":[]}]}},"/v1/tools/watch_town":{"post":{"operationId":"watchTown","summary":"watch_town (paid, x402)","description":"Watch a covered town for 30 days: council/planning decisions matching your keywords, delivered to an HTTPS webhook with HMAC signatures and retries. $9.00 per 30 days in USDC. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"},"402":{"description":"Payment required (x402)"}},"x402":{"price":"$9.00","network":"eip155:8453"},"security":[{},{"prepaidKey":[]}]}},"/v1/tools/watch_parcel":{"post":{"operationId":"watchParcel","summary":"watch_parcel (paid, x402)","description":"Watch a parcel for 30 days: new permits or decisions touching it, delivered to an HTTPS webhook with HMAC signatures and retries. $4.00 per 30 days in USDC. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"},"402":{"description":"Payment required (x402)"}},"x402":{"price":"$4.00","network":"eip155:8453"},"security":[{},{"prepaidKey":[]}]}},"/v1/tools/request_coverage":{"post":{"operationId":"requestCoverage","summary":"request_coverage (paid, x402)","description":"Request coverage for a town ($5). Becomes a top-priority demand signal and starts the records agent; you get $5 of call credits for that town once covered. Refund queued after 14 days if not covered. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"},"402":{"description":"Payment required (x402)"}},"x402":{"price":"$5.00","network":"eip155:8453"},"security":[{},{"prepaidKey":[]}]}},"/v1/credits/topup":{"post":{"operationId":"topupCredits","summary":"topup_credits (paid, x402)","description":"Add $5 of prepaid USDC credit to an API key, paid over x402. Credits are spent per call at listed prices. $5.00 per top-up. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"},"402":{"description":"Payment required (x402)"}},"x402":{"price":"$5.00","network":"eip155:8453"},"security":[{},{"prepaidKey":[]}]}},"/v1/keys":{"post":{"operationId":"createApiKey","summary":"create_api_key (free)","description":"Create a prepaid API key for per-call REST or MCP access. The key is shown once. Free. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"}}}},"/v1/credits/balance":{"get":{"operationId":"getBalance","summary":"get_balance (free)","description":"Show remaining prepaid credit, jurisdiction credits and expiry for the API key in the Authorization header. Free. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"}}}},"/v1/credits/usage":{"get":{"operationId":"getUsage","summary":"get_usage (free)","description":"Show recent prepaid credit usage (tool, price, status, time) for the API key in the Authorization header. Free. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"}}}},"/v1/watches/list":{"post":{"operationId":"listWatches","summary":"list_watches (free)","description":"List the 30-day watches owned by an owner token, with expiry and delivery status. Free. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"}}}},"/v1/watches/cancel":{"post":{"operationId":"cancelWatch","summary":"cancel_watch (free)","description":"Cancel a 30-day watch using its id and owner token. Free. Verified against official sources and cited to the page; a fully UNKNOWN answer is never charged. Per-jurisdiction data dates: see check_coverage.","responses":{"200":{"description":"Envelope"}}}}},"x-tools":[{"tool":"check_airspace","price_usd":0.02},{"tool":"check_coverage","price_usd":0},{"tool":"check_use_allowed","price_usd":0.15},{"tool":"county_pack","price_usd":49},{"tool":"get_esa_limits","price_usd":0.1},{"tool":"get_label_rate","price_usd":0.05},{"tool":"get_pricing","price_usd":0},{"tool":"get_recent_decisions","price_usd":0.1},{"tool":"get_site_report","price_usd":4},{"tool":"get_soil","price_usd":0.02},{"tool":"get_wind","price_usd":0.01},{"tool":"get_zoning","price_usd":0.1},{"tool":"list_coverage","price_usd":0},{"tool":"request_coverage","price_usd":5},{"tool":"spray_check","price_usd":0.5},{"tool":"topup_credits","price_usd":5},{"tool":"watch_parcel","price_usd":4},{"tool":"watch_town","price_usd":9}]}