---
title: "Get City Details"
method: GET
path: "/cities"
tags: ["Cities"]
---

# Get City Details

`GET /cities`

## Request

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

Return city details and related location hierarchy.

## Query parameters

- `geo_id` string, required: Geolocation ID

## Response `200`

City details and related location hierarchy.

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

## Other responses

- `404`: The given geo_id didn't match any cities
- `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/cities/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)