Skip to main content
The jurisdictions resource scopes data by metro area. Every endpoint below takes a lowercase URL-safe slug (nyc, la, houston) as the primary path parameter.

​
Active endpoints

MethodPathStatus
GET/v1/jurisdictions/{slug}/cohorts/distributionLive
GET/v1/jurisdictions (list all jurisdictions)Not yet available — roadmap
GET/v1/jurisdictions/{slug} (metro detail + totals)Not yet available — roadmap

​
Slug conventions

  • All lowercase
  • Hyphens for multi-word metros (none today; reserved for future expansion)
  • No accents, no special characters
  • Examples: nyc, la, dc, sf, fortworth, sanantonio
A slug that returns 404 from the cohort distribution endpoint means the metro is either DEPLOY-PENDING (in production-ingest queue) or not in PermitCore’s coverage map. See Concepts → Jurisdictions for the full coverage table + status meanings.

​
Proposed: list endpoint contract preview

The list and per-metro detail endpoints are on the roadmap; not yet available. The shape below is a proposed future contract — final shape may differ when the endpoints ship. 
{
  "jurisdictions": [
    {
      "slug": "nyc",
      "display_name": "New York City, NY",
      "status": "MAPPED",
      "total_target_permits": 3218856,
      "as_of_utc": "2026-05-24T02:00:00Z"
    }
  ]
}
Until shipped, the canonical metro list lives on permitcore.io’s homepage (metro tiles) and in the URL space of the cohort distribution endpoint.