Skip to main content
GET
/
{locale}
/
shop
/
loyalty-cards
/
balance
curl -X GET "https://staging-api.loyalty.lt/en/shop/loyalty-cards/balance?card_number=123-456-789" \
  -H "X-API-Key: your_api_key" \
  -H "X-API-Secret: your_api_secret"
{
  "success": true,
  "code": 200,
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "message": "Balance retrieved successfully",
  "data": {
    "card_id": 567,
    "card_number": "123-456-789",
    "points": 1250
  }
}

Get Points Balance

Retrieve a customer’s current points balance. This is a lightweight endpoint that returns only the essential balance information.
This endpoint requires Shop API authentication (X-API-Key and X-API-Secret headers).

Base URL

EnvironmentURL
Staginghttps://staging-api.loyalty.lt/{locale}/shop/loyalty-cards/balance
Productionhttps://api.loyalty.lt/{locale}/shop/loyalty-cards/balance

Query Parameters

The card_number parameter accepts both the card number (e.g., 123-456-789) and the QR code UUID value. This allows you to search by whatever value you have scanned.
card_number
string
Loyalty card number (e.g., 123-456-789) or QR code value (UUID)
card_id
integer
Loyalty card ID
user_id
integer
User ID to find their card
At least one query parameter is required.

Request Example

curl -X GET "https://staging-api.loyalty.lt/en/shop/loyalty-cards/balance?card_number=123-456-789" \
  -H "X-API-Key: your_api_key" \
  -H "X-API-Secret: your_api_secret"

Response

{
  "success": true,
  "code": 200,
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "message": "Balance retrieved successfully",
  "data": {
    "card_id": 567,
    "card_number": "123-456-789",
    "points": 1250
  }
}

Response Fields

card_id
integer
Loyalty card ID
card_number
string
Loyalty card number in format XXX-XXX-XXX
points
integer
Current points balance (non-expired points only)

Error Codes

CodeStatusDescription
1100422Validation error - at least one query parameter required
1200404Loyalty card not found
1004401Partner not authenticated