---
title: "List configured market entries"
method: GET
path: "/api/v1/cities"
tags: ["Discovery"]
---

# List configured market entries

`GET /api/v1/cities`

## Request

- Base URL: `https://mcp.tempguru.co`
- URL: `https://mcp.tempguru.co/api/v1/cities`
- Auth: none declared

Use this for the canonical configured market catalog or to filter by state or tier (hub / mid / small). A catalog match determines planning rate and lead-time bands; it does not confirm real-time availability or order coverage. A TempGuru coordinator confirms the specific order after buyer submission.

## Query parameters

- `state` string
- `tier` 'hub' | 'mid' | 'small'
- `country` 'US' | 'CA'
- `city` string
- `limit` integer

## Response `200`

Matching cities with tier breakdown.

- union
  - CitiesListResponse
    - `input` object, required: Echo of the query parameters used.
    - `total` integer, required
    - `returned` integer, required
    - `tier_breakdown` object, required
      - `hub` integer
      - `mid` integer
      - `small` integer
    - `cities` City[], required
      - `slug` string, required
      - `name` string, required
      - `state` string, required
      - `state_abbr` string, required
      - `country` string, required
      - `tier` 'hub' | 'mid' | 'small', required
      - `url` string, uri, required
    - `coverage_confirmation_required` true, required
    - `catalog_qualification` string, required
    - `note` string
  - CityCatalogMatchResponse
    - `input` object, required: Echo of the query parameters used.
    - `catalog_check` true, required
    - `requested` string, required
    - `catalog_match` boolean, required: True only when the city resolves to a configured catalog entry; not a coverage or availability promise.
    - `coverage_confirmation_required` true, required
    - `catalog_qualification` string, required
    - `city` City, required
      - `slug` string, required
      - `name` string, required
      - `state` string, required
      - `state_abbr` string, required
      - `country` string, required
      - `tier` 'hub' | 'mid' | 'small', required
      - `url` string, uri, required
    - `suggestion` object
      - `kind` 'city', required
      - `slug` string, required
      - `name` string, required
    - `message` string, required

## Other responses

- `400`: Invalid tier value.

---

[API](https://skmtc.dev/tempguru/apis/tempguru-public-data-api.md) · [All operations](https://skmtc.dev/tempguru/apis/tempguru-public-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tempguru/apis/tempguru-public-data-api/revisions/5969f4556a32?raw)