**版本：202601**

# 查询会员折扣码

**GET** `/openapi/2026-01/loyalty/members/:member_id/discount-codes`

查询指定会员已获得的折扣码列表

## 请求

**Path参数**

- `member_id` string (required)

  URL 路径中的会员 ID

**Query参数**

- `cursor` string

  翻页游标
- `limit` int32

  每页条数,默认 50,最大 200

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `items` object[]

    折扣码资产列表

    *   Array \[

    - `discount_code` string

      折扣码字符串
    - `used_times` int64

      已使用次数。optional 保证零值也返回
    - `available_times` int64

      剩余可用次数
    - `source_type` string

      发放来源类型:points\_redeem、birthday\_reward、benefit\_package 或 member\_active\_reward
    - `source_id` string

      来源 ID;source\_type 为 points\_redeem 时为活动 ID
    - `discount_code_activity` object

      折扣码活动信息

      - `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,空串表示长期有效
    *   \]
  - `next_cursor` string

    下一页游标
  - `has_more` boolean

    是否还有下一页
  - `limit` int32

    本次返回的每页条数

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "items": [
      {
        "discount_code": "string",
        "used_times": 0,
        "available_times": 0,
        "source_type": "string",
        "source_id": "string",
        "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"
        }
      }
    ],
    "next_cursor": "string",
    "has_more": true,
    "limit": 0
  }
}
```