**版本：202601**

# 查询会员分群详情

**GET** `/openapi/2026-01/loyalty/member-groups/:member_group_id`

查询指定会员分群的详细信息

## 请求

**Path参数**

- `member_group_id` string (required)

  URL 路径中的分群 ID

**Query参数**

- `cursor` string

  会员名单分页游标
- `limit` int32

  会员名单每页条数

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  会员分群详情响应

  - `member_group_id` string
  - `name` string
  - `is_real_time` boolean
  - `member_count` int64
  - `created_at` string
  - `updated_at` string
  - `member_condition` object

    会员筛选条件表达式(递归树)

    - `key` string
    - `operator` string
    - `value` GoogleProtobufValue

      Represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values.
    - `extra` object

      会员条件附加配置(时间窗口、分类、商品、地区)

      - `time_range` string

        时间窗口:all / 7d / 30d
      - `categories` object[]

        指定分类,二维数组 \[\["a","a-1"\],\["b"\]\]

        *   Array \[

        - `values` GoogleProtobufValue[]
        *   \]
      - `product_ids` string[]

        指定商品 id 列表
      - `country_and_province` object

        国家+地区:key=国家码,value=地区码列表(\["ALL"\] 表示整国)

        - `property name*` ListValue

          - `values` GoogleProtobufValue[]
    - `relation` string
    - `children` undefined[]
  - `members` object

    会员分群详情里的会员名单分页块

    - `items` object[]

      *   Array \[

      - `member_id` string

        会员唯一 ID
      - `email` string

        会员邮箱
      - `phone` string

        会员手机号
      - `first_name` string

        会员名
      - `last_name` string

        会员姓
      - `current_tier_name` string

        当前等级名称
      - `created_at` string

        注册时间,ISO-8601
      - `transactions_amount` string

        累计消费金额,decimal 字符串
      - `birthday` string

        会员生日,未设置时为空字符串
      - `status` string

        会员状态:active / inactive / ...
      - `tags` string[]

        会员标签
      - `activated_at` string

        会员激活时间,ISO-8601;未激活时为空
      - `first_order_at` string

        首单时间,ISO-8601;无单时为空
      *   \]
    - `next_cursor` string
    - `has_more` boolean
    - `limit` int32

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "member_group_id": "string",
    "name": "string",
    "is_real_time": true,
    "member_count": 0,
    "created_at": "string",
    "updated_at": "string",
    "member_condition": {
      "key": "string",
      "operator": "string",
      "extra": {
        "time_range": "string",
        "categories": [
          {
            "values": [
              null
            ]
          }
        ],
        "product_ids": [
          "string"
        ],
        "country_and_province": {}
      },
      "relation": "string",
      "children": [
        null
      ]
    },
    "members": {
      "items": [
        {
          "member_id": "string",
          "email": "string",
          "phone": "string",
          "first_name": "string",
          "last_name": "string",
          "current_tier_name": "string",
          "created_at": "string",
          "transactions_amount": "string",
          "birthday": "string",
          "status": "string",
          "tags": [
            "string"
          ],
          "activated_at": "string",
          "first_order_at": "string"
        }
      ],
      "next_cursor": "string",
      "has_more": true,
      "limit": 0
    }
  }
}
```