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.

​
2026-05-24 — v1 public launch

First public release.

​
Live now

  • GET /v1/jurisdictions/{slug}/cohorts/distribution — per-jurisdiction cohort breakdown across the canonical 18 cohorts. Cached 1 hour upstream (Cache-Control: max-age=3600).
  • 26 metros covered (18 MAPPED + 5 SOURCE + 3 DEPLOY-PENDING):
    • MAPPED (18): NYC, LA, Chicago, Houston, SF, Seattle, Boston, Atlanta, DC, Dallas, Philadelphia, San Diego, Charlotte, Nashville, Columbus, Indianapolis, Fort Worth, San Antonio.
    • SOURCE (5): Phoenix, Austin, Miami, Portland, Las Vegas.
    • DEPLOY-PENDING (3): Denver, Oklahoma City, Jacksonville.
    See Concepts → Jurisdictions for the status meanings.
  • 18 canonical cohorts classified per permit via PermitCore’s LLM-1 classifier. See Concepts → Cohorts for the full taxonomy + what each cohort covers.
  • Free in-browser sandbox at permitcore.io/sandbox — client-side DuckDB-WASM queries against the last 10 days of permits across the 18 MAPPED metros. No signup required.
  • Self-serve signup + tier subscriptions via Stripe Checkout. Free / Hobby (49/mo)/Builder(49/mo) / Builder (149/mo) / Growth ($299/mo) tiers.

​
Coming ~3 weeks (Bucket 2)

  • GET /v1/permits — paginated permit-listing endpoint with cohort + jurisdiction + date filters. Returns full row data with field-level DQ flags.
  • POST /v1/keys + GET /v1/keys + DELETE /v1/keys/{prefix} — programmatic API key management.
  • GET /v1/keys/{prefix}/usage — per-key request counters + recent invocation log.
  • Tier-aware rate limits. Per-tier monthly request quotas + per-tier cohort coverage. Currently uniform at 100K req/mo across all keys during the early-launch window.
  • OpenAPI 3.1 spec exposed at https://api.permitcore.io/openapi.json.
  • Webhook stream for real-time permit-filing push delivery (paid tiers).

​
Coming later (Bucket 3+)

  • Additional cohort splits (commercial_roofing, residential_solar, data_center) — currently rolled into commercial_alteration / residential_mep / industrial_new respectively.
  • Snowflake + BigQuery share endpoints for Pro / Enterprise tiers.
  • MCP server (Claude Desktop, Cursor, Cline integration) for AI-agent use.

​
Deprecations

None yet — this is the initial v1 release.

​
How to track changes

  • This page is the canonical source.
  • Major changes are also surfaced in the in-product /account dashboard.
  • Breaking changes are versioned (/v2); the prior major version receives security patches but no new features.