---
title: "List jurisdictions"
method: GET
path: "/jurisdictions"
tags: ["metadata"]
---

# List jurisdictions

`GET /jurisdictions`

Public metadata — no API key required.

Returns all active jurisdictions. By default, only real geographic
jurisdictions (US states + Canadian provinces, `scope=state`) are
returned — cross-cutting federal sources and sub-state regional
feeds are filtered out so customer pickers stay clean.

Use `?scope=federal` to list cross-cutting federal sources (EIA,
FHWA, WZDX_NPS), `?scope=regional` for sub-state feeds (511SF,
WZDX_AUSTIN, ...), or `?scope=all` to return everything.

Each row's `group_id` (when present) points at a record in
`GET /jurisdictions/groups`: a state's primary feed plus its WZDx
and sub-state siblings collapsed under one umbrella id.

## Query parameters

- `scope` 'state' | 'federal' | 'regional' | 'all'

## Response `200`

Array of jurisdictions

- Jurisdiction[]
  - `code` string, required — Identifier used everywhere else in the API (`source`, `jurisdiction`, webhook filters, etc.). Two-letter postal codes for US states and Canadian provinces; `WZDX_<STATE>` for the parallel WZDx feed; ad-hoc codes for sub-state and federal sources (`511SF`, `EIA`, `FHWA`, `WZDX_NPS`, ...).
  - `country` string, required — ISO 3166-1 alpha-2 (`US`, `CA`, `DE`, ...).
  - `group_id` string, nullable — When non-null, points at a record in `GET /jurisdictions/groups` — the canonical bundle that includes this row's primary code plus its WZDx / CWZ / regional siblings. Querying `?jurisdiction=<primary>` on `/events` or `/features` auto-expands to all members.
  - `is_active` boolean, required
  - `last_sync_at` string, date-time, nullable
  - `name` string, required
  - `official_name` string, nullable
  - `scope` 'state' | 'federal' | 'regional', required — `state` is the default — real geographic jurisdictions (US states, Canadian provinces). `federal` covers cross-cutting national sources (`EIA`, `FHWA`, `WZDX_NPS`). `regional` covers sub-state feeds (`511SF`, `WZDX_AUSTIN`, `WZDX_MCDOT`, `WZDX_STC_MO`). The default response from `GET /jurisdictions` is `scope=state` only.

---

[API](https://skmtc.net/road511/apis/road511-traffic-api.md) · [All operations](https://skmtc.net/road511/apis/road511-traffic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/road511/road511-traffic-api/versions/39a088b9c155/schema)