> ## 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.

# Jurisdictions resource

> Overview of jurisdiction-scoped endpoints. Slug conventions, status field, listing endpoint contract.

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](/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.

```json theme={null}
{
  "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
<a href="https://permitcore.io">permitcore.io</a>'s homepage (metro tiles)
and in the URL space of the cohort distribution endpoint.