Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.permitcore.io/llms.txt

Use this file to discover all available pages before exploring further.

PermitCore is a building-permit data platform. The API ships daily-refreshed permits across 26 US metros today (18 MAPPED + 5 SOURCE + 3 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.

Free sandbox

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

What’s shipping next

Permits endpoint

GET /v1/permits?jurisdiction=&cohort=&since=… — paginated permit rows. ETA ~3 weeks (Bucket 2).

API key management

Programmatic key creation + rotation. ETA ~3 weeks (Bucket 2). Until then, manage keys via your dashboard.

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 →