**版本：202607**

# 查询会员权益

**GET** `/openapi/2026-07/loyalty/members/:member_id/benefits`

查询指定会员当前等级可享有的权益列表

## 请求

**Path参数**

- `member_id` string (required)

  URL 路径中的会员 ID

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `member_id` string

    会员唯一 ID
  - `current_tier_name` string

    当前等级名称
  - `benefits` object[]

    权益列表

    *   Array \[

    - `benefit_id` string

      权益唯一 ID
    - `name` string

      权益名称
    - `description` string

      权益描述
    - `icon` string

      图标 URL
    - `benefit_type` string

      权益类型:point、coupon、discount\_code、free\_shipping 或 custom
    - `trigger_type` string

      触发方式:join\_tier、birthday 或 periodic
    - `execution_schedule` object

      发放规则(对应 vo.ExecutionScheduleRule),强类型映射

      - `type` string

        周期类型:time\_range / weekly / monthly / cycle
      - `effective_started_at` string

        开始时间,RFC3339,空表示无开始约束
      - `effective_ended_at` string

        结束时间,RFC3339,空表示长期有效
      - `months` string[]

        指定月份,type=monthly 时生效,数值字符串(1-12)
      - `days` string[]

        指定天:weekly 时 0-6 表示周日-周六;monthly 时 1-31 表示月内日期
      - `date` string

        指定日期(如 yyyy-MM-dd)
    - `reward_config` object[]

      奖励配置列表

      *   Array \[

      - `reward_type` string

        奖励类型:point / discount\_code / custom
      - `point_value` uint64

        reward\_type=point 时的积分数值;其它类型为 0
      - `discount_code_activity` object

        reward\_type=discount\_code 时的折扣码活动详情;其它类型为 null

        - `name` string

          活动名称
        - `discount_type` string

          折扣类型:percentage / fixed\_amount / free\_shipping / bxgy
        - `discount_value` string

          折扣值;percentage 为百分比数字字符串(如 "10"),fixed\_amount 为金额字符串(如 "10.00"),free\_shipping / bxgy 留空
        - `prerequisite_type` string

          前置条件类型:none / subtotal / quantity
        - `prerequisite_value` string

          前置条件值:subtotal 为金额字符串,quantity 为数量
        - `max_free_shipping` string

          免邮上限(免邮码用),-1 表示无上限。用 string 保留小数
        - `applicable_rule` object

          适用商品规则

          - `applicable_type` string

            适用类型:all / include\_products / include\_collections
          - `applicable_product_ids` string[]

            applicable\_type=include\_products 时的商品 ID 列表
          - `applicable_variant_ids` string[]

            applicable\_type=include\_products 时的 SKU/variant ID 列表
          - `applicable_collection_ids` string[]

            applicable\_type=include\_collections 时的合集 ID 列表
        - `obtain_products` object

          获取商品规则(BXGY 专用)

          - `applicable_rule` object

            可获取商品的适用规则

            - `applicable_type` string

              适用类型:all / include\_products / include\_collections
            - `applicable_product_ids` string[]

              applicable\_type=include\_products 时的商品 ID 列表
            - `applicable_variant_ids` string[]

              applicable\_type=include\_products 时的 SKU/variant ID 列表
            - `applicable_collection_ids` string[]

              applicable\_type=include\_collections 时的合集 ID 列表
          - `product_count` uint32

            获取商品数量
          - `obtain_type` string

            获取商品优惠类型:free / percentage / fixed\_amount
          - `obtain_value` string

            优惠值;decimal 字符串
        - `use_with_other` boolean

          是否允许跟其他折扣叠加
        - `limit_user_discount` int32

          每人活动使用次数上限,-1 表示无上限
        - `limit_code_user_discount` int32

          每人单码使用次数上限,-1 表示无上限
        - `limit_order_discount` int32

          每笔订单使用次数上限,-1 表示无上限
        - `limit_code_max_discount` int32

          单码最大使用次数,-1 表示无上限
        - `started_at` string

          活动开始时间;ISO 8601 UTC
        - `ended_at` string

          活动结束时间;ISO 8601 UTC,空串表示长期有效
      - `custom_reward` object

        reward\_type=custom 时的自定义奖励;其它类型为 null(结构占位)
      *   \]
    - `point_expire_config` object

      积分权益过期配置,仅 benefit\_type 为 point 时返回
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "member_id": "string",
    "current_tier_name": "string",
    "benefits": [
      {
        "benefit_id": "string",
        "name": "string",
        "description": "string",
        "icon": "string",
        "benefit_type": "string",
        "trigger_type": "string",
        "execution_schedule": {
          "type": "string",
          "effective_started_at": "string",
          "effective_ended_at": "string",
          "months": [
            "string"
          ],
          "days": [
            "string"
          ],
          "date": "string"
        },
        "reward_config": [
          {
            "reward_type": "string",
            "point_value": 0,
            "discount_code_activity": {
              "name": "string",
              "discount_type": "string",
              "discount_value": "string",
              "prerequisite_type": "string",
              "prerequisite_value": "string",
              "max_free_shipping": "string",
              "applicable_rule": {
                "applicable_type": "string",
                "applicable_product_ids": [
                  "string"
                ],
                "applicable_variant_ids": [
                  "string"
                ],
                "applicable_collection_ids": [
                  "string"
                ]
              },
              "obtain_products": {
                "applicable_rule": {
                  "applicable_type": "string",
                  "applicable_product_ids": [
                    "string"
                  ],
                  "applicable_variant_ids": [
                    "string"
                  ],
                  "applicable_collection_ids": [
                    "string"
                  ]
                },
                "product_count": 0,
                "obtain_type": "string",
                "obtain_value": "string"
              },
              "use_with_other": true,
              "limit_user_discount": 0,
              "limit_code_user_discount": 0,
              "limit_order_discount": 0,
              "limit_code_max_discount": 0,
              "started_at": "string",
              "ended_at": "string"
            },
            "custom_reward": {}
          }
        ],
        "point_expire_config": {}
      }
    ]
  }
}
```