Skip to main content
PermitCore is a building-permit data platform. The API ships nightly-refreshed permits across 25 US metros today (21 MAPPED + 4 DEPLOY-PENDING), with cohort classification, parcel-joined geometry where available, and field-level data-quality flags inline on every row. This documentation covers the public v1 HTTP API at https://api.permitcore.io.

​
What’s live today

Cohort distribution

GET /v1/jurisdictions/{slug}/cohorts/distribution — per-jurisdiction breakdown across the canonical 18 cohorts. Cached 1 hour upstream.

Permits (list + filter)

GET /v1/permits?jurisdiction=&cohort=&issued_after=&per_page=&page= — paginated permit rows with field-level DQ flags.

API key management

Programmatic key creation, listing, revocation, and per-key usage telemetry.

Free sandbox

Search permits across metros in your browser. Client-side DuckDB-WASM; no signup required.

​
Conventions in this doc

  • Base URL: https://api.permitcore.io
  • Auth: Authorization: Bearer <your-key> header on every request
  • Format: JSON in, JSON out (Accept: application/json)
  • Versioning: /v1/... path prefix; breaking changes ship as /v2
  • Slug conventions: jurisdictions use lowercase URL-safe slugs (nyc, la, houston); cohorts use canonical snake_case keys (commercial_alteration, multifamily_new)
Five-minute path from zero to first request: Quickstart →