Get Customer Transaction History

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.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Query Params

Responses

🟢200OK

application/json

Transaction history retrieved successfully.

Body

🟠401Unauthorized

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/points/customers/cust_abc123def456/transactions?page=1&limit=20' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "status": true,
    "message": "Transactions retrieved successfully",
    "data": [
        {
            "id": 1284,
            "merchant_id": "merch_xyz789",
            "customer_uid": "cust_abc123def456",
            "amount": 50,
            "transaction_type": "member_points_adjustment_credit",
            "reference_id": "credit_a1b2c3d4-e5f6-7890",
            "title": "Points Credit",
            "narration": "Credited 50 points for purchase #12345",
            "balance_after": 1550,
            "created_at": "2026-02-20T14:30:00.000Z"
        }
    ],
    "pagination": {
        "page": 1,
        "limit": 50,
        "total": 150,
        "total_pages": 3
    }
}

Modified at 2026-02-25 12:17:15

Redeem Points