---
title: "Get Customer member points History"
method: GET
path: "/customers/{id}/member_points"
tags: ["Customers"]
---

# Get Customer member points History

`GET /customers/{id}/member_points`

To get member points history of a customer<br>獲取顧客的會員點數紀錄

## Path parameters

- `id` string, required

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

OK

- MemberPoints
  - `items` MemberPoint[]
    - `customer_id` string — Customer ID
    - `point_balance` integer — Member Point<br>現有點數
    - `remarks` string — Point Change Reason<br>點數更動原因
    - `value` integer — Point<br>點數
    - `order_id` string — Order ID
    - `order_number` string — Order Number
    - `type` 'manual' | 'auto_reward' | 'expired' | 'order_redeemed' | 'redeemed_to_cash' | 'order_split_revert' | 'product_review_reward' | 'member_info_reward' | 'return_order_revert' | 'order_edit_revert' — Member point type<br>點數種類 <br>----<br> manual: 手動增減點數（店家手動發送、取消訂單/退貨訂單回補）<br> auto_reward: 點數回饋<br> expired: 點數過期<br> order_redeemed: 使用點數兌換贈品於訂單<br> redeemed_to_cash: 使用點數折現於訂單<br> order_split_revert: 回補點數（來自拆單）<br> product_review_reward: 商品評價獎賞<br> member_info_reward: 會員資料獎賞<br> return_order_revert: 退貨單回補會員點數<br> order_edit_revert: 訂單編輯回補會員點數
    - `is_redeem` boolean — Redeemed?<br>已兌換?
    - `end_at` string — Expiry date, a null value means never expired<br>到期日期, null 表示不會到期
    - `created_at` string — Created Time<br>點數創建時間
  - `pagination` Paginatable
    - `current_page` integer — The current page number<br>當前分頁
    - `per_page` integer — Number of result per page<br>每頁顯示 n 筆資料<br>(Default: 24)
    - `total_count` integer — Number of result in total<br>資料總量
    - `total_pages` integer — Number of pages in total<br>總頁數量

## Other responses

- `401` — Bad authentication
- `403` — Forbidden
- `404` — Product not found error
- `422` — Unprocessable entity error
- `500` — Server error

---

[API](https://skmtc.net/shoplineapp/apis/shopline-open-api.md) · [All operations](https://skmtc.net/shoplineapp/apis/shopline-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shoplineapp/shopline-open-api/revisions/1675ac12cde7/schema)