---
title: "HistoryOfPoints"
description: "The details of a customer's points transaction."
doc_type: graphql
doc_category: storefront
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/docs/storefront-api/member-system/objects/history-of-points'
  md: 'https://developer.shopline.com/docs/storefront-api/member-system/objects/history-of-points.md'
---
# HistoryOfPoints

The details of a customer's points transaction.

- **API Version:** v20270301
- **API Type:** Storefront
- **API Protocol:** GraphQL
- **Operation Type:** Object

## Fields

* `notesCustomers`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  Notes for customers. Customers can view these notes on the member dashboard and in the member's points history.<br/>Maximum length: 128

* `remarksInternal`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  Internal remarks. Visible only to internal staff.<br/>Maximum length: 128

* `updateScene`

  [PointsUpdateScene](https://developer.shopline.com/docs/storefront-api/member-system/enums/points-update-scene.md)

  Points change scenario. 

* `historyRecordId`

  [String](https://developer.shopline.com/docs/storefront-api/common/scalars/string.md)

  Points transaction ID.

* `updatedValue`

  [UnsignedInt64](https://developer.shopline.com/docs/storefront-api/common/scalars/unsigned-int-64.md)

  The amount of points changed.

* `updatedAt`

  [Date](https://developer.shopline.com/docs/storefront-api/common/scalars/date.md)

  The update time of this transaction record. Format: <a href="https://www.iso.org/iso-8601-date-and-time-format.html">ISO 8601</a>.

* `updateType`

  [PointsUpdateType](https://developer.shopline.com/docs/storefront-api/member-system/enums/points-update-type.md)

  Points change type. 

* `expiredAt`

  [Date](https://developer.shopline.com/docs/storefront-api/common/scalars/date.md)

  The expiration time of the points changed in this transaction. It has a value only when `updateType` is `INCREASE`. Format: <a href="https://www.iso.org/iso-8601-date-and-time-format.html">ISO 8601</a>.

## Field from

* [HistoryOfPointsEdge](https://developer.shopline.com/docs/storefront-api/member-system/objects/history-of-points-edge.md).node

* [HistoryOfPointsConnection](https://developer.shopline.com/docs/storefront-api/member-system/objects/history-of-points-connection.md).nodes