API Overview

Loyalty.lt provides REST APIs for different integration scenarios. Every endpoint is locale-prefixed — https://api.loyalty.lt/{locale}/... with {locale} being lt or en. Browse the full, testable reference in the API Reference section of the sidebar.

Available APIs

Shop API

Enables e-commerce platforms and POS systems to integrate with the Loyalty.lt loyalty system.

• Loyalty cards — look up cards, check balances, get card info
• Transactions — create purchases, award points, view history
• QR authentication — QR Login and QR Card Scan for POS
• Offers & coupons — retrieve promotions, verify and redeem coupons
• Games — stamp cards and other loyalty games
• XML import — bulk import offers from XML feeds

SMS API

Send SMS messages programmatically with delivery tracking and webhook notifications.

• Send SMS — single or scheduled messages
• Delivery tracking — status via webhooks
• Marketing consent — GDPR-compliant consent management

Partner API

Manage partner accounts, their customers and transactions, and partner-owned games.

Response format

All APIs share one JSON envelope.

Success

{
  "success": true,
  "code": 200,
  "message": "Operation completed successfully",
  "data": { }
}

Error

{
  "success": false,
  "code": 1004,
  "message": "API key and secret are required.",
  "request_id": "abc-123-def"
}

code is a numeric application code. Validation failures (HTTP 422) add an errors object keyed by field. See Error Handling.

HTTP status codes

Need help?