Jurisdictions resource

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

Method	Path	Status
`GET`	`/v1/jurisdictions/{slug}/cohorts/distribution`	Live
`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.

Introduction

Concepts

API Reference

Reference

Jurisdictions resource

Active endpoints

Slug conventions

Proposed: list endpoint contract preview

​Active endpoints

​Slug conventions

​Proposed: list endpoint contract preview

Active endpoints

Slug conventions

Proposed: list endpoint contract preview