---
title: "Get customer point transaction history"
method: GET
path: "/loyalty/cp/api/transaction-by-shop"
tags: ["Points & Earn Rules"]
---

# Get customer point transaction history

`GET /loyalty/cp/api/transaction-by-shop`

## Request

- Base URL: `https://your-store.myshopify.com/apps`
- URL: `https://your-store.myshopify.com/apps/loyalty/cp/api/transaction-by-shop`
- Auth: none declared

Retrieves paginated list of point transactions for the authenticated customer, ordered by ID descending (most recent first). Each transaction includes details about points earned or spent, transaction type, status (PENDING, APPROVED, REJECTED), associated order information, and timestamps. Useful for displaying transaction history to customers.

## Query parameters

- `pageable` Pageable, required
  - `page` integer
  - `size` integer
  - `sort` string[]

## Response `200`

Point transactions retrieved successfully with pagination headers (X-Total-Count, Link)

- PointTransaction[]
  - `autoApprovalDays` integer
  - `contractId` string
  - `createAt` string, date-time
  - `creditExpireAt` string, date-time
  - `customerId` integer, required
  - `displayName` string
  - `earnRuleId` integer
  - `earnRuleName` string
  - `id` integer
  - `imported` boolean
  - `note` string
  - `orderFinancialStatus` string
  - `orderFulfillmentStatus` string
  - `orderId` integer
  - `orderLineItemId` integer
  - `orderName` string
  - `pointType` 'DEBIT' | 'CREDIT', required
  - `points` number, double, required
  - `reason` string
  - `redeemRuleName` string
  - `redeemRuleRuleId` integer
  - `reviewReference` string
  - `rewardType` 'STORE_CREDIT' | 'DISCOUNT_CODE' | 'POINTS'
  - `shop` string
  - `spentAmount` number, double
  - `status` 'APPROVED' | 'PENDING' | 'REJECTED'
  - `transactionRule` 'ADJUSTMENT' | 'EARN_RULE' | 'REDEEM_RULE' | 'REFERRAL' | 'REDEEM_REVERSAL'

## Other responses

- `401`: Customer not authenticated

## Changes

- **2026-11-02** `f9124ac8febf`: 4 breaking, 24 warning
  - the response's body type changed from `object` to `array` for status `200`
  - removed the required property `customerId` from the response with the `200` status
  - removed the required property `pointType` from the response with the `200` status
  - removed the required property `points` from the response with the `200` status
  - …24 more
- **2026-09-17** `2cf359b1fda3`: 1 warning
  - added the new `REDEEM_REVERSAL` enum value to the `transactionRule` response property for the response status `200`
- **2026-09-08** `791603d96a6f`: 1 info
  - added the optional property `creditExpireAt` to the response with the `200` status

[Operation history](https://skmtc.dev/appstle/apis/storefront-apis/changes/loyalty/cp/api/transaction-by-shop/get.md)

---

[API](https://skmtc.dev/appstle/apis/storefront-apis.md) - [All operations](https://skmtc.dev/appstle/apis/storefront-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/appstle/apis/storefront-apis/revisions/9f59d178ff71?raw)