**版本：202607**

# 查询积分余额

**POST** `/openapi/2026-07/loyalty/members/points`

查询指定会员的积分余额

## 请求

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `search_type` string (required)

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

  单个会员定位值

```json
{
  "search_type": "string",
  "search_value": "string"
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `member_id` string

    会员唯一 ID
  - `points_balance` int64

    积分总余额 = active\_points + frozen\_points
  - `active_points` int64

    可用积分,扣减场景下允许为负
  - `frozen_points` int64

    冻结积分
  - `expiring_points` int64

    近 30 天即将过期积分
  - `earned_points` int64

    历史累计获得积分
  - `spent_points` int64

    历史累计消耗积分
  - `expired_points` int64

    历史累计过期积分

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "member_id": "string",
    "points_balance": 0,
    "active_points": 0,
    "frozen_points": 0,
    "expiring_points": 0,
    "earned_points": 0,
    "spent_points": 0,
    "expired_points": 0
  }
}
```