Skip to main content
GET
/
{locale}
/
shop
/
coupons
/
card
curl -X GET "https://staging-api.loyalty.lt/en/shop/coupons/card?shop_id=1&card_id=456" \
  -H "X-API-Key: your_api_key" \
  -H "X-API-Secret: your_api_secret"

{
  "success": true,
  "message": "Customer coupons retrieved successfully",
  "data": {
    "coupons": [
      {
        "id": 123,
        "code": "K1234567890",
        "status": "active",
        "expiry_time": "2025-01-31T23:59:59Z",
        "offer": {
          "id": 456,
          "title": "Free Coffee",
          "description": "Choose your free coffee",
          "reward_details": "Free medium coffee",
          "original_price": 3.50
        },
        "user": {
          "id": 100,
          "name": "Jonas Jonaitis",
          "email": "[email protected]"
        },
        "is_pending": false,
        "products": [
          {
            "id": 1,
            "name": "Americano",
            "description": "Classic black coffee",
            "image_url": "https://example.com/americano.jpg"
          },
          {
            "id": 2,
            "name": "Latte",
            "description": "Espresso with steamed milk",
            "image_url": "https://example.com/latte.jpg"
          }
        ],
        "categories": [],
        "requires_product_selection": true
      }
    ],
    "total_count": 1
  }
}

​
Get Card Coupons

Get all active coupons for a specific loyalty card or user. This endpoint is optimized for POS systems to quickly display available coupons during checkout.
This endpoint uses Partner API authentication (X-API-Key and X-API-Secret headers).

​
Query Parameters

​
shop_id
integer
required
The shop ID to filter valid coupons
​
card_id
integer
Loyalty card ID (use either card_id or user_id)
​
user_id
integer
User ID (alternative to card_id)

​
Response

​
success
boolean
Indicates successful retrieval
​
data
object
curl -X GET "https://staging-api.loyalty.lt/en/shop/coupons/card?shop_id=1&card_id=456" \
  -H "X-API-Key: your_api_key" \
  -H "X-API-Secret: your_api_secret"

{
  "success": true,
  "message": "Customer coupons retrieved successfully",
  "data": {
    "coupons": [
      {
        "id": 123,
        "code": "K1234567890",
        "status": "active",
        "expiry_time": "2025-01-31T23:59:59Z",
        "offer": {
          "id": 456,
          "title": "Free Coffee",
          "description": "Choose your free coffee",
          "reward_details": "Free medium coffee",
          "original_price": 3.50
        },
        "user": {
          "id": 100,
          "name": "Jonas Jonaitis",
          "email": "[email protected]"
        },
        "is_pending": false,
        "products": [
          {
            "id": 1,
            "name": "Americano",
            "description": "Classic black coffee",
            "image_url": "https://example.com/americano.jpg"
          },
          {
            "id": 2,
            "name": "Latte",
            "description": "Espresso with steamed milk",
            "image_url": "https://example.com/latte.jpg"
          }
        ],
        "categories": [],
        "requires_product_selection": true
      }
    ],
    "total_count": 1
  }
}

Get Coupon Products

Get available products for a coupon

Redeem Coupon

Redeem the selected coupon