---
title: "Get Subscription Status"
method: GET
path: "/api/v1/subscription/status"
tags: ["subscription", "web_app", "NOT_USED"]
---

# Get Subscription Status

`GET /api/v1/subscription/status`

获取用户订阅状态

## Response `200`

Successful Response

- APIResponseSubscriptionStatusResponse
  - `code` integer
  - `message` string
  - `data` SubscriptionStatusResponse — 订阅状态响应
    - `is_subscribed` boolean, required — 是否订阅
    - `subscription_status` string, required — 订阅详细状态：subscribed/subscribed_expiring/unsubscribed
    - `has_ever_subscribed` boolean — 是否曾经有过订阅记录
    - `subscription` UserSubscription — 用户订阅响应模型
      - `plan_id` string, required — 订阅计划ID
      - `google_play_purchase_token` string, nullable — Google Play购买令牌
      - `google_play_order_id` string, nullable — Google Play订单ID
      - `google_play_subscription_id` string, nullable — Google Play订阅ID
      - `status` 'ACTIVE' | 'EXPIRED' | 'CANCELLED' | 'PENDING' | 'REFUNDED' | 'GRACE_PERIOD' | 'PAUSED' — 订阅状态
      - `start_date` string, date-time, nullable — 开始时间
      - `end_date` string, date-time, nullable — 结束时间
      - `trial_end_date` string, date-time, nullable — 试用结束时间
      - `auto_renew` boolean — 是否自动续费
      - `extra_data` object, nullable — 额外元数据
      - `id` string, required
      - `user_id` string, required
      - `plan` SubscriptionPlan — 订阅计划响应模型
        - `name` string, required — 计划名称
        - `description` string, nullable — 计划描述
        - `plan_type` 'MONTHLY' | 'QUARTERLY' | 'YEARLY', required — 订阅计划类型
        - `price` number, required — 价格
        - `currency` string — 货币
        - `google_play_product_id` string, required — Google Play产品ID
        - `discount_rate` number — 价格折扣率，范围0-1，1表示无折扣
        - `features` object, nullable — 功能权益配置
        - `chat_limit_per_day` integer — 每日聊天次数限制，-1为无限制
        - `agent_creation_limit` integer — Agent创建数量限制
        - `background_generation_limit_per_day` integer — 每日背景图生成次数限制，-1为无限制
        - `is_active` boolean — 是否激活
        - `sort_order` integer — 排序顺序
        - `id` string, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, nullable
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, nullable
    - `plan` SubscriptionPlan — 订阅计划响应模型
      - `name` string, required — 计划名称
      - `description` string, nullable — 计划描述
      - `plan_type` 'MONTHLY' | 'QUARTERLY' | 'YEARLY', required — 订阅计划类型
      - `price` number, required — 价格
      - `currency` string — 货币
      - `google_play_product_id` string, required — Google Play产品ID
      - `discount_rate` number — 价格折扣率，范围0-1，1表示无折扣
      - `features` object, nullable — 功能权益配置
      - `chat_limit_per_day` integer — 每日聊天次数限制，-1为无限制
      - `agent_creation_limit` integer — Agent创建数量限制
      - `background_generation_limit_per_day` integer — 每日背景图生成次数限制，-1为无限制
      - `is_active` boolean — 是否激活
      - `sort_order` integer — 排序顺序
      - `id` string, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, nullable
    - `remaining_days` integer, nullable — 剩余天数
    - `will_auto_renew` boolean — 是否会自动续费
    - `chat_limit_per_day` integer — 每日聊天次数限制
    - `total_chat_limit` integer, nullable — 总聊天次数限制（免费用户）
    - `chat_24h_limit` integer, nullable — 24小时内聊天次数限制（免费用户）
    - `guest_chat_24h_limit` integer, nullable — 24小时内聊天次数限制（游客用户）
    - `voice_24h_limit` integer, nullable — 24小时内语音生成次数限制
    - `guest_voice_24h_limit` integer, nullable — 24小时内语音生成次数限制（游客用户）
    - `image_gen_24h_limit` integer, nullable — 24小时内图片生成次数限制
    - `agent_creation_24h_limit` integer, nullable — 24小时内Agent创建数量限制
    - `agent_creation_limit` integer — Agent创建数量限制（已废弃，使用agent_creation_24h_limit）
    - `background_generation_limit_per_day` integer — 每日背景图生成次数限制（已废弃，使用image_gen_24h_limit）
    - `features` object — 功能权益
    - `feature_list` FeatureInfo[] — 权益功能列表
      - `key` string, required — 权益key
      - `name` string, required — 权益名称
      - `description` string, required — 权益描述
      - `type` string, required — 权益类型：real/fake
      - `icon` string, required — 权益图标
      - `order` integer, required — 排序顺序
      - `enabled` boolean — 是否启用

## Changes

- **2025-11-30** `64a35ff6429d` — 1 info
  - api tag `NOT_USED` added
- **2025-11-25** `05cf5f034c74` — 1 info
  - api tag `web_app` added
- **2025-10-21** `0ee1ca2e37cb` — 2 info
  - added the optional property `data/anyOf[subschema #1: SubscriptionStatusResponse]/agent_creation_24h_limit` to the response with the `200` status
  - added the optional property `data/anyOf[subschema #1: SubscriptionStatusResponse]/image_gen_24h_limit` to the response with the `200` status
- **2025-10-14** `89127d31b5fa` — 3 info
  - added the optional property `data/anyOf[subschema #1: SubscriptionStatusResponse]/guest_chat_24h_limit` to the response with the `200` status
  - added the optional property `data/anyOf[subschema #1: SubscriptionStatusResponse]/guest_voice_24h_limit` to the response with the `200` status
  - added the optional property `data/anyOf[subschema #1: SubscriptionStatusResponse]/voice_24h_limit` to the response with the `200` status

[Change history](https://skmtc.dev/nascentcore/apis/inty-backend/changes/api/v1/subscription/status/get.md)

---

[API](https://skmtc.dev/nascentcore/apis/inty-backend.md) · [All operations](https://skmtc.dev/nascentcore/apis/inty-backend/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nascentcore/inty-backend/revisions/1e014c365df2/schema)