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

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

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 [email protected].

Need Help?