Limits

To assure good performance for every project, the API imposes limits on certain parameters and objects.

This article outlines the technical and business limits of the Open Loyalty system. Understanding these limits will help you optimize your use of the platform and ensure smooth operation within the specified constraints.

Technical Limits

API Timeout

  • Timeout Duration: The API will timeout after 30 seconds.

Imports / Exports

  • Maximum Concurrent Requests: You can import or export up to 5 files simultaneously.

  • Maximum File Size: The maximum file size for importing XML or CSV files is 10239kB.

Forms

Number Field Type

  • Minimum Value: -2,147,483,648

  • Maximum Value: 2,147,483,647

String Field Type

  • Maximum Length: 255 characters

Expressions

  • Maximum Length: 500 characters

loyaltyCardNumber Field

  • Uniqueness: The loyalty card number must be unique per tenant.

  • Case Sensitivity: The field is case-sensitive (e.g., XYZ is not equal to xyz).

Email and Phone Matching

  • Case Insensitivity: The system does not consider case when matching email and phone fields during member matching with transactions or custom events.


Business Limits

If you believe your loyalty program requires adjustments beyond these limits, please contact Open Loyalty to discuss potential increases.

Loyalty Modules

The limitations for Loyalty Modules are set across the entire instance, so they apply to all tenants.

  • Campaigns: A maximum of 100 active campaigns.

    • QR Codes: A maximum of 2 million across all campaigns.

  • Achievements: A maximum of 50 active achievements.

  • Rewards: A maximum of 100 rewards can be created.

    • Issued Rewards: A maximum of 100 million issued rewards.

    • Coupons: A maximum of 1 million across all rewards.

  • Segments: A maximum of 100 active segments.

  • Wallets: A maximum of 50 wallet types.

Tiers

The Tier limitations are set per tenant.

  • Tier Sets: A maximum of 3 tier sets.

  • Tiers: A maximum of 20 tiers per set.

Transaction

  • Maximum Number of Items in a Transaction: 100

Custom Event

  • Maximum Number of Fields in a Custom Event Schema: 50

Administration

The limitations for Administration components are set across the entire instance, so they apply to all tenants.

  • Admins: A maximum of 100 admins.

  • Roles: A maximum of 20 roles.

  • Tenants (Stores): A maximum of 50 tenants.

  • Webhooks Subscription: A maximum of 30 webhooks subscription.

Custom Attributes

Max no of custom attributesMax Key LengthMax Value Length

Member

25

255

255

Transaction

25

255

255

Transaction Item

10

255

255

Campaign Simulation

25

255

255


These limits are designed to ensure optimal performance and reliability of the Open Loyalty platform. Adhering to these constraints will help maintain system stability and efficiency. If you have any questions or need further clarification, please refer to the OpenLoyalty API Documentation or contact us.

Last updated