**版本：202601**

# 查询会员等级

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

查询指定会员的当前等级及升级进度

## 请求

**Path参数**

- `member_id` string (required)

  URL 路径中的会员 ID

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `member_id` string

    会员唯一 ID
  - `current_tier_name` string

    当前等级名称
  - `accumulated_amount` string

    累计消费金额,decimal 字符串
  - `tier_requirements` object[]

    等级升级要求列表,按等级顺序返回

    *   Array \[

    - `tier_name` string

      等级名称
    - `threshold_amount` string

      升级到该等级所需累计消费金额,decimal 字符串
    *   \]
  - `next_tier` object

    下一级信息;已达最高等级或店铺仅一个等级时为空

    - `tier_name` string

      等级名称
    - `threshold_amount` string

      升级到该等级所需累计消费金额,decimal 字符串

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "member_id": "string",
    "current_tier_name": "string",
    "accumulated_amount": "string",
    "tier_requirements": [
      {
        "tier_name": "string",
        "threshold_amount": "string"
      }
    ],
    "next_tier": {
      "tier_name": "string",
      "threshold_amount": "string"
    }
  }
}
```