---
title: "获取订阅计划列表及其他用户订阅信息"
method: GET
path: "/api/v1/subscription/plans"
tags: ["subscription", "android_app", "web_app"]
---

# 获取订阅计划列表及其他用户订阅信息

`GET /api/v1/subscription/plans`

现有订阅计划、用户订阅的内容、以及其他与用户订阅状态相关的信息

## Response `200`

Successful Response

- APIResponseSubscriptionPlansResponse
  - `code` integer
  - `message` string
  - `data` SubscriptionPlansResponse — 订阅计划列表响应
    - `plans` SubscriptionPlan[], required — 订阅计划列表
      - `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
    - `current_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
    - `has_ever_subscribed` boolean — 是否曾经有过订阅记录
    - `previous_plan_id` string, nullable — 最新的订阅计划ID

## Changes

- **2025-11-25** `05cf5f034c74` — 2 info
  - api tag `android_app` added
  - api tag `web_app` added

[Change history](https://skmtc.dev/nascentcore/apis/inty-backend/changes/api/v1/subscription/plans/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)