Skip to main content

API Overview

Loyalty.lt provides multiple REST APIs for different integration scenarios. Choose the API that fits your use case.

Available APIs

Shop API

For e-commerce platforms and POS systems. Award points, manage loyalty cards, process transactions.

SMS API

Send SMS messages programmatically with delivery tracking and GDPR-compliant consent management.

Partner API

For partner management systems. Manage shops, staff, settings, and analytics. Coming soon

Shop API

The Shop API enables e-commerce platforms and POS systems to integrate with the Loyalty.lt loyalty system.

Key Features

  • Loyalty Cards - Look up cards, check balances, get card info
  • Transactions - Create purchases, award points, view history
  • QR Authentication - QR Login, QR Card Scan for POS
  • Offers - Retrieve promotional offers and discounts
  • XML Import - Bulk import offers from XML feeds

Shop API Documentation

Complete Shop API reference with endpoints, authentication, and examples

SMS API

The SMS API allows partners to send SMS messages programmatically with automatic billing, delivery tracking, and webhook notifications.

Key Features

  • Send SMS - Send single or scheduled messages
  • Delivery Tracking - Real-time status via webhooks
  • Marketing Consent - GDPR-compliant consent management
  • Sender Names - Custom alphatag support

SMS API Documentation

Complete SMS API reference with endpoints, pricing, and webhook examples

Response Format

All Loyalty.lt APIs follow a consistent JSON response structure:

Success Response

{
  "success": true,
  "code": 200,
  "request_id": "abc-123-def",
  "message": "Operation completed successfully",
  "data": { ... }
}

Error Response

{
  "success": false,
  "code": 400,
  "message": "Validation error",
  "errors": {
    "field_name": ["Error message"]
  }
}

HTTP Status Codes

CodeDescription
200Success
201Created
400Bad Request / Validation Error
401Unauthorized - Invalid credentials
403Forbidden - Access denied
404Not Found
422Unprocessable Entity
429Too Many Requests - Rate limited
500Server Error

Rate Limits

All API requests are limited to 60 requests per minute per API key or IP address.
Exceeding rate limits will result in 429 Too Many Requests responses. If you need higher limits, contact developers@loyalty.lt.

Need Help?

Shop API

E-commerce and POS integration

SMS API

Programmatic SMS messaging

SDKs

Official SDK libraries

Partners Portal

Manage your integration