The building-permits data layer for AI agents
Search US building permits. Pay per request.
Connect your agents to nationwide building-permit data through the Shovels API — filter by date, location, permit type, property, and contractor with no accounts, no subscriptions, no API keys. Every call settles with a micropayment over x402 or MPP.
Install Shovels API into AgentCash. Search US building permits by date, location, and contractor — one origin.
Run in your terminal
Onboard into AgentCash, make one live call against this API, then save it into your agent's persistent context.
Onboard AgentCash
Sets up AgentCash and routes you through credits if needed.
npx agentcash onboardTry the API
Discovers the origin and walks the first live call path.
npx agentcash try https://shovels-api.devAdd for reuse
Keeps Shovels API available in your agent's persistent context.
npx agentcash add https://shovels-api.dev
shovels-api.devEvery search axis. Pay per request.
Args-derived pricing tracks Shovels' own credit cost — one credit per record returned, at $0.005 per credit. Every endpoint is priced from your requested page size (`size`) before the payment challenge: $0.25 for the default 50, capped at $0.50 for a full 100. Resolution lookups cost a few cents with a small `size`.
Permit Search
POST /api/permits/searchSearch US building permits by date range and location, with optional permit, property, and contractor filters.
Contractor Search
POST /api/contractors/searchFind contractors active in a location and date range, filtered by permit, property, and contractor characteristics.
Contractor Permits
POST /api/contractors/permitsList every permit linked to a single contractor id.
Decision Search
POST /api/decisions/searchSearch zoning and land-use decisions by date range and location (state or geo id).
Address Search
POST /api/addresses/searchFind US addresses that have at least one associated permit, with their geo_id.
Geo Search
POST /api/{cities,counties,jurisdictions,states,zipcodes}/searchResolve a place name to a geo_id — the input every permit/contractor/decision search needs.
Tags
POST /api/tagsList all available permit classification tags for use as permit_tags filters.
Machine-readable discovery: /openapi.json · /api/health