---
title: "Get Subscription Details"
method: POST
path: "/miniapp/subscription"
tags: ["miniapp"]
---

# Get Subscription Details

`POST /miniapp/subscription`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api/docs/miniapp/subscription/post.ts> (a function with typed inputs; its response is checked against the schema)

Получение информации о подписке пользователя в мини-приложении.

## Request body

- MiniAppSubscriptionRequest
  - `initData` string, required

## Response `200`

Successful Response

- MiniAppSubscriptionResponse
  - `success` boolean
  - `subscription_id` integer, nullable
  - `remnawave_short_uuid` string, nullable
  - `user` MiniAppSubscriptionUser, required
    - `telegram_id` integer, nullable
    - `username` string, nullable
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `display_name` string, required
    - `language` string, nullable
    - `status` string, required
    - `subscription_status` string, required
    - `subscription_actual_status` string, required
    - `status_label` string, required
    - `expires_at` string, date-time, nullable
    - `device_limit` integer, nullable
    - `traffic_used_gb` number
    - `traffic_used_label` string, required
    - `traffic_limit_gb` integer, nullable
    - `traffic_limit_label` string, required
    - `lifetime_used_traffic_gb` number
    - `has_active_subscription` boolean
    - `promo_offer_discount_percent` integer
    - `promo_offer_discount_expires_at` string, date-time, nullable
    - `promo_offer_discount_source` string, nullable
    - `is_daily_tariff` boolean
    - `is_daily_paused` boolean
    - `daily_tariff_name` string, nullable
    - `daily_price_kopeks` integer, nullable
    - `daily_price_label` string, nullable
    - `daily_next_charge_at` string, date-time, nullable
  - `traffic_purchases` MiniAppTrafficPurchase[]
    - `id` integer, required
    - `traffic_gb` integer, required
    - `expires_at` string, date-time, required
    - `created_at` string, date-time, required
    - `days_remaining` integer, required
    - `progress_percent` number, required
  - `subscription_url` string, nullable
  - `hide_subscription_link` boolean
  - `subscription_crypto_link` string, nullable
  - `subscription_purchase_url` string, nullable
  - `links` string[]
  - `ss_conf_links` object
  - `connected_squads` string[]
  - `connected_servers` MiniAppConnectedServer[]
    - `uuid` string, required
    - `name` string, required
  - `connected_devices_count` integer
  - `connected_devices` MiniAppDevice[]
    - `hwid` string, nullable
    - `platform` string, nullable
    - `device_model` string, nullable
    - `app_version` string, nullable
    - `last_seen` string, nullable
    - `last_ip` string, nullable
  - `happ` object, nullable
  - `happ_link` string, nullable
  - `happ_crypto_link` string, nullable
  - `happ_cryptolink_redirect_link` string, nullable
  - `happ_cryptolink_redirect_template` string, nullable
  - `balance_kopeks` integer
  - `balance_rubles` number
  - `balance_currency` string, nullable
  - `transactions` MiniAppTransaction[]
    - `id` integer, required
    - `type` string, required
    - `amount_kopeks` integer, required
    - `amount_rubles` number, required
    - `description` string, nullable
    - `payment_method` string, nullable
    - `external_id` string, nullable
    - `is_completed` boolean, required
    - `created_at` string, date-time, required
    - `completed_at` string, date-time, nullable
  - `promo_offers` MiniAppPromoOffer[]
    - `id` integer, required
    - `status` string, required
    - `notification_type` string, nullable
    - `offer_type` string, nullable
    - `effect_type` string, nullable
    - `discount_percent` integer
    - `bonus_amount_kopeks` integer
    - `bonus_amount_label` string, nullable
    - `expires_at` string, date-time, nullable
    - `claimed_at` string, date-time, nullable
    - `is_active` boolean
    - `template_id` integer, nullable
    - `template_name` string, nullable
    - `button_text` string, nullable
    - `title` string, nullable
    - `message_text` string, nullable
    - `icon` string, nullable
    - `test_squads` MiniAppConnectedServer[]
      - `uuid` string, required
      - `name` string, required
    - `active_discount_expires_at` string, date-time, nullable
    - `active_discount_started_at` string, date-time, nullable
    - `active_discount_duration_seconds` integer, nullable
  - `promo_group` MiniAppPromoGroup
    - `id` integer, required
    - `name` string, required
    - `server_discount_percent` integer
    - `traffic_discount_percent` integer
    - `device_discount_percent` integer
    - `period_discounts` object
    - `apply_discounts_to_addons` boolean
  - `auto_assign_promo_groups` MiniAppAutoPromoGroupLevel[]
    - `id` integer, required
    - `name` string, required
    - `threshold_kopeks` integer, required
    - `threshold_rubles` number, required
    - `threshold_label` string, required
    - `is_reached` boolean
    - `is_current` boolean
    - `server_discount_percent` integer
    - `traffic_discount_percent` integer
    - `device_discount_percent` integer
    - `period_discounts` object
    - `apply_discounts_to_addons` boolean
  - `total_spent_kopeks` integer
  - `total_spent_rubles` number
  - `total_spent_label` string, nullable
  - `subscription_type` string, required
  - `autopay_enabled` boolean
  - `autopay_days_before` integer, nullable
  - `autopay_days_options` integer[]
  - `autopay` MiniAppSubscriptionAutopay
    - `enabled` boolean
    - `autopay_enabled` boolean, nullable
    - `autopay_enabled_at` string, date-time, nullable
    - `days_before` integer, nullable
    - `autopay_days_before` integer, nullable
    - `default_days_before` integer, nullable
    - `autopay_days_options` integer[]
    - `days_options` integer[]
    - `options` integer[]
  - `autopay_settings` MiniAppSubscriptionAutopay
    - `enabled` boolean
    - `autopay_enabled` boolean, nullable
    - `autopay_enabled_at` string, date-time, nullable
    - `days_before` integer, nullable
    - `autopay_days_before` integer, nullable
    - `default_days_before` integer, nullable
    - `autopay_days_options` integer[]
    - `days_options` integer[]
    - `options` integer[]
  - `branding` MiniAppBranding
    - `service_name` object
    - `service_description` object
  - `faq` MiniAppFaq
    - `requested_language` string, required
    - `language` string, required
    - `is_enabled` boolean
    - `total` integer
    - `items` MiniAppFaqItem[]
      - `id` integer, required
      - `title` string, nullable
      - `content` string, nullable
      - `display_order` integer, nullable
  - `legal_documents` MiniAppLegalDocuments
    - `public_offer` MiniAppRichTextDocument
      - `requested_language` string, required
      - `language` string, required
      - `title` string, nullable
      - `is_enabled` boolean
      - `content` string
      - `created_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
    - `service_rules` MiniAppRichTextDocument
      - `requested_language` string, required
      - `language` string, required
      - `title` string, nullable
      - `is_enabled` boolean
      - `content` string
      - `created_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
    - `privacy_policy` MiniAppRichTextDocument
      - `requested_language` string, required
      - `language` string, required
      - `title` string, nullable
      - `is_enabled` boolean
      - `content` string
      - `created_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
  - `referral` MiniAppReferralInfo
    - `referral_code` string, nullable
    - `referral_link` string, nullable
    - `bot_referral_link` string, nullable
    - `terms` MiniAppReferralTerms
      - `minimum_topup_kopeks` integer
      - `minimum_topup_label` string, nullable
      - `first_topup_bonus_kopeks` integer
      - `first_topup_bonus_label` string, nullable
      - `inviter_bonus_kopeks` integer
      - `inviter_bonus_label` string, nullable
      - `commission_percent` number
    - `stats` MiniAppReferralStats
      - `invited_count` integer
      - `paid_referrals_count` integer
      - `active_referrals_count` integer
      - `total_earned_kopeks` integer
      - `total_earned_label` string, nullable
      - `month_earned_kopeks` integer
      - `month_earned_label` string, nullable
      - `conversion_rate` number
    - `recent_earnings` MiniAppReferralRecentEarning[]
      - `amount_kopeks` integer
      - `amount_label` string, nullable
      - `reason` string, nullable
      - `referral_name` string, nullable
      - `created_at` string, date-time, nullable
    - `referrals` MiniAppReferralList
      - `total_count` integer
      - `has_next` boolean
      - `has_prev` boolean
      - `current_page` integer
      - `total_pages` integer
      - `items` MiniAppReferralItem[]
        - `id` integer, required
        - `telegram_id` integer, nullable
        - `full_name` string, nullable
        - `username` string, nullable
        - `created_at` string, date-time, nullable
        - `last_activity` string, date-time, nullable
        - `has_made_first_topup` boolean
        - `balance_kopeks` integer
        - `balance_label` string, nullable
        - `total_earned_kopeks` integer
        - `total_earned_label` string, nullable
        - `topups_count` integer
        - `days_since_registration` integer, nullable
        - `days_since_activity` integer, nullable
        - `status` string, nullable
  - `subscription_missing` boolean
  - `subscription_missing_reason` string, nullable
  - `trial_available` boolean
  - `trial_duration_days` integer, nullable
  - `trial_status` string, nullable
  - `trialPaymentRequired` boolean
  - `trialPriceKopeks` integer, nullable
  - `trialPriceLabel` string, nullable
  - `salesMode` string
  - `currentTariff` MiniAppCurrentTariff: Текущий тариф пользователя.
    - `id` integer, required
    - `name` string, required
    - `description` string, nullable
    - `tier_level` integer
    - `traffic_limit_gb` integer, required
    - `traffic_limit_label` string, required
    - `is_unlimited_traffic` boolean
    - `device_limit` integer, required
    - `servers_count` integer, required
    - `monthly_price_kopeks` integer
    - `traffic_topup_enabled` boolean
    - `traffic_topup_packages` MiniAppTrafficTopupPackage[]
      - `gb` integer, required
      - `price_kopeks` integer, required
      - `price_label` string, required
      - `original_price_kopeks` integer, nullable
      - `original_price_label` string, nullable
      - `discount_percent` integer
    - `max_topup_traffic_gb` integer
    - `available_topup_gb` integer, nullable
    - `is_daily` boolean
    - `daily_price_kopeks` integer
    - `daily_price_label` string, nullable

## Other responses

- `422`: Validation Error

## Changes

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

[Operation history](https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api/changes/miniapp/subscription/post.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)