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

# Get provinces list

`GET /api/provinces`

Get list of province codes. Supports optional search filter for autocomplete functionality.

## Query parameters

- `search` string, nullable — Search term to filter provinces by code (useful for autocomplete)
- `limit` integer, nullable — Maximum number of results to return (useful for autocomplete)

## Response `200`

Successful Response

- ProvincesListResponse — Provinces list response model.
  - `provinces` ProvinceResponse[], required — List of provinces
    - `code` string, required — Province code
  - `total` integer, required — Total number of provinces

## 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)