GET
/
{locale}
/
shop
/
points
/
card
/
{card_id}
/
balance
curl -X GET "https://staging-api.loyalty.lt/en/shop/points/card/123/balance" \
  -H "Authorization: Bearer your_jwt_token" \
  -H "Content-Type: application/json"

{
  "success": true,
  "message": "Balance retrieved successfully",
  "data": {
    "card": {
      "id": 123,
      "card_number": "LC****4567",
      "status": "active",
      "shop": {
        "id": 45,
        "name": "Coffee Paradise"
      }
    },
    "balance": {
      "current_points": 1250,
      "pending_points": 50,
      "lifetime_earned": 5670,
      "lifetime_redeemed": 4420,
      "expires_soon": 100,
      "next_expiry_date": "2024-02-15T23:59:59Z"
    },
    "tier": {
      "current_tier": "Gold",
      "tier_level": 3,
      "progress_percentage": 75,
      "points_to_next_tier": 250,
      "next_tier": "Platinum",
      "tier_benefits": [
        {
          "benefit_type": "points_multiplier",
          "value": 1.5,
          "description": "50% bonus points on all purchases"
        },
        {
          "benefit_type": "discount",
          "value": 10,
          "description": "10% discount on special items"
        }
      ]
    },
    "statistics": {
      "transactions_count": 87,
      "avg_monthly_activity": 245.5,
      "last_activity": "2024-01-15T14:30:00Z",
      "member_since": "2023-06-01T10:00:00Z"
    }
  }
}

​
Get Points Balance

Retrieve the current points balance, tier status, and related information for a specific loyalty card. This endpoint provides real-time balance data including tier progress and available benefits.
Balance information is updated in real-time and includes pending transactions that may affect the final balance.

​
Path Parameters

​
locale
string
required
Language code for localized content (e.g., “en”, “lt”)
​
card_id
integer
required
Unique identifier of the loyalty card to check balance for

​
Response

​
success
boolean
Indicates if the request was successful
​
message
string
Human-readable message about the operation
​
data
object
curl -X GET "https://staging-api.loyalty.lt/en/shop/points/card/123/balance" \
  -H "Authorization: Bearer your_jwt_token" \
  -H "Content-Type: application/json"

{
  "success": true,
  "message": "Balance retrieved successfully",
  "data": {
    "card": {
      "id": 123,
      "card_number": "LC****4567",
      "status": "active",
      "shop": {
        "id": 45,
        "name": "Coffee Paradise"
      }
    },
    "balance": {
      "current_points": 1250,
      "pending_points": 50,
      "lifetime_earned": 5670,
      "lifetime_redeemed": 4420,
      "expires_soon": 100,
      "next_expiry_date": "2024-02-15T23:59:59Z"
    },
    "tier": {
      "current_tier": "Gold",
      "tier_level": 3,
      "progress_percentage": 75,
      "points_to_next_tier": 250,
      "next_tier": "Platinum",
      "tier_benefits": [
        {
          "benefit_type": "points_multiplier",
          "value": 1.5,
          "description": "50% bonus points on all purchases"
        },
        {
          "benefit_type": "discount",
          "value": 10,
          "description": "10% discount on special items"
        }
      ]
    },
    "statistics": {
      "transactions_count": 87,
      "avg_monthly_activity": 245.5,
      "last_activity": "2024-01-15T14:30:00Z",
      "member_since": "2023-06-01T10:00:00Z"
    }
  }
}

​
Tier System Overview

The loyalty program uses a 4-tier system with increasing benefits:
Requirements: 0-499 points lifetime earnedBenefits:
  • Standard point earning rate (1x)
  • Basic customer support
  • Monthly newsletter
Next Tier: 500 points needed for Silver

​
Balance Management

Point Expiration: Points typically expire 12 months after earning. The expires_soon field shows points expiring within 30 days, allowing users to plan redemptions accordingly.

​
Balance Calculation Priority

  1. Current Points: Immediately available for redemption
  2. Pending Points: From recent transactions (processing)
  3. Expiring Points: Highlighted for user attention

​
Real-time Updates

Balance information reflects:
  • ✅ Completed point awards and redemptions
  • ⏳ Pending transactions (shown separately)
  • 📅 Upcoming expirations
  • 📊 Tier progress calculations

Award Points

Add points to increase balance

Redeem Points

Use points to decrease balance

Transaction History

View detailed transaction history

Loyalty Cards

Manage user’s loyalty cards