---
title: "Read Cities"
method: GET
path: "/api/v1/cities/"
tags: ["cities"]
---

# Read Cities

`GET /api/v1/cities/`

## Request

- Base URL: `https://mcp.fless.io` (the document declares no server; this is the origin it was published from)
- URL: `https://mcp.fless.io/api/v1/cities/`
- Auth: none declared

Retrieve cities with optional search and pagination.
By default, only returns active cities (is_active=True).
Admin users can pass active_only=false to see all cities.

## Query parameters

- `skip` integer
- `limit` integer
- `search` string, nullable
- `active_only` boolean: Filter to only return active cities

## Response `200`

Successful Response

- City[]
  - `name` string, required
  - `slug` string, nullable
  - `state` string, nullable
  - `state_code` string, nullable
  - `country` string, nullable
  - `boundary_kml` string, nullable
  - `is_active` boolean, nullable
  - `default_lat` number, nullable
  - `default_lng` number, nullable
  - `default_zoom` integer, nullable
  - `bbox_north` number, nullable
  - `bbox_south` number, nullable
  - `bbox_east` number, nullable
  - `bbox_west` number, nullable
  - `osm_data_fetched_at` string, date-time, nullable
  - `osm_data_version` string, nullable
  - `poi_count_cached` integer, nullable
  - `tile_status` string, nullable
  - `raster_tile_file_path` string, nullable
  - `raster_tiles_downloaded_at` string, date-time, nullable
  - `raster_tile_status` string, nullable
  - `raster_tile_error` string, nullable
  - `coming_soon` boolean, nullable
  - `estimated_launch_date` string, date-time, nullable
  - `waitlist_count` integer, nullable
  - `tagline` string, nullable
  - `id` integer, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fless/apis/apartment-hunting-platform.md) · [All operations](https://skmtc.dev/fless/apis/apartment-hunting-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/fless/apis/apartment-hunting-platform/revisions/f542b37a2fcf?raw)