{"uid":"cap_rmLMVWxz-7PmLQQ0X_ULr","slug":"shovels-api-jurisdiction-building-permit-search-31a29183","name":"Shovels API — Jurisdiction Building Permit Search","description":"Pay-per-call access to the Shovels building-permits search API over x402 and MPP. Search US building permits by date, location, and contractor — no accounts, no subscriptions, pay per request.","url":"https://stable-shovels.dev/api/jurisdictions/search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"q":{"type":"string","minLength":1,"description":"The term to search for."},"size":{"type":"integer","maximum":100,"minimum":1,"description":"Records to return per page (1–100, default 50). Determines the price — each record returned costs one credit."},"cursor":{"type":"string","description":"Pagination cursor — pass the `next_cursor` from a prior page."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","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.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZbDhOKGTgN4nBkUWpvbxi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search US building permits by jurisdiction, date range, location, and contractor via a pay-per-call API","exampleAgentPrompt":"Search Shovels for all building permits filed in Austin, TX between January 1 2024 and June 30 2024 for roofing contractors — I want to see what permit activity looks like in that jurisdiction.","exampleUseCases":[{"title":"Contractor vetting before hiring","prompt":"Look up all building permits filed by Apex Roofing & Construction in San Diego County over the last two years — I want to see how active they are and whether they've been pulling permits properly before I hire them."},{"title":"Neighborhood construction activity research","prompt":"Find all building permits issued within the 90210 zip code in the past six months — I'm trying to get a sense of how much construction activity is happening in that neighborhood before I make an offer on a property."},{"title":"Real estate due diligence on a property","prompt":"Search for any building permits associated with 4521 Maple Street in Chicago, IL going back to 2018 — I need to know what work has been done on the property and whether it was all properly permitted before we close the deal."}],"resultDescription":"A list of matching US building permit records filtered by the supplied jurisdiction, date range, location, and/or contractor criteria — each record likely includes permit ID, type, contractor, address, dates, and jurisdiction details.","failureModes":["Payment not received — x402 payment required before request is fulfilled","Invalid jurisdiction identifier — returns error if jurisdiction is not recognized","Date range too broad — may return paginated or truncated results","No matching permits found — returns empty result set for valid but unmatched queries","Malformed POST body — missing required search fields returns validation error"],"whenToPreferThis":"Choose this endpoint when you need on-demand, no-subscription access to US building permit data searchable by jurisdiction, contractor, or date — especially useful for real estate research, contractor vetting, or construction market intelligence without committing to a recurring plan. Ideal for agents that make infrequent or exploratory permit queries and prefer pay-per-call USDC pricing via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:39:24.810Z","isFirstParty":false}