Vardhol

US building permits as clean JSON

One normalized schema, fresh daily, across jurisdictions that open data misses. Public government records, one stable API — no scraping 3,000 portals yourself.

Try it now — no signup

A shared sample key is baked in. First call in under a minute:

curl -H "X-API-Key: pk_sample_readonly_permits" \
  "https://api.vardhol.dev/permits?jurisdiction=us-il-chicago&type=roofing&limit=5"

Filters: jurisdiction, type (roofing · solar_pv · electrical · new_construction · …), status, since (issued_date), limit, cursor (keyset paging).

Your own key (instant, free)

curl -X POST "https://api.vardhol.dev/signup?email=you@co.com"
# → { "api_key": "pk_…", "monthly_quota": 250 }

Coverage & freshness

Live per-jurisdiction status (records, last crawl, freshness) is public — because "is it fresh and does it cover my county" is the whole question:

curl "https://api.vardhol.dev/coverage"

Don't see your county? Vote for it (this is how we prioritize what to add next):

curl -X POST "https://api.vardhol.dev/request-county?county=Maricopa%20AZ&email=you@co.com"

Pricing

Metered by records/month with a hard quota stop — no overage, no surprise bills. You upgrade to the next tier when you need more.

TierRecords / monthPrice
Free250$0
Starter10,000$49/mo
Growth50,000$149/mo
Scale250,000$399/mo

Endpoints

MethodPathAuthWhat
GET/permitskeynormalized permit records (metered)
GET/coveragepublicjurisdictions + freshness + requested counties
POST/signuppublicinstant free key
POST/request-countypublicvote for a jurisdiction
GET/openapi-uipublicfull OpenAPI reference