1. Points
Rewrd API
  • Customers
    • Create a Customer
      POST
    • List Customers
      GET
    • Get a Customer
      GET
    • Restrict a Customer
      PATCH
    • Unrestrict a Customer
      PATCH
  • Merchant
    • Get Merchant Configuration
      GET
    • Update Merchant Configuration
      PATCH
    • List Earning Rules
      GET
    • Get Earning Rule Details
      GET
    • List Merchant IPs
      GET
    • Add Merchant IP
      POST
    • Update Merchant IP
      PATCH
    • Delete Merchant IP
      DELETE
    • Get Merchant Analytics
      GET
  • Points
    • Process a Unified Points Transaction
      POST
    • Get Customer Transaction History
      GET
  1. Points

Get Customer Transaction History

Development Server
https://rewrd-api-staging.fly.dev/v1
Development Server
https://rewrd-api-staging.fly.dev/v1
GET
/points/customers/{uid}/transactions
Retrieves a paginated list of all point transactions (credits and redemptions) for a specific customer.
Transactions are sorted by date with the most recent first. Use this endpoint to display a customer's points activity history.
Understanding the response fields:
ledger_type tells you the direction of the transaction:
credit — Points were added to the customer's balance
debit — Points were deducted from the customer's balance
transaction_type tells you how the points were earned or spent:
Transaction TypeMeaning
member_points_adjustment_creditPoints were directly credited (manual adjustment)
member_purchase_order_earned_fixedPoints earned via a fixed earning rule (e.g. "earn 50 points per purchase")
member_purchase_order_earned_percentagePoints earned via a percentage earning rule (e.g. "earn 10% of order value as points")
member_purchase_order_redeemedPoints were redeemed (spent) toward a purchase
balance_before and balance_after show the customer's points balance before and after the transaction, so you can verify the math.

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Path Params

Query Params

Responses

🟢200OK
application/json
Transaction history retrieved successfully.
Body

🟠401Unauthorized
🟠404Record Not Found
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://rewrd-api-staging.fly.dev/v1/points/customers/26833813/transactions?page=1&limit=20' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Example 1
{
    "status": true,
    "message": "Transactions retrieved successfully",
    "data": [
        {
            "id": 1284,
            "customer_uid": "26833813",
            "points": 50,
            "title": "Points Credit",
            "narration": "Credited 50 points for purchase #12345",
            "transaction_type": "member_points_adjustment_credit",
            "ledger_type": "credit",
            "status": "successful",
            "reference_id": "credit_a1b2c3d4-e5f6-7890",
            "balance_before": 1500,
            "balance_after": 1550,
            "created_at": "2026-02-20T14:30:00.000Z"
        }
    ],
    "pagination": {
        "page": 1,
        "limit": 50,
        "total": 150,
        "total_pages": 3
    }
}
Modified at 2026-04-07 21:05:20
Previous
Process a Unified Points Transaction
Built with