Skip to main content

Get User Points Details API

Overview​

Retrieve the detailed history of user reward points transactions, including points earned, transaction details, and timestamps.

API Details​

Endpoint​

GET https://api.gafapay.com:8443/gafapay/v3/reward_promotion/user_points_detail

Headers​

authorization: Token eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJmYjhmMDkyMTBlMGY0NmI3YjQyNjJkNzdmNWI2YzI3MyIsInJvbGVzIjpbIlJPTEVfQ1VTVE9NRVIiXSwiZXhwIjoxNzU3NzY5NDU0fQ.QMvK_JLnYBE6XYaFdyg16aVupTONBO7eMGDmzAGVhVg
companyid: 59388167894b4d10a04fe5da3b8a2104
requestid: b35d332f-131e-44c1-892f-8322e022da74

Query Parameters​

Required Parameters​

  • user_id (string, required): Unique identifier of the user

    • Format: UUID string
    • Example: "fb8f09210e0f46b7b4262d77f5b6c273"

  • currency_id (string, required): Unique identifier of the currency

    • Format: UUID string
    • Example: "1f1519903ed240578f071aa45cb479f2"

Optional Parameters​

  • skip (integer, optional): Number of records to skip for pagination

    • Default: 0
    • Example: 0, 10, 20

  • limit (integer, optional): Maximum number of records to return

    • Default: 10
    • Example: 10, 25, 50

  • sorting (string, optional): Sorting criteria for the results

Response​

{
    "success": 1,
    "error": [],
    "data": {
        "user_points_details": [
            {
                "id": "31e26a05dbcf45c1ab17f5571dd85068",
                "user_id": "fb8f09210e0f46b7b4262d77f5b6c273",
                "points": 20.0,
                "transaction_id": "b33acc20613a4a38bf7ed57023cf1ff9",
                "reward_program_id": "deda8348c95b4be9bcbb3b2d15520949",
                "referral_program_id": null,
                "description": "Reward For transferring Rohit to 06 September 2025",
                "currency_id": "1f1519903ed240578f071aa45cb479f2",
                "created_date": 1757164688
            },
            {
                "id": "a1e037ed9de24432b38efdd538009d33",
                "user_id": "fb8f09210e0f46b7b4262d77f5b6c273",
                "points": 20.0,
                "transaction_id": "6989731b033149b8b268bfb0fc9c39b9",
                "reward_program_id": "deda8348c95b4be9bcbb3b2d15520949",
                "referral_program_id": null,
                "description": "Reward For transferring Mouhamad to 06 September 2025",
                "currency_id": "1f1519903ed240578f071aa45cb479f2",
                "created_date": 1757131124
            }
        ]
    }
}

Response Fields​

  • success (integer): Response status indicator
    • 1 = Success
    • 0 = Failure
  • error (array): Array of error messages (empty on success)
  • data (object): Response data object
    • user_points_details (array): Array of user points transaction details
      • id (string): Unique identifier for the points detail record
      • user_id (string): User's unique identifier
      • points (number): Points earned in this transaction
      • transaction_id (string): Associated transaction identifier
      • reward_program_id (string): Reward program that generated the points
      • referral_program_id (string|null): Referral program ID if applicable
      • description (string): Human-readable description of the points transaction
      • currency_id (string): Currency identifier for the points
      • created_date (integer): Unix timestamp when the points were created

Example Usage​

curl --location 'https://api.gafapay.com:8443/gafapay/v3/reward_promotion/user_points_detail?skip=0&limit=10&user_id=fb8f09210e0f46b7b4262d77f5b6c273&currency_id=1f1519903ed240578f071aa45cb479f2' \
--header 'authorization: Token eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJmYjhmMDkyMTBlMGY0NmI3YjQyNjJkNzdmNWI2YzI3MyIsInJvbGVzIjpbIlJPTEVfQ1VTVE9NRVIiXSwiZXhwIjoxNzU3NzY5NDU0fQ.QMvK_JLnYBE6XYaFdyg16aVupTONBO7eMGDmzAGVhVg' \
--header 'companyid: 59388167894b4d10a04fe5da3b8a2104' \
--header 'requestid: b35d332f-131e-44c1-892f-8322e022da74'

Notes​

  • This API retrieves the detailed history of user reward points transactions
  • Both user_id and currency_id are required parameters
  • Use skip and limit parameters for pagination
  • The response includes transaction details, descriptions, and timestamps