---
title: "List Builtin Buttons"
method: GET
path: "/menu-layout/builtin-buttons"
tags: ["menu-layout"]
---

# List Builtin Buttons

`GET /menu-layout/builtin-buttons`

## Request

- The document declares no server URL.
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api/docs/menu-layout/builtin-buttons/get.ts> (a function with typed inputs; its response is checked against the schema)

Получить список встроенных кнопок.

## Response `200`

Successful Response

- BuiltinButtonsListResponse: Список встроенных кнопок.
  - `items` BuiltinButtonInfo[], required
    - `id` string, required: Идентификатор кнопки
    - `default_text` object, required: Текст по умолчанию
    - `callback_data` string, required: callback_data кнопки
    - `default_conditions` ButtonConditions: Условия показа кнопки.
      - `has_active_subscription` boolean, nullable: Требуется активная подписка
      - `subscription_is_active` boolean, nullable: Подписка должна быть активна (не приостановлена)
      - `has_traffic_limit` boolean, nullable: Подписка с лимитом трафика
      - `is_admin` boolean, nullable: Пользователь - админ
      - `is_moderator` boolean, nullable: Пользователь - модератор
      - `referral_enabled` boolean, nullable: Реферальная программа включена
      - `contests_visible` boolean, nullable: Конкурсы видимы
      - `support_enabled` boolean, nullable: Поддержка включена
      - `language_selection_enabled` boolean, nullable: Выбор языка включен
      - `happ_enabled` boolean, nullable: Кнопка Happ включена
      - `simple_subscription_enabled` boolean, nullable: Простая подписка включена
      - `show_trial` boolean, nullable: Показать пробный период
      - `show_buy` boolean, nullable: Показать кнопку покупки
      - `has_saved_cart` boolean, nullable: Есть сохраненная корзина
      - `min_balance_kopeks` integer, nullable: Минимальный баланс в копейках
      - `max_balance_kopeks` integer, nullable: Максимальный баланс в копейках
      - `min_registration_days` integer, nullable: Минимум дней с регистрации
      - `max_registration_days` integer, nullable: Максимум дней с регистрации
      - `min_referrals` integer, nullable: Минимальное количество рефералов
      - `has_referrals` boolean, nullable: Есть рефералы
      - `promo_group_ids` string[], nullable: Список ID промо-групп (пользователь должен быть в одной из них)
      - `exclude_promo_group_ids` string[], nullable: Исключить пользователей из этих промо-групп
      - `has_subscription_days_left` integer, nullable: Минимум дней до окончания подписки
      - `max_subscription_days_left` integer, nullable: Максимум дней до окончания подписки
      - `is_trial_user` boolean, nullable: Пользователь на пробном периоде
      - `has_autopay` boolean, nullable: Автоплатёж включён
    - `supports_dynamic_text` boolean: Поддерживает ли динамический текст
    - `supports_direct_open` boolean: Поддерживает ли прямое открытие Mini App
  - `total` integer, required

## Changes

- **2026-11-03** `2360876ff9c5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api/changes/menu-layout/builtin-buttons/get.md)

---

[API](https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api.md) - [All operations](https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api/revisions/2360876ff9c5?raw)