---
title: "Поиск гостей"
method: GET
path: "/guests"
tags: ["Гости"]
---

# Поиск гостей

`GET /guests`

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

## Query parameters

- `city_id` integer
- `query` string
- `page` integer
- `limit` integer

## Headers

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

## Response `200`

Список гостей

- object
  - `guests` AdminGuestListItem[], required
    - `id` integer, required — ID гостя
    - `guid` string, uuid, required — GUID гостя
    - `iiko_id` string — ID гостя во внешней POS-системе
    - `telegram_id` integer — Telegram ID гостя
    - `max_id` integer — Max ID гостя
    - `city_id` integer, required — ID города
    - `registred` string, required — Время регистрации
    - `phone` string, required — Телефон гостя
    - `email` string — Email гостя
    - `name` string — Имя гостя
    - `bday` string — Дата рождения
    - `is_subscribed` boolean — Подписан на рассылку
    - `is_confirmed` boolean — Телефон подтвержден
    - `is_anonymous` boolean — Анонимный пользователь
    - `registred_iso` string, date-time — Время регистрации в ISO 8601
    - `is_deleted` boolean — Гость удален
    - `deleted_at` string — Время удаления
  - `next` integer — Номер следующей страницы, если в выдаче есть продолжение

## Other responses

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

## Changes

> 10 revisions in range; 4 could not be searched.

- **2026-05-26** `5fc5ea36f156` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/smartofood/apis/smartofood-admin-api/changes/guests/get.md)

---

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