Skip to main content
GET
/
v2
/
cities
List cities
curl --request GET \
  --url https://staging.api.prexsell.com/v2/cities
{
  "data": {
    "cities": [
      {
        "id": "cld1a2b3c4d5e6f7g8h9i0j1",
        "name": "ΠšΠΈΡ—Π²",
        "slug": "kyiv",
        "country": "UA",
        "timeZone": "Europe/Kyiv"
      }
    ],
    "total": 1
  }
}

Query Parameters

​
search
string

Filter cities by name or translation (minimum 2 characters).

Minimum string length: 2
Example:

"ΠšΠΈΡ—Π²"

​
country
enum<string>

ISO 3166-1 alpha-2 country code to filter cities.

Available options:
UA,
TR,
PL,
CZ,
IT,
DE,
SK,
HU,
BE,
NL,
RO,
BG,
FR,
AT,
LT,
LV,
EE,
ES,
LU,
CH,
GR,
MD,
SI
Example:

"UA"

​
take
integer
default:50

Maximum number of items to return (1–100).

Required range: 1 <= x <= 100
Example:

50

​
skip
integer | null
default:0

Number of items to skip for offset pagination.

Required range: x >= 0
Example:

0

Response

200 - application/json

Paginated list of cities with name, slug, country, and timezone.

​
data
object
required