**版本：202601**

# 会员列表

**POST** `/openapi/2026-01/loyalty/members`

根据会员 ID 或邮箱查询会员信息，单次最多 200 个

## 请求

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `search_type` string (required)

  会员定位方式:member\_id 或 email
- `search_values` string[] (required)

  待查询的会员定位值列表,单次最多 200 个

```json
{
  "search_type": "string",
  "search_values": [
    "string"
  ]
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `members` 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;无单时为空
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "members": [
      {
        "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"
      }
    ]
  }
}
```