**版本：202607**

# 查询赚积分活动

**GET** `/openapi/2026-07/loyalty/earn-campaigns`

查询会员可参与的赚取积分活动列表

## 请求

**Query参数**

- `status` string

  活动状态:active 或 inactive;不传返回全部
- `cursor` string

  翻页游标
- `limit` int32

  每页条数,默认 50,最大 200
- `member_id` string

  按会员 ID 筛选;不传返回全部活动

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `items` object[]

    活动列表

    *   Array \[

    - `campaign_id` string

      活动唯一 ID
    - `name` string

      活动名称
    - `event_type` string

      活动类型:become\_member、successful\_order、enter\_birthday、enter\_phone\_number 或 share\_link
    - `active` boolean

      活动是否开启
    - `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)
    - `member_condition` object

      适用会员范围;强类型,与 RedemptionCampaign 同口径

      - `type` string

        类型:scope 或 expression
      - `scope` object

        type 为 scope 时的范围参数
      - `expression` object

        type 为 expression 时的表达式参数
    - `reward_points` int64

      完成活动后获得的奖励积分数
    - `point_expire_config` object

      本活动发放积分的有效期配置;未配置时为 null

      - `is_expired` boolean

        积分是否过期
      - `expired_method` string

        过期方式:after\_x\_months / on\_specific\_date / ...
      - `day` int32

        过期规则的天
      - `month` int32

        过期规则的月
      - `protect_enabled` boolean

        是否开启过期保护
      - `protect_days` int32

        保护天数
      - `use_global_config` boolean

        是否使用店铺全局配置
    - `campaign_rule` object

      完整活动规则透传(对应 vo.CampaignRule);Struct 透传
    - `execution_priority` int32

      执行优先级:0=可叠加,>0=不可叠加。optional 保证零值也返回
    - `is_cumulative` boolean

      是否可叠加(execution\_priority==0)。optional 保证 false 也返回
    - `created_at` string

      创建时间,RFC3339 字符串
    *   \]
  - `next_cursor` string

    下一页游标
  - `has_more` boolean

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

    本次返回的每页条数

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "items": [
      {
        "campaign_id": "string",
        "name": "string",
        "event_type": "string",
        "active": true,
        "execution_schedule": {
          "type": "string",
          "effective_started_at": "string",
          "effective_ended_at": "string",
          "months": [
            "string"
          ],
          "days": [
            "string"
          ],
          "date": "string"
        },
        "member_condition": {
          "type": "string",
          "scope": {},
          "expression": {}
        },
        "reward_points": 0,
        "point_expire_config": {
          "is_expired": true,
          "expired_method": "string",
          "day": 0,
          "month": 0,
          "protect_enabled": true,
          "protect_days": 0,
          "use_global_config": true
        },
        "campaign_rule": {},
        "execution_priority": 0,
        "is_cumulative": true,
        "created_at": "string"
      }
    ],
    "next_cursor": "string",
    "has_more": true,
    "limit": 0
  }
}
```