**Version: 202607**

# Get points balance

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

Return the points balance for a specific member

## Request

**application/json**

**Body | Example**

**Body (required)**

- `search_type` string (required)

  Member locator type: member\_id or email
- `search_value` string (required)

  Single member locator value

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

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `member_id` string

    Member ID
  - `points_balance` int64

    Total balance = active\_points + frozen\_points
  - `active_points` int64

    Active points. May be negative after deduction
  - `frozen_points` int64

    Frozen points
  - `expiring_points` int64

    Points expiring in the next 30 days
  - `earned_points` int64

    Cumulative earned points
  - `spent_points` int64

    Cumulative spent points
  - `expired_points` int64

    Cumulative expired points

```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
  }
}
```