pointsHistory

query

An access token is required to call this API. Refer to Authorization for more information about how to obtain the token.

Query the details of a single customer’s points transactions, including increase and decrease value of points, change scenarios, internal remarks, and notes to customers.

Arguments

after ● String

Returns elements following the specified cursor. The first argument must also be specified when using this argument.

before ● String

Returns elements preceding the specified cursor. The last argument must also be specified when using this argument.

first ● Int

Returns the first n elements in the list.

last ● Int

Returns the last n elements in the list.

reverse ● Boolean

Whether to reverse the order of the list.

● true: reverse

● false: do not reverse

Default value: false

customerId ● String!non-null

Customer ID.

Return

edges ● [HistoryOfPointsEdge!]!non-null

A List of edges. Each edge contains a node and its corresponding cursor.

pageInfo ● PageInfo!non-null

Pagination information.

nodes ● [HistoryOfPoints]

A list of points transactions.

Status and error codes

For detailed information about common codes, see Status and error codes.

Example

Query the details of a single customer’s points transactions

Code

query {
  pointsHistory(customerId: "gid://shopline/Customer/4602226680",first:200) {
    edges{
      cursor
      node{
        notesCustomers
        remarksInternal
        updateScene
        updatedValue
        updatedAt
        expiredAt
        historyRecordId
        updateType
      }
    }
    pageInfo{
      hasNextPage
      hasPreviousPage
      endCursor
      startCursor
    }
    nodes{
        notesCustomers
        remarksInternal
        updateScene
        updatedValue
        updatedAt
        expiredAt
        historyRecordId
        updateType
    }
  }
}

Response

{
	"data": {
		"pointsHistory": {
			"edges": [
				{
					"cursor": "B9B0A75F6AACB745534E8E1B670D480CD799B9A69C03313E5F2466EB506C8D6D",
					"node": {
						"historyRecordId": "PFL6559235588338484853",
						"notesCustomers": null,
						"remarksInternal": null,
						"updateScene": "MANUALLY_INCREASE",
						"updateType": "INCREASE",
						"updatedAt": "2024-07-18T07:50:19.289Z",
						"updatedValue": "999",
						"expiredAt": "2099-12-31T15:59:59.000Z"
					}
				},
				{
					"cursor": "50419ECF8B9DCE233E49A0AEE0F7C4AAC0F8E95C62643BE295DCF4AEA3BE189E",
					"node": {
						"updateScene": "LOGIN_SUCCESS",
						"updateType": "INCREASE",
						"updatedAt": "2024-07-18T09:23:45.861Z",
						"updatedValue": "1",
						"expiredAt": "2025-07-18T15:59:59.000Z",
						"historyRecordId": "PFL6559329651030237239",
						"notesCustomers": null,
						"remarksInternal": null
					}
				},
				{
					"cursor": "CDB95FC1FEE44934D741A171B833137EB2CBAB7AA311C34B84C8171EEFF38975",
					"node": {
						"remarksInternal": null,
						"updateScene": "LOGIN_SUCCESS",
						"updateType": "INCREASE",
						"updatedAt": "2024-07-23T02:41:53.246Z",
						"updatedValue": "1",
						"expiredAt": "2025-07-23T15:59:59.000Z",
						"historyRecordId": "PFL6566172865792069221",
						"notesCustomers": null
					}
				},
				{
					"node": {
						"updateScene": "LOGIN_SUCCESS",
						"updateType": "INCREASE",
						"updatedAt": "2024-07-24T08:33:03.214Z",
						"updatedValue": "1",
						"expiredAt": "2025-07-24T15:59:59.000Z",
						"historyRecordId": "PFL6567975912658708032",
						"notesCustomers": null,
						"remarksInternal": null
					},
					"cursor": "ABEEFA5149AC16426C0E85B006A0A19CF0CA2A8C69992561DE5A1F11625C35F5"
				},
				{
					"cursor": "13E5DFC4E44278741403BBCA3CB8A1476C65A864B92EEC725D5D0E40E1F84201",
					"node": {
						"remarksInternal": "Adjustment based on original points",
						"updateScene": "MANUALLY_INCREASE",
						"updateType": "INCREASE",
						"updatedAt": "2024-07-24T08:53:27.041Z",
						"updatedValue": "1102",
						"expiredAt": "2024-12-06T15:59:59.000Z",
						"historyRecordId": "PFL6567996445068633703",
						"notesCustomers": "Increase by 100 points"
					}
				},
				{
					"cursor": "026AF78ED91D8F70F1DDE734606A4C87EB236A09BCC5693907F95830FD3CAD77",
					"node": {
						"updateScene": "LOGIN_SUCCESS",
						"updateType": "INCREASE",
						"updatedAt": "2024-07-26T01:43:14.185Z",
						"updatedValue": "1",
						"expiredAt": "2025-07-26T15:59:59.000Z",
						"historyRecordId": "PFL6570462480065634306",
						"notesCustomers": null,
						"remarksInternal": null
					}
				},
				{
					"cursor": "C784A8E275D7FC74C923BC1958C104B158C1B774A999A0671F32EA1DEB0610CF",
					"node": {
						"updateScene": "LOGIN_SUCCESS",
						"updateType": "INCREASE",
						"updatedAt": "2024-09-20T02:28:56.636Z",
						"updatedValue": "1",
						"expiredAt": "2025-09-20T15:59:59.000Z",
						"historyRecordId": "PFL6651683372719940666",
						"notesCustomers": null,
						"remarksInternal": null
					}
				},
				{
					"cursor": "AED80BE69B778D9EA8F39306CFDDBC98EEB9CFC2C602F582E2F0DB45691C2730",
					"node": {
						"notesCustomers": "Increase by 100 points",
						"remarksInternal": "Adjustment based on original points",
						"updateScene": "MANUALLY_INCREASE",
						"updateType": "INCREASE",
						"updatedAt": "2024-10-11T08:45:44.920Z",
						"updatedValue": "100",
						"expiredAt": "2024-12-06T15:59:59.000Z",
						"historyRecordId": "PFL6682503257494408246"
					}
				},
				{
					"cursor": "FF6C1CF75CDD05F2424FC2D8DD80CBDBDCAD0E22C26D4E488E9B6C9504FA2A3B",
					"node": {
						"updateType": "INCREASE",
						"updatedAt": "2025-01-17T17:03:45.053Z",
						"updatedValue": "1",
						"expiredAt": "2026-01-18T15:59:59.000Z",
						"historyRecordId": "PFL6825060606255046937",
						"notesCustomers": null,
						"remarksInternal": null,
						"updateScene": "LOGIN_SUCCESS"
					}
				},
				{
					"cursor": "E1213DF68A1F623D9DE269DCC4A5A3C7B96EA939E96A390BA3783BB379832A71",
					"node": {
						"notesCustomers": null,
						"remarksInternal": null,
						"updateScene": "POINTS_EXPIRED",
						"updateType": "DECREASE",
						"updatedAt": "2025-01-17T17:03:45.357Z",
						"updatedValue": "1202",
						"expiredAt": null,
						"historyRecordId": "PFL6825060611355320604"
					}
				},
				{
					"cursor": "362CBEE0C44AE4AC95470CA52CA93EBBF80F3EADABB0BA40B1CF189A19ED138A",
					"node": {
						"notesCustomers": null,
						"remarksInternal": null,
						"updateScene": "LOGIN_SUCCESS",
						"updateType": "INCREASE",
						"updatedAt": "2025-01-23T17:04:57.759Z",
						"updatedValue": "1",
						"expiredAt": "2026-01-24T15:59:59.000Z",
						"historyRecordId": "PFL6833759134833715055"
					}
				},
				{
					"cursor": "6F99A44220C90A49CE18F59585DEB05A34A5879856B88F1CB021D4AD8166548D",
					"node": {
						"updateScene": "POINTS_EXPIRED",
						"updateType": "DECREASE",
						"updatedAt": "2025-07-19T21:00:08.016Z",
						"updatedValue": "1",
						"expiredAt": null,
						"historyRecordId": "PFL7090566524806112654",
						"notesCustomers": null,
						"remarksInternal": null
					}
				},
				{
					"node": {
						"historyRecordId": "PFL7096364853515263652",
						"notesCustomers": null,
						"remarksInternal": null,
						"updateScene": "POINTS_EXPIRED",
						"updateType": "DECREASE",
						"updatedAt": "2025-07-23T21:00:15.337Z",
						"updatedValue": "1",
						"expiredAt": null
					},
					"cursor": "864EC53373B6B62068A46E2CFAB82C02C23F395640AE718BC6C3055268978C70"
				},
				{
					"cursor": "09F46E6FEA2B1B39A44E11330FD92032A2F13E2E4F459ABED1F8C1DF35F971A4",
					"node": {
						"remarksInternal": null,
						"updateScene": "POINTS_EXPIRED",
						"updateType": "DECREASE",
						"updatedAt": "2025-07-25T21:00:12.765Z",
						"updatedValue": "1",
						"expiredAt": null,
						"historyRecordId": "PFL7099263913272288848",
						"notesCustomers": null
					}
				},
				{
					"cursor": "8A9FDE83A452D103DAA318EA0C2CF0425811CC98D79A10AF8C7118B99D3F6E21",
					"node": {
						"updatedAt": "2025-07-26T21:00:04.049Z",
						"updatedValue": "1",
						"expiredAt": null,
						"historyRecordId": "PFL7100713318504474574",
						"notesCustomers": null,
						"remarksInternal": null,
						"updateScene": "POINTS_EXPIRED",
						"updateType": "DECREASE"
					}
				},
				{
					"cursor": "5F8301D656EB5A5276C9E8E5A7DA06DB99BF5237488F7805EE272CAD505D9C22",
					"node": {
						"updatedValue": "100",
						"expiredAt": "2099-12-31T15:59:59.000Z",
						"historyRecordId": "PFL7180086253933044745",
						"notesCustomers": "Increase by 100 points",
						"remarksInternal": "Adjustment based on original points",
						"updateScene": "MANUALLY_INCREASE",
						"updateType": "INCREASE",
						"updatedAt": "2025-09-19T15:09:59.670Z"
					}
				},
				{
					"cursor": "9074853FD45E902F02B9D17712FCBAF1CC7526CA293C137D36E434A22025357F",
					"node": {
						"historyRecordId": "PFL7180087448303051787",
						"notesCustomers": "Expected to deduct to 0",
						"remarksInternal": "test node",
						"updateScene": "MANUALLY_DECREASE",
						"updateType": "DECREASE",
						"updatedAt": "2025-09-19T15:11:10.860Z",
						"updatedValue": "1102",
						"expiredAt": null
					}
				},
				{
					"cursor": "B9048DD4FB68BE1FA2FECD3A419D2AE670F177044D6C210484A719A9F0B81EDC",
					"node": {
						"remarksInternal": "Adjustment based on original points",
						"updateScene": "MANUALLY_INCREASE",
						"updateType": "INCREASE",
						"updatedAt": "2025-09-19T15:11:40.106Z",
						"updatedValue": "100",
						"expiredAt": "2099-12-31T15:59:59.000Z",
						"historyRecordId": "PFL7180087938952733709",
						"notesCustomers": "Increase by 100 points"
					}
				},
				{
					"cursor": "E2B212507877194751047C1E7A4056D706C11A8F8396453964E992BD09CC4E11",
					"node": {
						"updateType": "DECREASE",
						"updatedAt": "2025-09-26T14:23:02.101Z",
						"updatedValue": "0",
						"expiredAt": null,
						"historyRecordId": "PFL7190185843206136856",
						"notesCustomers": null,
						"remarksInternal": null,
						"updateScene": "POINTS_EXPIRED"
					}
				},
				{
					"cursor": "C20C1F46C3CD81EF06642ABB04D838E44F6CB9040D08481EE9E6290C0A618FE7",
					"node": {
						"updatedValue": "100",
						"expiredAt": "2099-12-31T15:59:59.000Z",
						"historyRecordId": "PFL7190185972726244359",
						"notesCustomers": "Increase by 100 points",
						"remarksInternal": "Adjustment based on original points",
						"updateScene": "MANUALLY_INCREASE",
						"updateType": "INCREASE",
						"updatedAt": "2025-09-26T14:23:09.821Z"
					}
				}
			],
			"nodes": [
				{
					"updateScene": "MANUALLY_INCREASE",
					"updateType": "INCREASE",
					"updatedAt": "2024-07-18T07:50:19.289Z",
					"updatedValue": "999",
					"expiredAt": "2099-12-31T15:59:59.000Z",
					"historyRecordId": "PFL6559235588338484853",
					"notesCustomers": null,
					"remarksInternal": null
				},
				{
					"remarksInternal": null,
					"updateScene": "LOGIN_SUCCESS",
					"updateType": "INCREASE",
					"updatedAt": "2024-07-18T09:23:45.861Z",
					"updatedValue": "1",
					"expiredAt": "2025-07-18T15:59:59.000Z",
					"historyRecordId": "PFL6559329651030237239",
					"notesCustomers": null
				},
				{
					"updateType": "INCREASE",
					"updatedAt": "2024-07-23T02:41:53.246Z",
					"updatedValue": "1",
					"expiredAt": "2025-07-23T15:59:59.000Z",
					"historyRecordId": "PFL6566172865792069221",
					"notesCustomers": null,
					"remarksInternal": null,
					"updateScene": "LOGIN_SUCCESS"
				},
				{
					"notesCustomers": null,
					"remarksInternal": null,
					"updateScene": "LOGIN_SUCCESS",
					"updateType": "INCREASE",
					"updatedAt": "2024-07-24T08:33:03.214Z",
					"updatedValue": "1",
					"expiredAt": "2025-07-24T15:59:59.000Z",
					"historyRecordId": "PFL6567975912658708032"
				},
				{
					"notesCustomers": "Increase by 100 points",
					"remarksInternal": "Adjustment based on original points",
					"updateScene": "MANUALLY_INCREASE",
					"updateType": "INCREASE",
					"updatedAt": "2024-07-24T08:53:27.041Z",
					"updatedValue": "1102",
					"expiredAt": "2024-12-06T15:59:59.000Z",
					"historyRecordId": "PFL6567996445068633703"
				},
				{
					"notesCustomers": null,
					"remarksInternal": null,
					"updateScene": "LOGIN_SUCCESS",
					"updateType": "INCREASE",
					"updatedAt": "2024-07-26T01:43:14.185Z",
					"updatedValue": "1",
					"expiredAt": "2025-07-26T15:59:59.000Z",
					"historyRecordId": "PFL6570462480065634306"
				},
				{
					"updatedValue": "1",
					"expiredAt": "2025-09-20T15:59:59.000Z",
					"historyRecordId": "PFL6651683372719940666",
					"notesCustomers": null,
					"remarksInternal": null,
					"updateScene": "LOGIN_SUCCESS",
					"updateType": "INCREASE",
					"updatedAt": "2024-09-20T02:28:56.636Z"
				},
				{
					"notesCustomers": "Increase by 100 points",
					"remarksInternal": "Adjustment based on original points",
					"updateScene": "MANUALLY_INCREASE",
					"updateType": "INCREASE",
					"updatedAt": "2024-10-11T08:45:44.920Z",
					"updatedValue": "100",
					"expiredAt": "2024-12-06T15:59:59.000Z",
					"historyRecordId": "PFL6682503257494408246"
				},
				{
					"remarksInternal": null,
					"updateScene": "LOGIN_SUCCESS",
					"updateType": "INCREASE",
					"updatedAt": "2025-01-17T17:03:45.053Z",
					"updatedValue": "1",
					"expiredAt": "2026-01-18T15:59:59.000Z",
					"historyRecordId": "PFL6825060606255046937",
					"notesCustomers": null
				},
				{
					"updatedAt": "2025-01-17T17:03:45.357Z",
					"updatedValue": "1202",
					"expiredAt": null,
					"historyRecordId": "PFL6825060611355320604",
					"notesCustomers": null,
					"remarksInternal": null,
					"updateScene": "POINTS_EXPIRED",
					"updateType": "DECREASE"
				},
				{
					"updatedAt": "2025-01-23T17:04:57.759Z",
					"updatedValue": "1",
					"expiredAt": "2026-01-24T15:59:59.000Z",
					"historyRecordId": "PFL6833759134833715055",
					"notesCustomers": null,
					"remarksInternal": null,
					"updateScene": "LOGIN_SUCCESS",
					"updateType": "INCREASE"
				},
				{
					"remarksInternal": null,
					"updateScene": "POINTS_EXPIRED",
					"updateType": "DECREASE",
					"updatedAt": "2025-07-19T21:00:08.016Z",
					"updatedValue": "1",
					"expiredAt": null,
					"historyRecordId": "PFL7090566524806112654",
					"notesCustomers": null
				},
				{
					"notesCustomers": null,
					"remarksInternal": null,
					"updateScene": "POINTS_EXPIRED",
					"updateType": "DECREASE",
					"updatedAt": "2025-07-23T21:00:15.337Z",
					"updatedValue": "1",
					"expiredAt": null,
					"historyRecordId": "PFL7096364853515263652"
				},
				{
					"notesCustomers": null,
					"remarksInternal": null,
					"updateScene": "POINTS_EXPIRED",
					"updateType": "DECREASE",
					"updatedAt": "2025-07-25T21:00:12.765Z",
					"updatedValue": "1",
					"expiredAt": null,
					"historyRecordId": "PFL7099263913272288848"
				},
				{
					"notesCustomers": null,
					"remarksInternal": null,
					"updateScene": "POINTS_EXPIRED",
					"updateType": "DECREASE",
					"updatedAt": "2025-07-26T21:00:04.049Z",
					"updatedValue": "1",
					"expiredAt": null,
					"historyRecordId": "PFL7100713318504474574"
				},
				{
					"updatedValue": "100",
					"expiredAt": "2099-12-31T15:59:59.000Z",
					"historyRecordId": "PFL7180086253933044745",
					"notesCustomers": "Increase by 100 points",
					"remarksInternal": "Adjustment based on original points",
					"updateScene": "MANUALLY_INCREASE",
					"updateType": "INCREASE",
					"updatedAt": "2025-09-19T15:09:59.670Z"
				},
				{
					"historyRecordId": "PFL7180087448303051787",
					"notesCustomers": "Expected to deduct to 0",
					"remarksInternal": "test node",
					"updateScene": "MANUALLY_DECREASE",
					"updateType": "DECREASE",
					"updatedAt": "2025-09-19T15:11:10.860Z",
					"updatedValue": "1102",
					"expiredAt": null
				},
				{
					"historyRecordId": "PFL7180087938952733709",
					"notesCustomers": "Increase by 100 points",
					"remarksInternal": "Adjustment based on original points",
					"updateScene": "MANUALLY_INCREASE",
					"updateType": "INCREASE",
					"updatedAt": "2025-09-19T15:11:40.106Z",
					"updatedValue": "100",
					"expiredAt": "2099-12-31T15:59:59.000Z"
				},
				{
					"notesCustomers": null,
					"remarksInternal": null,
					"updateScene": "POINTS_EXPIRED",
					"updateType": "DECREASE",
					"updatedAt": "2025-09-26T14:23:02.101Z",
					"updatedValue": "0",
					"expiredAt": null,
					"historyRecordId": "PFL7190185843206136856"
				},
				{
					"historyRecordId": "PFL7190185972726244359",
					"notesCustomers": "Increase by 100 points",
					"remarksInternal": "Adjustment based on original points",
					"updateScene": "MANUALLY_INCREASE",
					"updateType": "INCREASE",
					"updatedAt": "2025-09-26T14:23:09.821Z",
					"updatedValue": "100",
					"expiredAt": "2099-12-31T15:59:59.000Z"
				}
			],
			"pageInfo": {
				"hasNextPage": true,
				"hasPreviousPage": false,
				"startCursor": "B9B0A75F6AACB745534E8E1B670D480CD799B9A69C03313E5F2466EB506C8D6D",
				"endCursor": "C20C1F46C3CD81EF06642ABB04D838E44F6CB9040D08481EE9E6290C0A618FE7"
			}
		}
	}
}

Was this article helpful to you?

SHOPLINE

Legal