---
title: "Get cities list"
method: GET
path: "/api/cities"
tags: ["locations"]
---

# Get cities list

`GET /api/cities`

Get list of cities. Supports optional search and province filters for autocomplete functionality.

## Query parameters

- `search` string, nullable — Search term to filter cities by name (useful for autocomplete)
- `province_code` string, nullable — Optional province code filter (e.g. RM, MI)
- `limit` integer, nullable — Maximum number of results to return (useful for autocomplete)

## Response `200`

Successful Response

- CitiesListResponse — Cities list response model.
  - `cities` CityResponse[], required — List of cities
    - `id` integer, required — City ID
    - `name` string, required — City name
    - `province_code` string, nullable — Province code
    - `cadastral_code` string, nullable — Cadastral code
  - `total` integer, required — Total number of cities

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/corabea/apis/corabea-api.md) · [All operations](https://skmtc.dev/corabea/apis/corabea-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corabea/corabea-api/revisions/13c1bce1bdc4/schema)