---
title: "Список городов"
method: GET
path: "/cities"
tags: ["Города"]
---

# Список городов

`GET /cities`

Возвращает список городов. Метод доступен администраторам.

## Query parameters

- `page` integer
- `limit` integer

## Headers

- `X-Lang` 'ru' | 'kk' | 'en' | 'es'

## Response `200`

Список городов

- object
  - `cities` AdminCityListItem[], required
    - `id` integer — ID города
    - `name` string — Название города
    - `phone` string — Телефон колл-центра
    - `folder` string — Папка города в URL
    - `timezone` string — Часовой пояс
    - `working_hours` AdminWorkingHours — Часы работы по дням недели. Ключи объекта - дни недели, значения - часы работы в этот день.
      - `mon` integer[] — Часы работы в понедельник
      - `tue` integer[] — Часы работы во вторник
      - `wed` integer[] — Часы работы в среду
      - `thu` integer[] — Часы работы в четверг
      - `fri` integer[] — Часы работы в пятницу
      - `sat` integer[] — Часы работы в субботу
      - `sun` integer[] — Часы работы в воскресенье
    - `open_hours_shift` integer — Сдвиг времени открытия в минутах
    - `close_hours_shift` integer — Сдвиг времени закрытия в минутах
    - `hide_phone` boolean — Скрыть телефон колл-центра
    - `is_active` boolean — Город активен
    - `order_can` boolean — Прием заказов возможен
    - `order_offtime_can` boolean — Можно оформить заказ в нерабочее время
    - `order_offtime_type` integer — Тип приема заказов в нерабочее время
    - `order_offtime_auto` boolean — Автоматический прием заказов в нерабочее время
    - `order_offtime_manual` boolean — Ручной прием заказов в нерабочее время
    - `order_ontime_shift` integer — Сдвиг времени заказа на точное время в минутах
    - `order_ontime_type` integer — Тип приема заказов на точное время
    - `order_ontime_only_today` boolean — Заказы на точное время доступны только на сегодня
    - `order_ontime_only_tomorrow` boolean — Заказы на точное время доступны только на завтра
    - `order_ontime_today` boolean — Заказы на точное время доступны на сегодня
    - `order_ontime_tomorrow` boolean — Заказы на точное время доступны на завтра
    - `tel` string — Телефон колл-центра в формате для ссылки tel
    - `is_open` boolean — Город сейчас открыт для заказов
    - `open_time` string — Время открытия сегодня
    - `close_time` string — Время закрытия сегодня
  - `next` integer — Номер следующей страницы, если в выдаче есть продолжение

## Other responses

- `400` — Неправильный запрос
- `401` — Пользователь не авторизован
- `403` — Доступ запрещен
- `429` — Превышен лимит на количество запросов
- `500` — Внутренняя ошибка сервера
- `503` — Сервис недоступен или отключен

---

[API](https://skmtc.net/smartofood/apis/smartofood-admin-api.md) · [All operations](https://skmtc.net/smartofood/apis/smartofood-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartofood/smartofood-admin-api/versions/c22dfa568481/schema)