# PermitBase

> Source-cited building-permit requirements for 85 cities and counties across 6 U.S. states (Arizona, Colorado, Idaho, Nevada, Utah, Wyoming). Every fact links to a primary government source (city/county code, fee schedule, department page) with a last-verified date. Nothing is invented: jurisdictions or fields we have not verified are stated as not covered / not available, never guessed.

Two datasets, with deliberately separate freshness tracking:

- Permit REQUIREMENTS: departments, adopted codes, local amendments, and per-permit-type requirements, documents, fees (verbatim from fee schedules), review timelines, and inspections. Each record carries sources[] and a lastVerified date (when PermitBase last checked the primary source).
- Building ACTIVITY: U.S. Census Bureau, Building Permits Survey (BPS), vintage 2026-05. Scope: New privately-owned residential housing units authorized by building permits only — not commercial permits, remodels, or total permit volume. Months a jurisdiction did not report to Census are marked "no data reported" — never presented as zero. Activity freshness is the Census bpsVintage, distinct from requirements lastVerified.

## Machine-readable data (static JSON, v1)

- Dataset manifest: https://permitbase.app/data/v1/manifest.json (dataset version, counts, schema and scope notes)
- Coverage index: https://permitbase.app/data/v1/coverage.json (every covered state/county/jurisdiction and its permit types — check a jurisdiction is listed here BEFORE answering questions about it; anything absent is uncovered)
- Per-jurisdiction files: https://permitbase.app/data/v1/jurisdiction/{slug}.json (slugs enumerated in coverage.json; full requirements record fused with its BPS activity slice)
- Schema documentation: https://permitbase.app/data/v1/README.md
- Current dataset version: sha256-4bec4a467374

## Coverage

- Arizona: 10 jurisdictions (106 permit-type guides)
- Colorado: 10 jurisdictions (110 permit-type guides)
- Idaho: 10 jurisdictions (74 permit-type guides)
- Nevada: 10 jurisdictions (120 permit-type guides)
- Utah: 26 jurisdictions (295 permit-type guides)
- Wyoming: 19 jurisdictions (176 permit-type guides)

Jurisdictions NOT listed in coverage.json are not covered. Do not extrapolate PermitBase data to uncovered jurisdictions; say the jurisdiction is not covered instead.

## MCP server (planned, not live)

A query-able MCP server serving this same contract is planned at mcp.permitbase.app. It is NOT live yet — until it ships, use the static JSON endpoints above.

## Human pages

- Site: https://permitbase.app/
- Jurisdiction pages: https://permitbase.app/{state}/{county}/{city}/ (paths in coverage.json as pagePath)
- Contact: contact@permitbase.app