---
title: "Get Jurisdiction Details"
method: GET
path: "/jurisdictions"
tags: ["Jurisdictions"]
---

# Get Jurisdiction Details

`GET /jurisdictions`

## Request

- Base URL: `https://api.shovels.ai/v2`
- URL: `https://api.shovels.ai/v2/jurisdictions`
- Auth: API key in header `X-API-Key`

Return jurisdiction details and related location hierarchy.

## Query parameters

- `geo_id` string, required: Geolocation ID

## Response `200`

OK

- JurisdictionsDetailsRead: Jurisdiction-specific details read model.
  - `geo_id` string, required: Geolocation ID
  - `name` string, required: Formatted entity name
  - `state` string, required: State abbreviation
  - `cities` object, nullable
  - `counties` object, nullable
  - `zipcodes` string[], nullable

## Other responses

- `404`: The given geo_id didn't match any jurisdictions
- `422`: Validation Error

## Changes

- **2026-08-04** `685b8866c451`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Operation history](https://skmtc.dev/shovels/apis/the-shovels-api-v2/changes/jurisdictions/get.md)

---

[API](https://skmtc.dev/shovels/apis/the-shovels-api-v2.md) - [All operations](https://skmtc.dev/shovels/apis/the-shovels-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/shovels/apis/the-shovels-api-v2/revisions/e9f48948b723?raw)